[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Changes to m4/doc/m4.texinfo,v [branch-1_4]
From: |
Eric Blake |
Subject: |
Changes to m4/doc/m4.texinfo,v [branch-1_4] |
Date: |
Tue, 31 Oct 2006 14:13:43 +0000 |
CVSROOT: /sources/m4
Module name: m4
Branch: branch-1_4
Changes by: Eric Blake <ericb> 06/10/31 14:13:41
Index: doc/m4.texinfo
===================================================================
RCS file: /sources/m4/m4/doc/m4.texinfo,v
retrieving revision 1.1.1.1.2.95
retrieving revision 1.1.1.1.2.96
diff -u -b -r1.1.1.1.2.95 -r1.1.1.1.2.96
--- doc/m4.texinfo 29 Oct 2006 15:22:42 -0000 1.1.1.1.2.95
+++ doc/m4.texinfo 31 Oct 2006 14:13:41 -0000 1.1.1.1.2.96
@@ -4080,9 +4080,14 @@
the same index.
If @var{replacement} is shorter than @var{chars}, the excess characters
-are deleted from the expansion. If @var{replacement} is omitted, all
-characters in @var{string} that are present in @var{chars} are deleted
-from the expansion.
+of @var{chars} are deleted from the expansion; if @var{chars} is
+shorter, the excess characters in @var{replacement} are silently
+ignored. If @var{replacement} is omitted, all characters in
address@hidden that are present in @var{chars} are deleted from the
+expansion. If a character appears more than once in @var{chars}, only
+the first instance is used in making the translation. Only a single
+translation pass is made, even if characters in @var{replacement} also
+appear in @var{chars}.
As a @acronym{GNU} extension, both @var{chars} and @var{replacement} can
contain character-ranges,
@@ -4104,12 +4109,17 @@
@result{}GNUS NOT UNIX
translit(`GNUs not Unix', `A-Z', `z-a')
@result{}tmfs not fnix
+translit(`abcdef', `aabdef', `bcged')
address@hidden
@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.
+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.
Omitting @var{chars} evokes a warning, but still produces output.
- Changes to m4/doc/m4.texinfo,v [branch-1_4], (continued)
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/10/16
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/10/16
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/10/16
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/10/19
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/10/20
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/10/20
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/10/23
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/10/25
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/10/26
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/10/29
- Changes to m4/doc/m4.texinfo,v [branch-1_4],
Eric Blake <=