quotes in INSTALL file

[Bruno Haible]

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  <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.