-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 According to Bruno Haible on 8/25/2008 5:24 PM: > > Yes, thanks. This gives us the freedom to discuss the formatting details > of this file :-) > > Currently, 'makeinfo' produces an INSTALL file which has the first paragraph > in every section unindented and the other paragraphs indented. It just looks > ugly. It may be different for books, where chapters are usually several > pages long and chapter titles really stand out. But in info files or text > files > like this one, where a page typically has only 1 to 4 paragraphs, there are > just too many unindented paragraphs.
Is this the sort of patch better suited to an upstream fix in install.texi in autoconf (ie. fold the @firstparagraphindent into the .texi file, rather than creating a temporary file in the gnulib Makefile rule)? At any rate, it would be nice if Autoconf's INSTALL matches gnulib's formatting. > > 2008-08-25 Bruno Haible <[EMAIL PROTECTED]> > > * doc/Makefile (INSTALL): Generate with @firstparagraphindent set. > > *** doc/Makefile.orig 2008-08-26 01:08:22.000000000 +0200 > --- doc/Makefile 2008-08-26 01:07:48.000000000 +0200 > *************** > *** 24,30 **** > pdf: $(doc).pdf > > INSTALL: install.texi > ! -$(MAKEINFO) --plaintext --no-warn $< >$@ > > GNULIB_TEXI_FILES = $(filter-out maintain.texi make-stds.texi > standards.texi,$(wildcard *.texi)) $(wildcard posix-headers/*.texi) > $(wildcard posix-functions/*.texi) $(wildcard glibc-headers/*.texi) > $(wildcard glibc-functions/*.texi) > > --- 24,32 ---- > pdf: $(doc).pdf > > INSTALL: install.texi > ! { echo '@firstparagraphindent insert'; cat $<; } > tmp.texi > ! -$(MAKEINFO) --plaintext --no-warn tmp.texi > $@ > ! rm -f tmp.texi > > GNULIB_TEXI_FILES = $(filter-out maintain.texi make-stds.texi > standards.texi,$(wildcard *.texi)) $(wildcard posix-headers/*.texi) > $(wildcard posix-functions/*.texi) $(wildcard glibc-headers/*.texi) > $(wildcard glibc-functions/*.texi) > > > FWIW, here's autoconf's current rule: AM_MAKEINFOFLAGS = --no-headers --no-validate --no-split $(abs_srcdir)/INSTALL: $(top_srcdir)/doc/install.texi $(MAKEINFO) $(AM_MAKEINFOFLAGS) $(MAKEINFOFLAGS) -o $@ \ $(top_srcdir)/doc/install.texi where MAKEINFOFLAGS is blank by default. - -- Don't work too hard, make some time for fun as well! Eric Blake [EMAIL PROTECTED] -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (Cygwin) Comment: Public key at home.comcast.net/~ericblake/eblake.gpg Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org iEYEARECAAYFAkizgvYACgkQ84KuGfSFAYCe2QCg0cQhFRbTOzYyACWWwmABS7qG rbgAmwanuv0aRhja6QS+cuJGW4o9XVLy =Kjro -----END PGP SIGNATURE-----