Re: Updated INSTALL from Autoconf

[Eric Blake]

-----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  <address@hidden>
> 
>       * 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             address@hidden
-----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-----