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/07/30 21:46:10

Index: doc/m4.texinfo
===================================================================
RCS file: /sources/m4/m4/doc/m4.texinfo,v
retrieving revision 1.1.1.1.2.55
retrieving revision 1.1.1.1.2.56
diff -u -b -r1.1.1.1.2.55 -r1.1.1.1.2.56
--- doc/m4.texinfo      28 Jul 2006 01:45:04 -0000      1.1.1.1.2.55
+++ doc/m4.texinfo      30 Jul 2006 21:46:10 -0000      1.1.1.1.2.56
@@ -3995,6 +3995,26 @@
 @result{}
 @end example
 
+Line numbers start at 1 for each file.  If the file was found due to the
+@option{-I} option or @env{M4PATH} environment variable, that is
+reflected in the file name.  The syncline option (@option{-s}) uses the
+same notion of current file and line.  Assume this example is run in the
+@file{checks} directory of the @acronym{GNU} M4 package, using
+@samp{--include=../examples} in the command line to find the file
+@file{incl.m4} mentioned earlier:
+
+@example
+define(`foo', ``$0' called at __file__:__line__')
+@result{}
+foo
+@result{}foo called at stdin:2
+include(`incl.m4')
+@result{}Include file start
+@result{}foo called at ../examples/incl.m4:2
+@result{}Include file end
+@result{}
+@end example
+
 @node M4exit
 @section Exiting from @code{m4}