[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: quotes in INSTALL file
From: |
Eric Blake |
Subject: |
Re: quotes in INSTALL file |
Date: |
Tue, 26 Aug 2008 07:29:12 -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/26/2008 1:17 AM:
> The INSTALL file is supposed to be a plain-text file. Plain-text files are
> nowadays viewed with ISO 8859 or Unicode fonts. As described by Markus Kuhn
> [1],
> quotation with `...' looks ugly in these fonts.
>
> I'm adding rules to generate the INSTALL file with prettier quotes. Projects
> have the choice of picking up either INSTALL, INSTALL.ISO, or INSTALL.UTF-8.
Are you planning on feeding these changes back to autoconf? Also, does
Automake need to be taught to auto-distribute INSTALL.ISO and/or
INSTALL.UTF-8, or is the intent that packages borrowing those files from
gnulib will rename them to INSTALL?
>
> The rules use postprocessing with 'sed'. Pretty hackish, but even with
> "@documentencoding UTF-8", makeinfo did not generate Unicode quotation marks.
>
> Bruno
>
> [1] http://www.cl.cam.ac.uk/~mgk25/ucs/quotes.html
>
>
> 2008-08-26 Bruno Haible <address@hidden>
>
> Generate INSTALL file variants with prettier quotes.
> * doc/Makefile (INSTALL_PRELUDE): New macro.
> (INSTALL): Use it.
> (INSTALL.ISO, INSTALL.UTF-8): New rules.
>
> *** doc/Makefile.orig 2008-08-26 09:11:50.000000000 +0200
> --- doc/Makefile 2008-08-26 09:11:44.000000000 +0200
> ***************
> *** 24,34 ****
> dvi: $(doc).dvi
> pdf: $(doc).pdf
>
> INSTALL: install.texi
> ! { echo '@firstparagraphindent insert'; cat $<; } > tmp.texi
> $(MAKEINFO) --plaintext --no-validate 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)
>
> # Date of last update. Requires GNU date.
> --- 24,50 ----
> dvi: $(doc).dvi
> pdf: $(doc).pdf
>
> + INSTALL_PRELUDE = \
> + echo '@firstparagraphindent insert';
> +
> + # INSTALL file with old ASCII quotation marks (looks ugly on modern
> machines).
> INSTALL: install.texi
> ! { $(INSTALL_PRELUDE) cat $<; } > tmp.texi
> $(MAKEINFO) --plaintext --no-validate tmp.texi > $@
> rm -f tmp.texi
>
> + # INSTALL file with ISO 646 or ISO 8859 quotation marks.
> + INSTALL.ISO: install.texi
> + { $(INSTALL_PRELUDE) cat $<; } > tmpi.texi
> + $(MAKEINFO) --plaintext --no-validate tmpi.texi | sed -e
> "s/\`\([^']*\)'/'\1'/g" > $@
> + rm -f tmpi.texi
> +
> + # INSTALL file wit ISO 10646 (Unicode) quotation marks.
> + INSTALL.UTF-8: install.texi
> + { $(INSTALL_PRELUDE) cat $<; } > tmpu.texi
> + $(MAKEINFO) --plaintext --no-validate tmpu.texi | sed -e
> "s/\`\([^']*\)'/‘\1’/g" > $@
> + rm -f tmpu.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)
>
> # Date of last update. Requires GNU date.
>
>
>
>
- --
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
iEYEARECAAYFAki0BSgACgkQ84KuGfSFAYBIrgCdH0IX2n8L0kvbmem8q+RR24j7
HB4AnRkK0nbo4iXb2sRNhmwNiLrYMZd/
=Pxl/
-----END PGP SIGNATURE-----