[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
quotes in INSTALL file
From: |
Bruno Haible |
Subject: |
quotes in INSTALL file |
Date: |
Tue, 26 Aug 2008 09:17:30 +0200 |
User-agent: |
KMail/1.5.4 |
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.
- quotes in INSTALL file,
Bruno Haible <=