[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Updated INSTALL from Autoconf
From: |
Eric Blake |
Subject: |
Re: Updated INSTALL from Autoconf |
Date: |
Mon, 25 Aug 2008 22:13:42 -0600 |
User-agent: |
Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.16) Gecko/20080708 Thunderbird/2.0.0.16 Mnenhy/0.7.5.666 |
-----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-----
- Re: Updated INSTALL from Autoconf,
Eric Blake <=