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. 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 <[EMAIL PROTECTED]> 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.
