aboutsummaryrefslogtreecommitdiffstats
path: root/doc/gawktexi.in
diff options
context:
space:
mode:
Diffstat (limited to 'doc/gawktexi.in')
-rw-r--r--doc/gawktexi.in43
1 files changed, 22 insertions, 21 deletions
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index a0692e21..e5177ca2 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -51,9 +51,9 @@
@c applies to and all the info about who's publishing this edition
@c These apply across the board.
-@set UPDATE-MONTH December, 2015
+@set UPDATE-MONTH June, 2016
@set VERSION 4.1
-@set PATCHLEVEL 3
+@set PATCHLEVEL 4
@set GAWKINETTITLE TCP/IP Internetworking with @command{gawk}
@ifset FOR_PRINT
@@ -1542,7 +1542,7 @@ All appear in the index, under the heading ``sidebar.''
@end ifclear
Most of the time, the examples use complete @command{awk} programs.
-Some of the more advanced sections show only the part of the @command{awk}
+Some of the more advanced @value{SECTION}s show only the part of the @command{awk}
program that illustrates the concept being described.
Although this @value{DOCUMENT} is aimed principally at people who have not been
@@ -1765,6 +1765,7 @@ The GNU FDL}
is the license that covers this @value{DOCUMENT}.
@end itemize
+@c ok not to use CHAPTER / SECTION here
Some of the chapters have exercise sections; these have also been
omitted from the print edition but are available online.
@end ifset
@@ -2427,7 +2428,7 @@ reliable because there are no other files to misplace.
Later in this chapter, in
@ifdocbook
-the section
+the @value{SECTION}
@end ifdocbook
@ref{Very Simple},
we'll see examples of several short,
@@ -3310,7 +3311,8 @@ After the last line of output from @command{ls} has been processed, the
@code{END} rule executes and prints the value of @code{sum}.
In this example, the value of @code{sum} is 80600.
-These more advanced @command{awk} techniques are covered in later sections
+These more advanced @command{awk} techniques are covered in later
+@value{SECTION}s
(@pxref{Action Overview}). Before you can move on to more
advanced @command{awk} programming, you have to know how @command{awk} interprets
your input and displays your output. By manipulating fields and using
@@ -8332,7 +8334,7 @@ trying to accomplish.
@item
@ifdocbook
-The next section
+The next @value{SECTION}
@end ifdocbook
@ifnotdocbook
@ref{Getline Summary},
@@ -13047,10 +13049,10 @@ As with the @code{BEGIN} and @code{END} rules
@end ifnotdocbook
@end ifnottex
@iftex
-(see the previous section),
+(see the previous @value{SECTION}),
@end iftex
@ifdocbook
-(see the previous section),
+(see the previous @value{SECTION}),
@end ifdocbook
all @code{BEGINFILE} rules in a program are merged, in the order they are
read by @command{gawk}, and all @code{ENDFILE} rules are merged as well.
@@ -13812,7 +13814,7 @@ statement outside a loop the same way they treated a @code{break}
statement outside a loop: as if it were a @code{next}
statement
@ifset FOR_PRINT
-(discussed in the following section).
+(discussed in the following @value{SECTION}).
@end ifset
@ifclear FOR_PRINT
(@pxref{Next Statement}).
@@ -16382,10 +16384,9 @@ be called.
@node Built-in
@section Built-in Functions
-@dfn{Built-in} functions are always available for
-your @command{awk} program to call. This @value{SECTION} defines all
-the built-in
-functions in @command{awk}; some of these are mentioned in other sections
+@dfn{Built-in} functions are always available for your @command{awk}
+program to call. This @value{SECTION} defines all the built-in functions
+in @command{awk}; some of these are mentioned in other @value{SECTION}s
but are summarized here for your convenience.
@menu
@@ -17614,7 +17615,7 @@ that had been its behavior for many years.
When @value{PVERSION} 4.0.0 was released, the @command{gawk} maintainer
made the POSIX rules the default, breaking well over a decade's worth
of backward compatibility.@footnote{This was rather naive of him, despite
-there being a note in this section indicating that the next major version
+there being a note in this @value{SECTION} indicating that the next major version
would move to the POSIX rules.} Needless to say, this was a bad idea,
and as of @value{PVERSION} 4.0.1, @command{gawk} resumed its historical
behavior, and only follows the POSIX rules when @option{--posix} is given.
@@ -22653,7 +22654,7 @@ presenting a potpourri of @command{awk} programs for your reading
enjoyment.
@c FULLXREF OFF
@ifnotinfo
-There are three sections.
+There are three @value{SECTION}s.
The first describes how to run the programs presented
in this @value{CHAPTER}.
@@ -31918,7 +31919,7 @@ it to always be called, and to take effect as appropriate (as the
@code{readdir} extension does). Or you may want it to take effect
based upon the value of an @command{awk} variable, as the XML extension
from the @code{gawkextlib} project does (@pxref{gawkextlib}).
-In the latter case, code in a @code{BEGINFILE} section
+In the latter case, code in a @code{BEGINFILE} rule
can look at @code{FILENAME} and @code{ERRNO} to decide whether or
not to activate an input parser (@pxref{BEGINFILE/ENDFILE}).
@@ -32083,7 +32084,7 @@ values, etc.) within @command{gawk}.
@itemx @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_input_buf_t *inbuf,
@itemx @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_output_buf_t *outbuf);
The function pointed to by this field should fill in the @code{awk_input_buf_t} and
-@code{awk_outut_buf_t} structures pointed to by @code{inbuf} and
+@code{awk_output_buf_t} structures pointed to by @code{inbuf} and
@code{outbuf}, respectively. These structures were described earlier.
@item awk_const struct two_way_processor *awk_const next;
@@ -32465,7 +32466,7 @@ my_extension_init()
@}
@end example
-Next, use the routines in this section for retrieving and updating
+Next, use the routines in this @value{SECTION} for retrieving and updating
the value through the cookie. Thus, @code{do_magic()} now becomes
something like this:
@@ -32497,7 +32498,7 @@ and carefully check the return values from the API functions.
@node Cached values
@subsubsection Creating and Using Cached Values
-The routines in this section allow you to create and release
+The routines in this @value{SECTION} allow you to create and release
cached values. Like scalar cookies, in theory, cached values
are not necessary. You can create numbers and strings using
the functions in @ref{Constructor Functions}. You can then
@@ -32513,7 +32514,7 @@ are clearly less problematic, requiring only a C @code{double} to store.}
It is clearly more efficient, if possible, to create a value once, and
then tell @command{gawk} to reuse the value for multiple variables. That
-is what the routines in this section let you do. The functions are as follows:
+is what the routines in this @value{SECTION} let you do. The functions are as follows:
@table @code
@item awk_bool_t create_value(awk_value_t *value, awk_value_cookie_t *result);
@@ -32750,7 +32751,7 @@ structure and fill it in. Set the pointer whose address is passed as @code{data}
to point to this structure.
Return true upon success, or false otherwise.
@ifset FOR_PRINT
-See the next section
+See the next @value{SECTION}
@end ifset
@ifclear FOR_PRINT
@xref{Flattening Arrays},