[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: branch-1_4 doc improvements
|
From: |
Eric Blake |
|
Subject: |
Re: branch-1_4 doc improvements |
|
Date: |
Tue, 11 Jul 2006 14:16:50 +0000 (UTC) |
|
User-agent: |
Loom/3.14 (http://gmane.org/) |
Eric Blake writes:
>
> Here's another round of doc improvements. It adds several
> test cases (some from CVS head, as well as some to expose
> our bugs in handling the empty string as a file name). It also
> changes the license to be the looser GNU FDL 1.2 or later,
> rather than the previous verbatim only.
> address@hidden
> +Permission is granted to copy, distribute and/or modify this document
> +under the terms of the @acronym{GNU} Free Documentation License,
> +Version 1.2 or any later version published by the Free Software
> +Foundation; with no Invariant Sections, with the Front-Cover texts
> +being ``A @acronym{GNU} Manual,'' and with the Back-Cover Texts as in
> +(a) below. A copy of the license is included in the section entitled
> address@hidden Free Documentation License.''
If I'm going to distribute this doc under FDL, I'd better include the FDL :)
2006-07-11 Eric Blake <address@hidden>
* Makefile.am (DISTCHECK_CONFIGURE_FLAGS): New macro, to
stress-test changeword before a release.
* doc/m4.texinfo: More doc cleanups.
(Copying This Manual): New node; actually include the FDL in the
documentation.
* doc/Makefile.am (m4_TEXINFOS): Mention dependence on fdl.texi.
* m4/gnulib-cache.m4: Augment with gnulib-tool --import fdl.
* NEWS: Mention documentation improvements.
Index: NEWS
===================================================================
RCS file: /sources/m4/m4/NEWS,v
retrieving revision 1.1.1.1.2.32
diff -u -r1.1.1.1.2.32 NEWS
--- NEWS 11 Jul 2006 12:17:11 -0000 1.1.1.1.2.32
+++ NEWS 11 Jul 2006 14:12:10 -0000
@@ -32,6 +32,8 @@
* When given the empty string or 0, undivert is now documented as a no-op
rather than closing stdout, warning about a non-existent file, or trying
to read a directory as a file.
+* Many documentation improvements. Also, the manual is now distributed
+ under FDL 1.2, rather than a stricter verbatim-only license.
Version 1.4.4b - 17 June 2006, by Eric Blake (CVS version 1.4.4a)
Index: Makefile.am
===================================================================
RCS file: /sources/m4/m4/Makefile.am,v
retrieving revision 1.25.2.7
diff -u -r1.25.2.7 Makefile.am
--- Makefile.am 6 Jul 2006 18:10:38 -0000 1.25.2.7
+++ Makefile.am 11 Jul 2006 14:12:10 -0000
@@ -27,8 +27,9 @@
## maintainer-clean should remove as much as possible that ./bootstrap can
## recreate. In the m4 directory, keep only gnulib-cache.m4.
MAINTAINERCLEANFILES = COPYING INSTALL Makefile.in aclocal.m4 \
- config-h.in configure depcomp install-sh lib/* \
+ config-h.in configure depcomp doc/fdl.texi install-sh lib/* \
m4/[a-fh-z]* m4/g[a-mo-z]* m4/gnulib-comp.m4 m4/gnulib-tool.m4 \
missing stamp-h.in
ACLOCAL_AMFLAGS = -I m4
+DISTCHECK_CONFIGURE_FLAGS = --enable-changeword
Index: doc/Makefile.am
===================================================================
RCS file: /sources/m4/m4/doc/Attic/Makefile.am,v
retrieving revision 1.8.2.5
diff -u -r1.8.2.5 Makefile.am
--- doc/Makefile.am 7 Jul 2006 20:20:38 -0000 1.8.2.5
+++ doc/Makefile.am 11 Jul 2006 14:12:10 -0000
@@ -20,6 +20,7 @@
## This file written by Eric Blake <address@hidden>
info_TEXINFOS = m4.texinfo
+m4_TEXINFOS = fdl.texi
man_MANS = m4.1
EXTRA_DIST = $(man_MANS)
MAINTAINERCLEANFILES = $(man_MANS)
Index: doc/m4.texinfo
===================================================================
RCS file: /sources/m4/m4/doc/m4.texinfo,v
retrieving revision 1.1.1.1.2.35
diff -u -r1.1.1.1.2.35 m4.texinfo
--- doc/m4.texinfo 11 Jul 2006 12:17:11 -0000 1.1.1.1.2.35
+++ doc/m4.texinfo 11 Jul 2006 14:12:10 -0000
@@ -41,7 +41,7 @@
@copying
This manual is for GNU M4 (version @value{VERSION}, @value{UPDATED}),
-a package containing an implementation the m4 macro language.
+a package containing an implementation of the m4 macro language.
Copyright @copyright{} 1989, 1990, 1991, 1992, 1993, 1994, 2004, 2005,
2006 Free Software Foundation, Inc.
@@ -81,7 +81,7 @@
@contents
@ifnottex
address@hidden Top, Preliminaries, (dir), (dir)
address@hidden Top
@top GNU M4
@insertcopying
@end ifnottex
@@ -97,11 +97,11 @@
GNU @code{m4} was originally written by Ren@'e Seindal, with
subsequent changes by Fran@,{c}ois Pinard and other volunteers
on the Internet. All names and email addresses can be found in the
-file @file{THANKS} from the GNU @code{m4} distribution.
+files @file{AUTHORS} and @file{THANKS} from the GNU M4 distribution.
This is release @value{VERSION}. It is now to be considered stable,
-future releases are only meant to fix bugs, increase speed, or improve
-documentation. address@hidden
+future releases in the 1.4.x series are only meant to fix bugs, increase
+speed, or improve documentation. address@hidden
An experimental feature, which would improve @code{m4} usefulness,
allows for changing the syntax for what is a @dfn{word} in @code{m4}.
@@ -139,8 +139,8 @@
* Compatibility:: Compatibility with other versions of m4
* Answers:: Answers
-* Concept index:: Index for many concepts
-* Macro index:: Index for all m4 macros
+* Copying This Manual:: How to make copies of this manual
+* Indices:: Indices of concepts and macros
@detailmenu
--- The Detailed Node Listing ---
@@ -249,10 +249,19 @@
* Incompatibilities:: Facilities in System V m4 not in GNU M4
* Other Incompatibilities:: Other incompatibilities
+Copying This Manual
+
+* GNU Free Documentation License:: License for copying this manual
+
+Indices
+
+* Concept index:: Index for many concepts
+* Macro index:: Index for all m4 macros
+
@end detailmenu
@end menu
address@hidden Preliminaries, Syntax, Top, Top
address@hidden Preliminaries
@chapter Introduction and preliminaries
This first chapter explains what is GNU @code{m4}, where @code{m4}
@@ -271,7 +280,7 @@
* Manual:: Using this manual
@end menu
address@hidden Intro, History, Preliminaries, Preliminaries
address@hidden Intro
@section Introduction to @code{m4}
@code{m4} is a macro processor, in the sense that it copies its
@@ -301,7 +310,7 @@
debugging their @code{m4} scripts than doing real work. Beware that
@code{m4} may be dangerous for the health of compulsive programmers.
address@hidden History, Invoking m4, Intro, Preliminaries
address@hidden History
@section Historical references
@code{GPM} has been an important ancestor of @code{m4}. See
@@ -355,7 +364,7 @@
as dynamic module loading and additional builtins. When complete, GNU
@code{m4} 2.0 will start a new series of releases.
address@hidden Invoking m4, Bugs, History, Preliminaries
address@hidden Invoking m4
@section Invoking @code{m4}
The format of the @code{m4} command is:
@@ -548,7 +557,7 @@
only be read once, so the filename @file{-} should only appear once on
the command line.
address@hidden Bugs, Manual, Invoking m4, Preliminaries
address@hidden Bugs
@section Problems and bugs
If you have problems with GNU @code{m4} or think you've found a bug,
@@ -573,7 +582,7 @@
about things that are unclear in the documentation or are just obscure
features, please report them too.
address@hidden Manual, , Bugs, Preliminaries
address@hidden Manual
@section Using this manual
This manual contains a number of examples of @code{m4} input and output,
@@ -614,11 +623,11 @@
ellipsis (@samp{...}) last in the argument list indicates that any
number of arguments may follow.
-This document consistently writes and uses @dfn{builtin}, without an
+This document consistently writes and uses @dfn{builtin}, without a
hyphen, as if it were an English word. This is how the @code{builtin}
primitive is spelled within @code{m4}.
address@hidden Syntax, Macros, Preliminaries, Top
address@hidden Syntax
@chapter Lexical and syntactic conventions
@cindex input tokens
@@ -636,7 +645,7 @@
* Input processing:: How m4 copies input to output
@end menu
address@hidden Names, Quoted strings, Syntax, Syntax
address@hidden Names
@section Names
@cindex names
@@ -647,7 +656,7 @@
Examples of legal names are: @samp{foo}, @samp{_tmp}, and @samp{name01}.
address@hidden Quoted strings, Other tokens, Names, Syntax
address@hidden Quoted strings
@section Quoted strings
@cindex quoted string
@@ -674,7 +683,7 @@
The quote characters can be changed at any time, using the builtin macro
@code{changequote}. @xref{Changequote}, for more information.
address@hidden Other tokens, Comments, Quoted strings, Syntax
address@hidden Other tokens
@section Other tokens
Any character, that is neither a part of a name, nor of a quoted string,
@@ -716,7 +725,7 @@
of the remaining input. In other words, the resulting text from a macro
call will be read and parsed into tokens again.
address@hidden expands a macro as soon as possible. It it finds a macro call
address@hidden expands a macro as soon as possible. If it finds a macro call
when collecting the arguments to another, it will expand the second
call first. If the input is
@@ -748,7 +757,7 @@
This process continues until there are no more macro calls to expand and
all the input has been consumed.
address@hidden Macros, Definitions, Syntax, Top
address@hidden Macros
@chapter How to invoke macros
This chapter covers macro invocation, macro arguments and how macro
@@ -762,7 +771,7 @@
* Macro expansion:: Expanding macros
@end menu
address@hidden Invocation, Inhibiting Invocation, Macros, Macros
address@hidden Invocation
@section Macro invocation
@cindex macro invocation
@@ -802,7 +811,7 @@
is a macro call with one argument, which is the empty string, not a call
with no arguments.
address@hidden Inhibiting Invocation, Macro Arguments, Invocation, Macros
address@hidden Inhibiting Invocation
@section Preventing macro invocation
An innovation of the @code{m4} language, compared to some of its
@@ -911,7 +920,7 @@
the input will produce the string @samp{divert}. When the quotes were
removed, the @code{divert} builtin was called instead.
address@hidden Macro Arguments, Quoting Arguments, Inhibiting Invocation, Macros
address@hidden Macro Arguments
@section Macro arguments
@cindex macros, arguments to
@@ -958,7 +967,7 @@
@result{}2
@end example
address@hidden Quoting Arguments, Macro expansion, Macro Arguments, Macros
address@hidden Quoting Arguments
@section Quoting macro arguments
@cindex quoted macro arguments
@@ -996,7 +1005,7 @@
consequences of quoting rules. This is done even when the quoted string
cannot be a macro, such as with integers.
address@hidden Macro expansion, , Quoting Arguments, Macros
address@hidden Macro expansion
@section Macro expansion
@cindex macros, expansion of
@@ -1019,7 +1028,7 @@
will expand first to @samp{bar}, and when this is reread and
expanded, into @samp{Hello world}.
address@hidden Definitions, Conditionals, Macros, Top
address@hidden Definitions
@chapter How to define new macros
@cindex macros, how to define new
@@ -1040,7 +1049,7 @@
* Builtin:: Indirect call of builtins
@end menu
address@hidden Define, Arguments, Definitions, Definitions
address@hidden Define
@section Defining a macro
@findex define
@@ -1115,7 +1124,7 @@
The macro @code{define} is recognized only with parameters.
address@hidden Arguments, Pseudo Arguments, Define, Definitions
address@hidden Arguments
@section Arguments to macros
@cindex macros, arguments to
@@ -1178,7 +1187,7 @@
The @samp{foo} in the expansion text is @emph{not} expanded, since it is
a quoted string, and not a name.
address@hidden Pseudo Arguments, Undefine, Arguments, Definitions
address@hidden Pseudo Arguments
@section Special arguments to macros
@cindex special arguments to macros
@@ -1287,7 +1296,7 @@
of quotes after the @code{$}. This will prevent @code{m4} from
interpreting the @code{$} sign as a reference to an argument.
address@hidden Undefine, Defn, Pseudo Arguments, Definitions
address@hidden Undefine
@section Deleting a macro
@cindex macros, how to delete
@@ -1337,7 +1346,7 @@
The macro @code{undefine} is recognized only with parameters.
address@hidden Defn, Pushdef, Undefine, Definitions
address@hidden Defn
@section Renaming macros
@cindex macros, how to rename
@@ -1404,9 +1413,9 @@
@result{}
@end example
-he macro @code{defn} is recognized only with parameters.
+The macro @code{defn} is recognized only with parameters.
address@hidden Pushdef, Indir, Defn, Definitions
address@hidden Pushdef
@section Temporarily redefining macros
@cindex macros, temporary redefinition of
@@ -1486,7 +1495,7 @@
The macros @code{pushdef} and @code{popdef} are recognized only with
parameters.
address@hidden Indir, Builtin, Pushdef, Definitions
address@hidden Indir
@section Indirect call of macros
@cindex indirect call of macros
@@ -1521,7 +1530,7 @@
The macro @code{indir} is recognized only with parameters.
address@hidden Builtin, , Indir, Definitions
address@hidden Builtin
@section Indirect call of builtins
@cindex indirect call of builtins
@@ -1543,7 +1552,7 @@
The macro @code{builtin} is recognized only with parameters.
address@hidden Conditionals, Debugging, Definitions, Top
address@hidden Conditionals
@chapter Conditionals, loops and recursion
Macros, expanding to plain text, perhaps with arguments, are not quite
@@ -1558,7 +1567,7 @@
* Loops:: Loops and recursion in m4
@end menu
address@hidden Ifdef, Ifelse, Conditionals, Conditionals
address@hidden Ifdef
@section Testing macro definitions
@cindex conditionals
@@ -1589,7 +1598,7 @@
The macro @code{ifdef} is recognized only with parameters.
address@hidden Ifelse, Loops, Ifdef, Conditionals
address@hidden Ifelse
@section Comparing strings
@cindex comparing strings
@@ -1619,7 +1628,7 @@
@result{}
@end example
-f called with three or four arguments, @code{ifelse} expands into
+If called with three or four arguments, @code{ifelse} expands into
@var{equal}, if @var{string-1} and @var{string-2} are equal (character
for character), otherwise it expands to @var{not-equal}.
@@ -1671,7 +1680,7 @@
The macro @code{ifelse} is recognized only with parameters.
address@hidden Loops, , Ifelse, Conditionals
address@hidden Loops
@section Loops and recursion
@cindex recursive macros
@@ -1793,7 +1802,7 @@
like start value less than final value, and the first argument not being
a name. Correcting these errors are left as an exercise to the reader.
address@hidden Debugging, Input Control, Conditionals, Top
address@hidden Debugging
@chapter How to debug macros and input
When writing macros for @code{m4}, they often do not work as intended on
@@ -1807,7 +1816,7 @@
* Debug Output:: Saving debugging output
@end menu
address@hidden Dumpdef, Trace, Debugging, Debugging
address@hidden Dumpdef
@section Displaying macro definitions
@cindex displaying macro definitions
@@ -1860,7 +1869,7 @@
@xref{Debug Levels}, for information on controlling the details of the
display.
address@hidden Trace, Debug Levels, Dumpdef, Debugging
address@hidden Trace
@section Tracing macro calls
@cindex tracing macro expansion
@@ -1963,7 +1972,7 @@
@xref{Debug Levels}, for information on controlling the details of the
display.
address@hidden Debug Levels, Debug Output, Trace, Debugging
address@hidden Debug Levels
@section Controlling debugging output
@cindex controlling debugging output
@@ -2041,7 +2050,7 @@
zero (as if no @samp{-d} was given), and with an empty argument the flags
are reset to the default.
address@hidden Debug Output, , Debug Levels, Debugging
address@hidden Debug Output
@section Saving debugging output
@cindex saving debugging output
@@ -2063,7 +2072,7 @@
@code{debugfile} is called without any arguments, debug and trace output
are sent to the standard error output.
address@hidden Input Control, File Inclusion, Debugging, Top
address@hidden Input Control
@chapter Input control
This chapter describes various builtin macros for controlling the input
@@ -2077,7 +2086,7 @@
* M4wrap:: Saving input until end of input
@end menu
address@hidden Dnl, Changequote, Input Control, Input Control
address@hidden Dnl
@section Deleting whitespace in input
@cindex deleting whitespace in input
@@ -2120,7 +2129,7 @@
@result{}but not this
@end example
address@hidden Changequote, Changecom, Dnl, Input Control
address@hidden Changequote
@section Changing the quote characters
@cindex changing the quote delimiters
@@ -2191,7 +2200,7 @@
as they will be confused with names in the input. Doing so disables
the quoting mechanism.
address@hidden Changecom, Changeword, Changequote, Input Control
address@hidden Changecom
@section Changing comment delimiters
@cindex changing comment delimiters
@@ -2243,7 +2252,7 @@
@result{}# Not a COMMENT anymore
@end example
address@hidden Changeword, M4wrap, Changecom, Input Control
address@hidden Changeword
@section Changing the lexical structure of words
@cindex lexical structure of words
@@ -2370,7 +2379,7 @@
by a factor of about seven, once it is changed to something other
than the default regular expression.
address@hidden M4wrap, , Changeword, Input Control
address@hidden M4wrap
@section Saving input
@cindex saving input
@@ -2433,7 +2442,7 @@
@result{}Answer: 10*9*8*7*6*5*4*3*2*1=3628800
@end example
address@hidden File Inclusion, Diversions, Input Control, Top
address@hidden File Inclusion
@chapter File inclusion
@cindex file inclusion
@@ -2446,7 +2455,7 @@
* Search Path:: Searching for include files
@end menu
address@hidden Include, Search Path, File Inclusion, File Inclusion
address@hidden Include
@section Including named files
@findex include
@@ -2518,11 +2527,11 @@
@example
define(`bar', include(`incl.m4'))
@result{}
-This is `bar': >>>bar<<<
address@hidden is bar: >>>Include file start
+This is `bar': >>bar<<
address@hidden is bar: >>Include file start
@result{}foo
@result{}Include file end
address@hidden<<<
address@hidden<<
@end example
This use of @code{include} is not trivial, though, as files can contain
@@ -2532,7 +2541,7 @@
The builtin macros @code{include} and @code{sinclude} are recognized
only when given arguments.
address@hidden Search Path, , Include, File Inclusion
address@hidden Search Path
@section Searching for include files
@cindex search path for included files
@@ -2551,7 +2560,7 @@
If the automatic search for include-files causes trouble, the @samp{p}
debug flag (@pxref{Debug Levels}) can help isolate the problem.
address@hidden Diversions, Text handling, File Inclusion, Top
address@hidden Diversions
@chapter Diverting and undiverting output
Diversions are a way of temporarily saving output. The output of
@@ -2580,7 +2589,7 @@
* Cleardiv:: Discarding diverted text
@end menu
address@hidden Divert, Undivert, Diversions, Diversions
address@hidden Divert
@section Diverting output
@cindex diverting output to files
@@ -2646,7 +2655,7 @@
This is a common programming idiom in @code{m4}.
address@hidden Undivert, Divnum, Divert, Diversions
address@hidden Undivert
@section Undiverting output
@findex undivert
@@ -2754,7 +2763,7 @@
@result{}
@end example
address@hidden Divnum, Cleardiv, Undivert, Diversions
address@hidden Divnum
@section Diversion numbers
@cindex diversion numbers
@@ -2783,7 +2792,7 @@
@result{}Diversion two: 2
@end example
address@hidden Cleardiv, , Divnum, Diversions
address@hidden Cleardiv
@section Discarding diverted text
@cindex discarding diverted text
@@ -2820,7 +2829,7 @@
diversions, given by the arguments. (This macro has a nasty bug! You
should try to see if you can find it and correct it. @xref{Answers}.)
address@hidden Text handling, Arithmetic, Diversions, Top
address@hidden Text handling
@chapter Macros for text handling
There are a number of builtins in @code{m4} for manipulating text in
@@ -2836,7 +2845,7 @@
* Format:: Formatting strings (printf-like)
@end menu
address@hidden Len, Index macro, Text handling, Text handling
address@hidden Len
@section Calculating length of strings
@cindex length of strings
@@ -2861,7 +2870,7 @@
The builtin macro @code{len} is recognized only when given arguments.
address@hidden Index macro, Regexp, Len, Text handling
address@hidden Index macro
@section Searching for substrings
@findex index
@@ -2887,7 +2896,7 @@
The builtin macro @code{index} is recognized only when given arguments.
address@hidden Regexp, Substr, Index macro, Text handling
address@hidden Regexp
@section Searching for regular expressions
@cindex regular expressions
@@ -2937,7 +2946,7 @@
The builtin macro @code{regexp} is recognized only when given arguments.
address@hidden Substr, Translit, Regexp, Text handling
address@hidden Substr
@section Extracting substrings
@cindex extracting substrings
@@ -2965,7 +2974,7 @@
The builtin macro @code{substr} is recognized only when given arguments.
address@hidden Translit, Patsubst, Substr, Text handling
address@hidden Translit
@section Translating characters
@cindex translating characters
@@ -3014,7 +3023,7 @@
The builtin macro @code{translit} is recognized only when given
arguments.
address@hidden Patsubst, Format, Translit, Text handling
address@hidden Patsubst
@section Substituting text by regular expression
@cindex regular expressions
@@ -3081,7 +3090,7 @@
The builtin macro @code{patsubst} is recognized only when given
arguments.
address@hidden Format, , Patsubst, Text handling
address@hidden Format
@section Formatted output
@cindex formatted output
@@ -3148,7 +3157,7 @@
The macro @code{format} is recognized only with parameters.
address@hidden Arithmetic, Shell commands, Text handling, Top
address@hidden Arithmetic
@chapter Macros for doing arithmetic
@cindex arithmetic
@@ -3162,7 +3171,7 @@
* Eval:: Evaluating integer expressions
@end menu
address@hidden Incr, Eval, Arithmetic, Arithmetic
address@hidden Incr
@section Decrement and increment operators
@cindex decrement operator
@@ -3192,7 +3201,7 @@
The builtin macros @code{incr} and @code{decr} are recognized only when
given arguments.
address@hidden Eval, , Incr, Arithmetic
address@hidden Eval
@section Evaluating integer expressions
@cindex integer expression evaluation
@@ -3334,7 +3343,7 @@
The builtin macro @code{eval} is recognized only when given arguments.
address@hidden Shell commands, Miscellaneous, Arithmetic, Top
address@hidden Shell commands
@chapter Running shell commands
@cindex executing UNIX commands
@@ -3363,7 +3372,7 @@
* Maketemp:: Making names for temporary files
@end menu
address@hidden Platform macros, Syscmd, Shell commands, Shell commands
address@hidden Platform macros
@section Determining the platform
@cindex platform macros
@@ -3427,7 +3436,7 @@
@result{}1
@end example
address@hidden Syscmd, Esyscmd, Platform macros, Shell commands
address@hidden Syscmd
@section Executing simple commands
@findex syscmd
@@ -3463,7 +3472,7 @@
The builtin macro @code{syscmd} is recognized only when given arguments.
address@hidden Esyscmd, Sysval, Syscmd, Shell commands
address@hidden Esyscmd
@section Reading the output of commands
@findex esyscmd
@@ -3500,7 +3509,7 @@
The builtin macro @code{esyscmd} is recognized only when given
arguments.
address@hidden Sysval, Maketemp, Esyscmd, Shell commands
address@hidden Sysval
@section Exit codes
@cindex exit code from UNIX commands
@@ -3572,7 +3581,7 @@
@result{}2304
@end example
address@hidden Maketemp, , Sysval, Shell commands
address@hidden Maketemp
@section Making names for temporary files
@cindex temporary filenames
@@ -3626,7 +3635,7 @@
The builtin macro @code{maketemp} is recognized only when given
arguments.
address@hidden Miscellaneous, Frozen files, Shell commands, Top
address@hidden Miscellaneous
@chapter Miscellaneous builtin macros
This chapter describes various builtins, that do not really belong in
@@ -3637,7 +3646,7 @@
* M4exit:: Exiting from m4
@end menu
address@hidden Errprint, M4exit, Miscellaneous, Miscellaneous
address@hidden Errprint
@section Printing error messages
@cindex printing error messages
@@ -3690,7 +3699,7 @@
@result{}
@end example
address@hidden M4exit, , Errprint, Miscellaneous
address@hidden M4exit
@section Exiting from @code{m4}
@cindex exiting from @code{m4}
@@ -3730,7 +3739,7 @@
m4exit
@end example
address@hidden Frozen files, Compatibility, Miscellaneous, Top
address@hidden Frozen files
@chapter Fast loading of frozen states
@cindex fast loading of frozen files
@@ -3832,7 +3841,7 @@
Path}).
Frozen files are sharable across architectures. It is safe to write
-a frozen file one machine and read it on another, given that the
+a frozen file on one machine and read it on another, given that the
second machine uses the same, or a newer version of GNU @code{m4}.
These are simple (editable) text files, made up of directives,
each starting with a capital letter and ending with a newline
@@ -3897,7 +3906,7 @@
* Other Incompatibilities:: Other incompatibilities
@end menu
address@hidden Extensions, Incompatibilities, Compatibility, Compatibility
address@hidden Extensions
@section Extensions in GNU @code{m4}
@cindex GNU extensions
@@ -3971,7 +3980,7 @@
Also, the debugging and tracing facilities in GNU @code{m4} are much
more extensive than in most other versions of @code{m4}.
address@hidden Incompatibilities, Other Incompatibilities, Extensions,
Compatibility
address@hidden Incompatibilities
@section Facilities in System V @code{m4} not in GNU @code{m4}
The version of @code{m4} from System V contains a few facilities that
@@ -4103,7 +4112,7 @@
adds the exponentiation operator @samp{**}.
@end itemize
address@hidden Other Incompatibilities, , Incompatibilities, Compatibility
address@hidden Other Incompatibilities
@section Other incompatibilities
There are a few other incompatibilities between this implementation of
@@ -4192,13 +4201,33 @@
@result{}
@end example
address@hidden ==========================================================
Appendices
+
address@hidden Copying This Manual
address@hidden Copying This Manual
address@hidden License
+
address@hidden
+* GNU Free Documentation License:: License for copying this manual
address@hidden menu
+
address@hidden fdl.texi
+
address@hidden Indices
address@hidden Indices
+
address@hidden
+* Concept index:: Index for many concepts
+* Macro index:: Index for all m4 macros
address@hidden menu
+
@node Concept index
address@hidden Concept index
address@hidden Concept index
@printindex cp
address@hidden Macro index, , Concept index, Top
address@hidden Macro index
address@hidden Macro index
address@hidden Macro index
References are exclusively to the places where a builtin is introduced
the first time. Names starting and ending with @samp{__} have these
Index: m4/gnulib-cache.m4
===================================================================
RCS file: /sources/m4/m4/m4/Attic/gnulib-cache.m4,v
retrieving revision 1.1.2.4
diff -u -r1.1.2.4 gnulib-cache.m4
--- m4/gnulib-cache.m4 7 Jul 2006 03:37:26 -0000 1.1.2.4
+++ m4/gnulib-cache.m4 11 Jul 2006 14:12:10 -0000
@@ -15,13 +15,14 @@
# Specification in the form of a command-line invocation:
-# gnulib-tool --import --dir=. --lib=libm4 --source-base=lib --m4-base=m4 --
aux-dir=. --macro-prefix=M4 alloca binary-io error getopt mkstemp obstack regex
strtol xalloc xvasprintf
+# gnulib-tool --import --dir=. --lib=libm4 --source-base=lib --m4-base=m4 --
doc-base=doc --aux-dir=. --macro-prefix=M4 alloca binary-io error fdl getopt
mkstemp obstack regex strtol xalloc xvasprintf
# Specification in the form of a few gnulib-tool.m4 macro invocations:
-gl_MODULES([alloca binary-io error getopt mkstemp obstack regex strtol xalloc
xvasprintf])
+gl_MODULES([alloca binary-io error fdl getopt mkstemp obstack regex strtol
xalloc xvasprintf])
gl_AVOID([])
gl_SOURCE_BASE([lib])
gl_M4_BASE([m4])
gl_TESTS_BASE([tests])
+gl_DOC_BASE([doc])
gl_LIB([libm4])
gl_MACRO_PREFIX([M4])