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/08/22 19:56:09

Index: doc/m4.texinfo
===================================================================
RCS file: /sources/m4/m4/doc/m4.texinfo,v
retrieving revision 1.1.1.1.2.68
retrieving revision 1.1.1.1.2.69
diff -u -b -r1.1.1.1.2.68 -r1.1.1.1.2.69
--- doc/m4.texinfo      18 Aug 2006 03:39:11 -0000      1.1.1.1.2.68
+++ doc/m4.texinfo      22 Aug 2006 19:56:09 -0000      1.1.1.1.2.69
@@ -706,9 +706,9 @@
 contain comments.  @acronym{GNU} @code{m4} does not yet understand
 locales; all operations are byte-oriented rather than
 character-oriented.  However, @code{m4} is eight-bit clean, so you can
-use non-ASCII characters in quoted strings (@pxref{Changequote}),
+use address@hidden characters in quoted strings (@pxref{Changequote}),
 comments (@pxref{Changecom}), and macro names (@pxref{Indir}), with the
-exception of the NUL character (the zero byte).
+exception of the @sc{nul} character (the zero byte @samp{'\0'}).
 
 @menu
 * Names::                       Macro names
@@ -723,9 +723,10 @@
 
 @cindex names
 A name is any sequence of letters, digits, and the character @kbd{_}
-(underscore), where the first character is not a digit.  If a
-name has a macro definition, it will be subject to macro expansion
-(@pxref{Macros}).
+(underscore), where the first character is not a digit.  @code{m4} will
+use the longest such sequence found in the input.  If a name has a
+macro definition, it will be subject to macro expansion
+(@pxref{Macros}).  Names are case-sensitive.
 
 Examples of legal names are: @samp{foo}, @samp{_tmp}, and @samp{name01}.
 
@@ -2670,8 +2671,8 @@
 you wanted to apply translations to a file of numbers:
 
 @example
-ifdef(`changeword', `', `m4exit(`77')')
address@hidden
+ifdef(`changeword', `', `errprint(` skipping: no changeword support
+')m4exit(`77')')dnl
 changeword(`[_a-zA-Z0-9]+')
 @result{}
 define(`1', `0')1
@@ -2683,8 +2684,8 @@
 accidental call of builtins, for example:
 
 @example
-ifdef(`changeword', `', `m4exit(`77')')
address@hidden
+ifdef(`changeword', `', `errprint(` skipping: no changeword support
+')m4exit(`77')')dnl
 define(`_indir', defn(`indir'))
 @result{}
 changeword(`_[_a-zA-Z0-9]*')
@@ -2706,8 +2707,8 @@
 the first of these is discarded before symbol lookup.  So:
 
 @example
-ifdef(`changeword', `', `m4exit(`77')')
address@hidden
+ifdef(`changeword', `', `errprint(` skipping: no changeword support
+')m4exit(`77')')dnl
 changecom(`/*', `*/')dnl
 define(`foo', `bar')dnl
 changeword(`#\([_a-zA-Z0-9]*\)')
@@ -2740,8 +2741,8 @@
 Then, the @code{m4} version:
 
 @example
-ifdef(`changeword', `', `m4exit(`77')')
address@hidden
+ifdef(`changeword', `', `errprint(` skipping: no changeword support
+')m4exit(`77')')dnl
 define(`a', `errprint(`Hello')')dnl
 changeword(`@@\([_a-zA-Z0-9]*\)')
 @result{}
@@ -4019,7 +4020,8 @@
 @example
 dnl This test assumes kill is a shell builtin, and that signals are
 dnl recognizable.
-ifdef(`__unix__', , `m4exit(`77')')dnl
+ifdef(`__unix__', , `errprint(` skipping: syscmd does not have unix semantics
+')m4exit(`77')')dnl
 syscmd(`kill -13 $$')
 @result{}
 sysval
@@ -4066,7 +4068,8 @@
 @example
 dnl This test assumes /tmp is a valid directory name, which is not true
 dnl for native Windows.
-ifdef(`__unix__', , `m4exit(`77')')dnl
+ifdef(`__unix__', , `errprint(` skipping: not sure /tmp exists
+')m4exit(`77')')dnl
 define(`file1', maketemp(`/tmp/fooXXXXXX'))dnl
 define(`file2', maketemp(`/tmp/fooXXXXXX'))dnl
 ifelse(file1, file2, `same', `different')