view doc/ja/Makefile @ 9051:f8e25885d975

commands: wrapped docstrings at 78 characters

We have always had a left margin of 4 characters -- probably just
because that's how docstrings for top-level functions turn out by
default, but it also looks nice in the built-in help.

The docstrings were wrapped at 70 characters, which is the default for
Emacs. However, this gives a right margin of 10 characters in a
standard 80 character terminal.

I've now wrapped the relevant docstrings at 78 characters, effectively
killing the right margin. The asymmetric margins looked a bit odd and
some of the text looked cramped with a right margin, so Dirkjan and I
felt that it was best to remove it entirely. The two character gap was
kept to have some space between the border of the terminal -- it will
also make diffs involving the docstrings fit in a 80 character line.

SOURCES=$(wildcard *.[0-9].ja.txt)
MAN=$(SOURCES:%.txt=%)
HTML=$(SOURCES:%.txt=%.html)

all: man html

man: $(MAN)

html: $(HTML)

%: %.xml
	xmlto -x docbook.ja.xsl man $*.xml

%.xml: %.txt
	-asciidoc -d manpage -b docbook -f docbook.ja.conf $*.txt

%.html: %.txt
	asciidoc -b html4 $*.txt

clean:
	$(RM) $(MAN:%.ja=%) $(MAN:%=%.xml) $(MAN:%=%.html)