Changes to m4/doc/m4.texinfo,v [branch-1_4]

[Eric Blake]

CVSROOT:        /sources/m4
Module name:    m4
Branch:         branch-1_4
Changes by:     Eric Blake <ericb>      06/11/11 12:54:47

Index: doc/m4.texinfo
===================================================================
RCS file: /sources/m4/m4/doc/m4.texinfo,v
retrieving revision 1.1.1.1.2.99
retrieving revision 1.1.1.1.2.100
diff -u -b -r1.1.1.1.2.99 -r1.1.1.1.2.100
--- doc/m4.texinfo      8 Nov 2006 05:08:26 -0000       1.1.1.1.2.99
+++ doc/m4.texinfo      11 Nov 2006 12:54:46 -0000      1.1.1.1.2.100
@@ -2828,9 +2828,9 @@
 
 The quotation strings can safely contain eight-bit characters.
 @ignore
-Yuck.  I know of no clean way to render an 8-bit character in both info
-and dvi.  This example uses the `open-guillemot' and `close-guillemot'
-characters of the Latin-1 character set.
address@hidden Yuck.  I know of no clean way to render an 8-bit character in
address@hidden both info and dvi.  This example uses the `open-guillemot' and
address@hidden `close-guillemot' characters of the Latin-1 character set.
 
 @example
 define(`a', `b')
@@ -3058,9 +3058,9 @@
 
 The comment strings can safely contain eight-bit characters.
 @ignore
-Yuck.  I know of no clean way to render an 8-bit character in both info
-and dvi.  This example uses the `open-guillemot' and `close-guillemot'
-characters of the Latin-1 character set.
address@hidden Yuck.  I know of no clean way to render an 8-bit character in
address@hidden both info and dvi.  This example uses the `open-guillemot' and
address@hidden `close-guillemot' characters of the Latin-1 character set.
 
 @example
 define(`a', `b')
@@ -4134,14 +4134,15 @@
 appear in @var{chars}.
 
 As a @acronym{GNU} extension, both @var{chars} and @var{replacement} can
-contain character-ranges,
-e.g., @samp{a-z} (meaning all lowercase letters) or @samp{0-9} (meaning
-all digits).  To include a dash @samp{-} in @var{chars} or
address@hidden, place it first or last.
-
-It is not an error for the last character in the range to be `larger'
-than the first.  In that case, the range runs backwards, i.e.,
address@hidden means the string @samp{9876543210}.
+contain character-ranges, e.g., @samp{a-z} (meaning all lowercase
+letters) or @samp{0-9} (meaning all digits).  To include a dash @samp{-}
+in @var{chars} or @var{replacement}, place it first or last in the
+entire string, or as the last character of a range.  Back-to-back ranges
+can share a common endpoint.  It is not an error for the last character
+in the range to be `larger' than the first.  In that case, the range
+runs backwards, i.e., @samp{9-0} means the string @samp{9876543210}.
+The expansion of a range is dependent on the underlying encoding of
+characters, so using ranges is not always portable between machines.
 
 The macro @code{translit} is recognized only with parameters.
 @end deffn
@@ -4153,17 +4154,31 @@
 @result{}GNUS NOT UNIX
 translit(`GNUs not Unix', `A-Z', `z-a')
 @result{}tmfs not fnix
+translit(`+,-12345', `+--1-5', `<;>a-c-a')
address@hidden<;>abcba
 translit(`abcdef', `aabdef', `bcged')
 @result{}bgced
 @end example
 
-The first example deletes all uppercase letters, the second converts
-lowercase to uppercase, and the third `mirrors' all uppercase letters,
-while converting them to lowercase.  The two first cases are by far the
-most common.  The final example shows that @samp{a} is mapped to
address@hidden, not @samp{c}; the resulting @samp{b} is not further remapped
-to @samp{g}; the @samp{d} and @samp{e} are swapped, and the @samp{f} is
-discarded.
+In the @sc{ascii} encoding, the first example deletes all uppercase
+letters, the second converts lowercase to uppercase, and the third
+`mirrors' all uppercase letters, while converting them to lowercase.
+The two first cases are by far the most common, even though they are not
+portable to @sc{ebcdic} or other encodings.  The fourth example shows a
+range ending in @samp{-}, as well as back-to-back ranges.  The final
+example shows that @samp{a} is mapped to @samp{b}, not @samp{c}; the
+resulting @samp{b} is not further remapped to @samp{g}; the @samp{d} and
address@hidden are swapped, and the @samp{f} is discarded.
+
address@hidden
address@hidden No need to fight 8-bit characters, as it is difficult to get
address@hidden rendering right in both info and dvi.
+
address@hidden
+translit(`«abc~', `~-»')
address@hidden
address@hidden example
address@hidden ignore
 
 Omitting @var{chars} evokes a warning, but still produces output.