[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gawk-diffs] [SCM] gawk branch, feature/better-index, updated. gawk-4.1.
|
From: |
Arnold Robbins |
|
Subject: |
[gawk-diffs] [SCM] gawk branch, feature/better-index, updated. gawk-4.1.0-3756-g1a4ad4a |
|
Date: |
Tue, 30 Apr 2019 14:36:40 -0400 (EDT) |
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".
The branch, feature/better-index has been updated
via 1a4ad4a8c0e417a4badf0eaf1fa342e7b4bc43b7 (commit)
from abcf377ae763aa4eb1d01ea46d60234d12ced679 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=1a4ad4a8c0e417a4badf0eaf1fa342e7b4bc43b7
commit 1a4ad4a8c0e417a4badf0eaf1fa342e7b4bc43b7
Author: Arnold D. Robbins <address@hidden>
Date: Tue Apr 30 21:36:20 2019 +0300
Finish off index improvements (we hope).
diff --git a/doc/gawk.texi b/doc/gawk.texi
index a671d32..e53c563 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -1970,6 +1970,7 @@ Emacs editor. GNU Emacs is the most widely used version
of Emacs today.
@cindex GNU Project
@cindex GPL (General Public License)
address@hidden GNU General Public License @seeentry{GPL}
@cindex General Public License @seeentry{GPL}
@cindex documentation @subentry online
The address@hidden stands for ``GNU's Not Unix.''}
@@ -2001,7 +2002,7 @@ freely available. The GNU operating
system kernel (the HURD), has been released but remains in an early
stage of development.
address@hidden Linux
address@hidden Linux @seeentry{GNU/Linux}
@cindex GNU/Linux
@cindex operating systems @subentry BSD-based
Until the GNU operating system is more fully developed, you should
@@ -4047,7 +4048,7 @@ with @samp{#!} scripts (@pxref{Executable Scripts}), like
so:
@itemx @option{--gen-pot}
@cindex @option{-g} option
@cindex @option{--gen-pot} option
address@hidden portable object files @subentry generating
address@hidden portable object @subentry files @subentry generating
@cindex files @subentry portable object @subentry generating
Analyze the source program and
generate a GNU @command{gettext} portable object template file on standard
@@ -4293,7 +4294,7 @@ Warn about constructs that are not available in the
original version of
@itemx @option{--version}
@cindex @option{-V} option
@cindex @option{--version} option
address@hidden @command{gawk} @subentry versions of, printing information about
address@hidden @command{gawk} @subentry version of @subentry printing
information about
Print version information for this particular copy of @command{gawk}.
This allows you to determine if your copy of @command{gawk} is up to date
with respect to whatever the Free Software Foundation is currently
@@ -4744,7 +4745,7 @@ calls from the GNU C library to help track down possible
memory leaks.
@node Exit Status
@section @command{gawk}'s Exit Status
address@hidden exit status @subentry of @command{gawk}
address@hidden exit status, of @command{gawk}
If the @code{exit} statement is used with a value
(@pxref{Exit Statement}), then @command{gawk} exits with
the numeric value given to it.
@@ -5261,6 +5262,7 @@ a @dfn{regexp constant}, much like @code{5.27} is a
numeric constant and
@section Escape Sequences
@cindex escape sequences
address@hidden escape sequences @seealso{backslash}
@cindex backslash (@code{\}) @subentry in escape sequences
@cindex @code{\} (backslash) @subentry in escape sequences
Some characters cannot be included literally in string constants
@@ -5441,6 +5443,7 @@ two backslashes in the string: @samp{FS = @w{"[ \t]+\\|[
\t]+"}}.)
@c I did this! This is why I added the warning.
@cindex @command{gawk} @subentry escape sequences
address@hidden @command{gawk} @subentry escape sequences @seealso{backslash}
@cindex Unix @command{awk} @subentry backslashes in escape sequences
@cindex @command{mawk} utility
@item Leave the backslash alone
@@ -5484,6 +5487,7 @@ two backslashes in the string: @samp{FS = @w{"[ \t]+\\|[
\t]+"}}.)
@c I did this! This is why I added the warning.
@cindex @command{gawk} @subentry escape sequences
address@hidden @command{gawk} @subentry escape sequences @seealso{backslash}
@cindex Unix @command{awk} @subentry backslashes in escape sequences
@cindex @command{mawk} utility
@item Leave the backslash alone
@@ -5519,7 +5523,7 @@ literally.
<sidebar><title>Escape Sequences for Metacharacters</title>
@end docbook
address@hidden metacharacters, escape sequences for
address@hidden metacharacters @subentry escape sequences for
Suppose you use an octal or hexadecimal
escape to represent a regexp metacharacter.
@@ -5547,7 +5551,7 @@ escape sequences literally when used in regexp constants.
Thus,
@center @b{Escape Sequences for Metacharacters}
address@hidden metacharacters, escape sequences for
address@hidden metacharacters @subentry escape sequences for
Suppose you use an octal or hexadecimal
escape to represent a regexp metacharacter.
@@ -5570,7 +5574,7 @@ escape sequences literally when used in regexp constants.
Thus,
@node Regexp Operators
@section Regular Expression Operators
@cindex regular expressions @subentry operators
address@hidden metacharacters in regular expressions
address@hidden metacharacters @subentry in regular expressions
You can combine regular expressions with special characters,
called @dfn{regular expression operators} or @dfn{metacharacters}, to
@@ -7167,7 +7171,7 @@ existing fields.
@cindex @code{OFS} variable
@cindex output field separator @address@hidden variable}
address@hidden field separators @address@hidden
address@hidden field separator @address@hidden
This recomputation affects and is affected by
@code{NF} (the number of fields; @pxref{Fields}).
For example, the value of @code{NF} is set to the number of the highest
@@ -7332,7 +7336,7 @@ with a statement such as @samp{$1 = $1}, as described
earlier.
@cindex @code{FS} variable
@cindex fields @subentry separating
address@hidden field separators
address@hidden field separator
@cindex fields @subentry separating
The @dfn{field separator}, which is either a single character or a regular
expression, controls the way @command{awk} splits an input record into fields.
@@ -7385,9 +7389,9 @@ John Q. Smith, 29 Oak St., Walamazoo, MI 42139
this @command{awk} program extracts and prints the string
@address@hidden@address@hidden
address@hidden field separators @subentry choice of
address@hidden field separator @subentry choice of
@cindex regular expressions @subentry as field separators
address@hidden field separators @subentry regular expressions as
address@hidden field separator @subentry regular expression as
Sometimes the input data contains separator characters that don't
separate fields the way you thought they would. For instance, the
person's name in the example we just used might have a title or
@@ -7410,8 +7414,10 @@ can massage it first with a separate @command{awk}
program.)
@node Default Field Splitting
@subsection Whitespace Normally Separates Fields
address@hidden field separators @subentry whitespace as
address@hidden field separator @subentry whitespace as
@cindex whitespace @subentry as field separators
address@hidden field separator @subentry @code{FS} variable and
address@hidden separators @subentry field @subentry @code{FS} variable and
Fields are normally separated by whitespace sequences
(spaces, TABs, and newlines), not by single spaces. Two spaces in a row do not
delimit an empty field. The default value of the field separator @code{FS}
@@ -7433,7 +7439,7 @@ rules.
@subsection Using Regular Expressions to Separate Fields
@cindex regular expressions @subentry as field separators
address@hidden field separators @subentry regular expressions as
address@hidden field separator @subentry regular expression as
The previous @value{SUBSECTION}
discussed the use of single characters or simple strings as the
value of @code{FS}.
@@ -7563,7 +7569,7 @@ $ @kbd{echo a b | gawk 'BEGIN @{ FS = "" @}}
@end example
@cindex dark corner @subentry @code{FS} as null string
address@hidden @code{FS} variable @subentry as null string
address@hidden @code{FS} variable @subentry null string as
Traditionally, the behavior of @code{FS} equal to @code{""} was not defined.
In this case, most versions of Unix @command{awk} simply treat the entire
record
as only having one field.
@@ -8658,7 +8664,7 @@ the value of @code{NF} do not change.
@cindex @code{getline} command @subentry from a file
@cindex input redirection
address@hidden redirection of input
address@hidden redirection @subentry of input
@cindex @code{<} (left angle bracket) @subentry @code{<} operator (I/O)
@cindex left angle bracket (@code{<}) @subentry @code{<} operator (I/O)
@cindex operators @subentry input/output
@@ -8956,7 +8962,7 @@ program and start testing the new record against every
pattern.
However, the new record is tested against any subsequent rules.
@cindex differences in @command{awk} and @command{gawk} @subentry
implementation limitations
address@hidden implementation issues @subentry @command{gawk} @subentry limits
address@hidden implementation issues, @command{gawk} @subentry limits
@cindex @command{awk} @subentry implementations @subentry limits
@cindex @command{gawk} @subentry implementation issues @subentry limits
@item
@@ -9392,7 +9398,7 @@ expression. Numeric values are converted to strings and
then printed.
@cindex records @subentry printing
@cindex lines @subentry blank, printing
address@hidden text @subentry printing
address@hidden text, printing
The simple statement @samp{print} with no items is equivalent to
@samp{print $0}: it prints the entire current record. To print a blank
line, use @samp{print ""}.
@@ -9881,7 +9887,7 @@ which they may appear:
@cindex differences in @command{awk} and @command{gawk} @subentry
@code{print}/@code{printf} statements
@cindex @code{printf} statement @subentry positional specifiers
@c the code{} does NOT start a secondary
address@hidden positional specifiers @subentry @code{printf} statement
address@hidden positional specifiers, @code{printf} statement
@item @address@hidden
An integer constant followed by a @samp{$} is a @dfn{positional specifier}.
Normally, format specifications are applied to arguments in the order
@@ -10157,7 +10163,7 @@ awk 'BEGIN @{ format = "%-10s %s\n"
@section Redirecting Output of @code{print} and @code{printf}
@cindex output redirection
address@hidden redirection of output
address@hidden redirection @subentry of output
@cindex @option{--sandbox} option @subentry output redirection with
@code{print} @subentry @code{printf}
So far, the output from @code{print} and @code{printf} has gone
to the standard
@@ -10338,7 +10344,7 @@ for the same file is definitely poor style, and is
confusing to readers
of your program.)
@cindex differences in @command{awk} and @command{gawk} @subentry
implementation limitations
address@hidden implementation issues @subentry @command{gawk} @subentry limits
address@hidden implementation issues, @command{gawk} @subentry limits
@cindex @command{awk} @subentry implementation issues @subentry pipes
@cindex @command{gawk} @subentry implementation issues @subentry pipes
@ifnotinfo
@@ -12769,7 +12775,7 @@ the string constant @code{"0"} is actually true,
because it is non-null.
@cindex comparison expressions
@cindex expressions @subentry comparison
@cindex expressions, matching @seeentry{comparison expressions}
address@hidden matching, expressions @seeentry{comparison expressions}
address@hidden matching @subentry expressions @seeentry{comparison expressions}
@cindex relational operators @seeentry{comparison operators}
@cindex operators, relational @seeentry{operators, comparison}
@cindex variables @subentry types of @subentry comparison expressions and
@@ -15435,7 +15441,7 @@ Its default value is @code{"%.6g"}.
@cindex @command{gawk} @subentry @code{FIELDWIDTHS} variable in
@cindex @code{FIELDWIDTHS} variable
@cindex differences in @command{awk} and @command{gawk} @subentry
@code{FIELDWIDTHS} variable
address@hidden field separators @subentry @code{FIELDWIDTHS} variable and
address@hidden field separator @subentry @code{FIELDWIDTHS} variable and
@cindex separators @subentry field @subentry @code{FIELDWIDTHS} variable and
@item FIELDWIDTHS #
A space-separated list of columns that tells @command{gawk}
@@ -15450,7 +15456,7 @@ overrides the use of @code{FS} and @code{FPAT} for
field splitting.
@cindex @command{gawk} @subentry @code{FPAT} variable in
@cindex @code{FPAT} variable
@cindex differences in @command{awk} and @command{gawk} @subentry @code{FPAT}
variable
address@hidden field separators @subentry @code{FPAT} variable and
address@hidden field separator @subentry @code{FPAT} variable and
@cindex separators @subentry field @subentry @code{FPAT} variable and
@item FPAT #
A regular expression (as a string) that tells @command{gawk}
@@ -15461,7 +15467,7 @@ overrides the use of @code{FS} and @code{FIELDWIDTHS}
for field splitting.
@cindex @code{FS} variable
@cindex separators @subentry field
address@hidden field separators
address@hidden field separator
@item FS
The input field separator (@pxref{Field Separators}).
The value is a single-character string or a multicharacter regular
@@ -15552,7 +15558,7 @@ strings in general expressions; this is now done by
@code{CONVFMT}.
@cindex @code{print} statement @subentry @code{OFMT} variable and
@cindex @code{OFS} variable
@cindex separators @subentry field
address@hidden field separators
address@hidden field separator
@item OFS
The output field separator (@pxref{Output Separators}). It is
output between the fields printed by a @code{print} statement. Its
@@ -15948,7 +15954,7 @@ The value of the @code{getuid()} system call.
@item PROCINFO["version"]
@cindex version of @subentry @command{gawk}
address@hidden @command{gawk} version
address@hidden @command{gawk} @subentry version of
The version of @command{gawk}.
@end table
@@ -17262,7 +17268,7 @@ string value from @code{xyz}---this time
@code{"12.15"}---because the value of
@code{CONVFMT} only allows two significant digits. This test fails,
because @code{"12.15"} is different from @code{"12.153"}.
address@hidden converting integer array subscripts
address@hidden converting @subentry integer array subscripts to strings
@cindex integer array indices
According to the rules for conversions
(@pxref{Conversion}), integer
@@ -17357,7 +17363,7 @@ on the command line (@pxref{Options}).
@node Delete
@section The @code{delete} Statement
@cindex @code{delete} statement
address@hidden deleting elements in arrays
address@hidden deleting @subentry elements in arrays
@cindex arrays @subentry elements @subentry deleting
@cindex elements in arrays @subentry deleting
@@ -17413,7 +17419,7 @@ is not in the array is deleted.
@cindex common extensions @subentry @code{delete} to delete entire arrays
@cindex extensions @subentry common @subentry @code{delete} to delete entire
arrays
@cindex arrays @subentry deleting entire contents
address@hidden deleting entire arrays
address@hidden deleting @subentry entire arrays
@cindex @code{delete} @var{array}
@cindex differences in @command{awk} and @command{gawk} @subentry array
elements, deleting
All the elements of an array may be deleted with a single statement
@@ -18424,7 +18430,7 @@ If @option{--posix} is supplied, using an array
argument is a fatal error
@item @code{match(@var{string}, @var{regexp}} address@hidden, @address@hidden)}
@cindexawkfunc{match}
address@hidden string @subentry regular expression match
address@hidden string @subentry regular expression match of
@cindex match regexp in string
Search @var{string} for the
longest, leftmost substring matched by the regular expression
@@ -18672,7 +18678,7 @@ pival = sprintf("pi = %.2f (approx.)", 22/7)
assigns the string @address@hidden = 3.14 (approx.)}} to the variable
@code{pival}.
@cindexgawkfunc{strtonum}
address@hidden converting @subentry string to number
address@hidden converting @subentry string to numbers
@item @code{strtonum(@var{str}) #}
Examine @var{str} and return its numeric value. If @var{str}
begins with a leading @samp{0}, @code{strtonum()} assumes that @var{str}
@@ -20551,7 +20557,7 @@ Optional parameters are enclosed in square brackets ([
]):
@table @asis
@cindexgawkfunc{bindtextdomain}
address@hidden set @subentry directory of message catalogs
address@hidden set directory of message catalogs
@item @code{bindtextdomain(@var{directory}} address@hidden,} @address@hidden)}
Set the directory in which
@command{gawk} will look for message translation files, in case they
@@ -20633,7 +20639,7 @@ The definition of a function named @var{name} looks
like this:
@cindex names @subentry functions
@cindex functions @subentry names of
address@hidden namespace issues @subentry functions
address@hidden naming issues @subentry functions
@noindent
Here, @var{name} is the name of the function to define. A valid function
name is like a valid variable name: a sequence of letters, digits, and
@@ -20914,7 +20920,7 @@ an error.
@node Variable Scope
@subsubsection Controlling Variable Scope
address@hidden local variables, in a function
address@hidden local variables @subentry in a function
@cindex variables @subentry local to a function
Unlike in many languages,
there is no way to make a variable local to a @address@hidden @dots{}
@address@hidden block in
@@ -21918,7 +21924,7 @@ comparisons use only lowercase letters.
@cindex names @subentry arrays/variables
@cindex names @subentry functions
address@hidden namespace issues
address@hidden naming issues
@cindex @command{awk} programs @subentry documenting
@cindex documentation @subentry of @command{awk} programs
Due to the way the @command{awk} language evolved, variables are either
@@ -23622,7 +23628,7 @@ use @code{getopt()} to process their arguments.
@node Passwd Functions
@section Reading the User Database
address@hidden libraries of @command{awk} functions @subentry user database
@subentry reading
address@hidden libraries of @command{awk} functions @subentry user database,
reading
@cindex functions @subentry library @subentry user database, reading
@cindex user database, reading
@cindex database @subentry users, reading
@@ -23642,7 +23648,7 @@ for a similar suite that retrieves information from the
group database.
@cindex C library functions @subentry @code{getpwent()}
@cindex @code{getpwent()} user-defined function
@cindex user-defined @subentry function @subentry @code{getpwent()}
address@hidden users @subentry information about @subentry retrieving
address@hidden users, information about @subentry retrieving
@cindex login information
@cindex account information
@cindex password file
@@ -23986,7 +23992,7 @@ uses these functions.
@node Group Functions
@section Reading the Group Database
address@hidden libraries of @command{awk} functions @subentry group database
@subentry reading
address@hidden libraries of @command{awk} functions @subentry group database,
reading
@cindex functions @subentry library @subentry group database, reading
@cindex group database, reading
@cindex database @subentry group, reading
@@ -24821,7 +24827,7 @@ BEGIN @{
@c endfile
@end example
address@hidden field separators @subentry spaces as
address@hidden field separator @subentry spaces as
The code must take
special care when the field delimiter is a space. Using
a single space (@address@hidden" "}}) for the value of @code{FS} is
@@ -25290,7 +25296,7 @@ function usage()
@subsection Printing Out User Information
@cindex printing @subentry user information
address@hidden users @subentry information about @subentry printing
address@hidden users, information about @subentry printing
@cindex @command{id} utility
The @command{id} utility lists a user's real and effective user ID numbers,
real and effective group ID numbers, and the user's group set, if any.
@@ -25697,7 +25703,7 @@ END @{
@c FIXME: One day, update to current POSIX version of uniq
@cindex printing @subentry unduplicated lines of text
address@hidden text @subentry printing @subentry unduplicated lines of
address@hidden text, printing @subentry unduplicated lines of
@cindex @command{uniq} utility
The @command{uniq} utility reads sorted lines of data on its standard
input, and by default removes duplicate lines. In other words, it only
@@ -29344,7 +29350,7 @@ is a count showing how many times the condition was
true.
The count for the @code{else}
indicates how many times the test failed.
address@hidden loops, count for header, in a profile
address@hidden loops @subentry count for header, in a profile
@item
The count for a loop header (such as @code{for}
or @code{while}) shows how many times the loop test was executed.
@@ -29674,7 +29680,7 @@ by calling the @code{textdomain()} function.
@cindex @code{.pot} files
@cindex files @subentry @code{.pot}
@cindex portable object @subentry template files
address@hidden files @subentry portable object template
address@hidden files @subentry portable object @subentry template file
(@file{.pot})
@item
Messages from the application are extracted from the source code and
collected into a portable object template file (@file{guide.pot}),
@@ -29685,7 +29691,7 @@ lookup of the translations.
@cindex @code{.po} files
@cindex files @subentry @code{.po}
address@hidden portable object files
address@hidden portable object @subentry files
@cindex files @subentry portable object
@item
For each language with a translator, @file{guide.pot}
@@ -30029,7 +30035,7 @@ and use translations from @command{awk}.
@cindex @code{.po} files
@cindex files @subentry @code{.po}
address@hidden portable object files
address@hidden portable object @subentry files
@cindex files @subentry portable object
Once a program's translatable strings have been marked, they must
be extracted to create the initial @file{.pot} file.
@@ -30088,7 +30094,7 @@ translations for @command{guide}.
@subsection Rearranging @code{printf} Arguments
@cindex @code{printf} statement @subentry positional specifiers
address@hidden positional specifiers @subentry @code{printf} statement
address@hidden positional specifiers, @code{printf} statement
Format strings for @code{printf} and @code{sprintf()}
(@pxref{Printf})
present a special problem for translation.
@@ -30156,7 +30162,7 @@ This is somewhat counterintuitive.
@end quotation
@cindex @code{printf} statement @subentry positional specifiers @subentry
mixing with regular formats
address@hidden positional specifiers @subentry @code{printf} statement
@subentry mixing with regular formats
address@hidden positional specifiers, @code{printf} statement @subentry mixing
with regular formats
@cindex format specifiers @subentry mixing regular with positional specifiers
@command{gawk} does not allow you to mix regular format specifiers
and those with positional specifiers in the same string:
@@ -30340,7 +30346,6 @@ msgstr "Like, the scoop is"
@c endfile
@end example
address@hidden Linux
@cindex GNU/Linux
@quotation NOTE
The following instructions apply to GNU/Linux with the GNU C Library. Be
@@ -30385,7 +30390,7 @@ $ @kbd{mkdir en_US.UTF-8 en_US.UTF-8/LC_MESSAGES}
@cindex files @subentry @code{.po} @subentry converting to @code{.mo}
@cindex @code{.mo} files, converting from @code{.po}
@cindex files @subentry @code{.mo}, converting from @code{.po}
address@hidden portable object files @subentry converting to message object
files
address@hidden portable object @subentry files @subentry converting to message
object files
@cindex files @subentry portable object @subentry converting to message object
files
@cindex message object files @subentry converting from portable object files
@cindex files @subentry message object @subentry converting from portable
object files
@@ -31015,7 +31020,7 @@ controlling breakpoints are:
@cindex debugger @subentry commands @subentry @code{break}
@cindex @code{break} debugger command
@cindex @code{b} debugger command (alias for @code{break})
address@hidden set @subentry breakpoint
address@hidden set breakpoint
@cindex breakpoint @subentry setting
@item @code{break} address@hidden@code{:address@hidden | @var{function}]
address@hidden"@var{expression}"}]
@itemx @code{b} address@hidden@code{:address@hidden | @var{function}]
address@hidden"@var{expression}"}]
@@ -31372,7 +31377,7 @@ You can also set special @command{awk} variables, such
as @code{FS},
@cindex debugger @subentry commands @subentry @code{watch}
@cindex @code{watch} debugger command
@cindex @code{w} debugger command (alias for @code{watch})
address@hidden set @subentry watchpoint
address@hidden set watchpoint
@item @code{watch} @var{var} | @address@hidden
address@hidden"@var{expression}"}]
@itemx @code{w} @var{var} | @address@hidden address@hidden"@var{expression}"}]
Add variable @var{var} (or field @address@hidden) to the watch list.
@@ -31484,7 +31489,7 @@ List arguments of the selected frame.
@item break
@cindex show in debugger @subentry breakpoints
address@hidden breakpoint, show all in debugger
address@hidden breakpoint @subentry show all in debugger
List all currently set breakpoints.
@item display
@@ -31503,7 +31508,7 @@ line numbers.
@item locals
@cindex show in debugger @subentry local variables
address@hidden local variables, show in debugger
address@hidden local variables @subentry show in debugger
List local variables of the selected frame.
@item source
@@ -32132,7 +32137,7 @@ of @code{BEGIN}, @code{BEGINFILE}, @code{END}, and
@code{ENDFILE} rules.
@section Namespace and Component Naming Rules
@cindex naming rules, namespace and component names
address@hidden namespace names, naming rules
address@hidden namespaces @subentry naming rules
@c not "component names" to merge with other index entry
@cindex component name @subentry naming rules
A number of rules apply to the namespace and component names, as follows.
@@ -36421,7 +36426,7 @@ information about how @command{gawk} was invoked.
@node Extension Versioning
@subsubsection API Version Constants and Variables
@cindex API @subentry version
address@hidden extension API @subentry version
address@hidden extension API @subentry version number
The API provides both a ``major'' and a ``minor'' version number.
The API versions are available at compile time as C preprocessor defines
@@ -40624,26 +40629,32 @@ on other platforms, the appropriate location may be
different.
@table @command
@cindex @command{gawkpath_default} shell function
address@hidden shell function @subentry @command{gawkpath_default}
@item gawkpath_default
Reset the @env{AWKPATH} environment variable to its default value.
@cindex @command{gawkpath_prepend} shell function
address@hidden shell function @subentry @command{gawkpath_prepend}
@item gawkpath_prepend
Add the argument to the front of the @env{AWKPATH} environment variable.
@cindex @command{gawkpath_append} shell function
address@hidden shell function @subentry @command{gawkpath_append}
@item gawkpath_append
Add the argument to the end of the @env{AWKPATH} environment variable.
@cindex @command{gawklibpath_default} shell function
address@hidden shell function @subentry @command{gawklibpath_default}
@item gawklibpath_default
Reset the @env{AWKLIBPATH} environment variable to its default value.
@cindex @command{gawklibpath_prepend} shell function
address@hidden shell function @subentry @command{gawklibpath_prepend}
@item gawklibpath_prepend
Add the argument to the front of the @env{AWKLIBPATH} environment variable.
@cindex @command{gawklibpath_append} shell function
address@hidden shell function @subentry @command{gawklibpath_append}
@item gawklibpath_append
Add the argument to the end of the @env{AWKLIBPATH} environment variable.
@@ -40802,7 +40813,7 @@ See also the @file{README_d/README.pc} file in the
distribution.
@node PC Binary Installation
@appendixsubsubsec Installing a Prepared Distribution for MS-Windows Systems
address@hidden installation @subentry MS-Windows
address@hidden installing @command{gawk} @subentry MS-Windows
The only supported binary distribution for MS-Windows systems
is that provided by Eli Zaretskii's
@uref{https://sourceforge.net/projects/ezwinports/,
@@ -40976,7 +40987,7 @@ When compared to GNU/Linux on the same system, the
@samp{configure}
step on Cygwin takes considerably longer. However, it does finish,
and then the @samp{make} proceeds as usual.
address@hidden installation @subentry Cygwin
address@hidden installing @command{gawk} @subentry Cygwin
You may also install @command{gawk} using the regular Cygwin installer.
In general Cygwin supplies the latest released version.
@@ -41008,7 +41019,7 @@ translation of @code{"\r\n"}, because it won't.
@c now address@hidden
@cindex @command{gawk} @subentry VMS version of
address@hidden installation @subentry VMS
address@hidden installing @command{gawk} @subentry VMS
This @value{SUBSECTION} describes how to compile and install @command{gawk}
under VMS.
The older designation ``VMS'' is used throughout to refer to OpenVMS.
@@ -41222,7 +41233,7 @@ flag is required to force Unix-style parsing rather
than @code{DCL} parsing.
If any other dash-type options (or multiple parameters such as @value{DF}s to
process) are present, there is no ambiguity and @option{--} can be omitted.
address@hidden exit status @subentry of @command{gawk} @subentry on VMS
address@hidden exit status, of @command{gawk} @subentry on VMS
The @code{exit} value is a Unix-style value and is encoded into a VMS exit
status value when the program exits.
@@ -41266,7 +41277,7 @@ of @env{AWKPATH} is a comma-separated list of directory
specifications.
When defining it, the value should be quoted so that it retains a single
translation and not a multitranslation @code{RMS} searchlist.
address@hidden redirection on VMS
address@hidden redirection @subentry on VMS
This restriction also applies to running @command{gawk} under GNV,
as redirection is always to a DCL command.
@@ -41828,7 +41839,7 @@ implementations. Many are POSIX-compliant; others are
less so.
@node Notes
@appendix Implementation Notes
@cindex @command{gawk} @subentry implementation issues
address@hidden implementation issues @subentry @command{gawk}
address@hidden implementation issues, @command{gawk}
This appendix contains information mainly of interest to implementers and
maintainers of @command{gawk}. Everything in it applies specifically to
@@ -41849,7 +41860,7 @@ maintainers of @command{gawk}. Everything in it
applies specifically to
@cindex @command{gawk} @subentry implementation issues @subentry downward
compatibility
@cindex @command{gawk} @subentry implementation issues @subentry debugging
@cindex troubleshooting @subentry @command{gawk}
address@hidden implementation issues @subentry @command{gawk} @subentry
debugging
address@hidden implementation issues, @command{gawk} @subentry debugging
@xref{POSIX/GNU},
for a summary of the GNU extensions to the @command{awk} language and program.
@@ -43522,8 +43533,6 @@ The @command{gawk} extension API provides constructor
functions
The GNU implementation of @command{awk}.
@cindex GPL (General Public License)
address@hidden General Public License (GPL)
address@hidden GNU General Public License
@item General Public License
This document describes the terms under which @command{gawk} and its source
code may be distributed. (@xref{Copying}.)
@@ -43917,7 +43926,6 @@ and POSIX systems. Used for the @command{gawk}
functions
@code{mktime()}, @code{strftime()}, and @code{systime()}.
See also ``Epoch,'' ``GMT,'' and ``UTC.''
address@hidden Linux
@cindex GNU/Linux
@cindex Unix
@cindex BSD-based operating systems
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index e2c2e47..153f632 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -1937,6 +1937,7 @@ Emacs editor. GNU Emacs is the most widely used version
of Emacs today.
@cindex GNU Project
@cindex GPL (General Public License)
address@hidden GNU General Public License @seeentry{GPL}
@cindex General Public License @seeentry{GPL}
@cindex documentation @subentry online
The address@hidden stands for ``GNU's Not Unix.''}
@@ -1968,7 +1969,7 @@ freely available. The GNU operating
system kernel (the HURD), has been released but remains in an early
stage of development.
address@hidden Linux
address@hidden Linux @seeentry{GNU/Linux}
@cindex GNU/Linux
@cindex operating systems @subentry BSD-based
Until the GNU operating system is more fully developed, you should
@@ -3957,7 +3958,7 @@ with @samp{#!} scripts (@pxref{Executable Scripts}), like
so:
@itemx @option{--gen-pot}
@cindex @option{-g} option
@cindex @option{--gen-pot} option
address@hidden portable object files @subentry generating
address@hidden portable object @subentry files @subentry generating
@cindex files @subentry portable object @subentry generating
Analyze the source program and
generate a GNU @command{gettext} portable object template file on standard
@@ -4203,7 +4204,7 @@ Warn about constructs that are not available in the
original version of
@itemx @option{--version}
@cindex @option{-V} option
@cindex @option{--version} option
address@hidden @command{gawk} @subentry versions of, printing information about
address@hidden @command{gawk} @subentry version of @subentry printing
information about
Print version information for this particular copy of @command{gawk}.
This allows you to determine if your copy of @command{gawk} is up to date
with respect to whatever the Free Software Foundation is currently
@@ -4654,7 +4655,7 @@ calls from the GNU C library to help track down possible
memory leaks.
@node Exit Status
@section @command{gawk}'s Exit Status
address@hidden exit status @subentry of @command{gawk}
address@hidden exit status, of @command{gawk}
If the @code{exit} statement is used with a value
(@pxref{Exit Statement}), then @command{gawk} exits with
the numeric value given to it.
@@ -5171,6 +5172,7 @@ a @dfn{regexp constant}, much like @code{5.27} is a
numeric constant and
@section Escape Sequences
@cindex escape sequences
address@hidden escape sequences @seealso{backslash}
@cindex backslash (@code{\}) @subentry in escape sequences
@cindex @code{\} (backslash) @subentry in escape sequences
Some characters cannot be included literally in string constants
@@ -5346,6 +5348,7 @@ two backslashes in the string: @samp{FS = @w{"[ \t]+\\|[
\t]+"}}.)
@c I did this! This is why I added the warning.
@cindex @command{gawk} @subentry escape sequences
address@hidden @command{gawk} @subentry escape sequences @seealso{backslash}
@cindex Unix @command{awk} @subentry backslashes in escape sequences
@cindex @command{mawk} utility
@item Leave the backslash alone
@@ -5375,7 +5378,7 @@ literally.
@end itemize
@sidebar Escape Sequences for Metacharacters
address@hidden metacharacters, escape sequences for
address@hidden metacharacters @subentry escape sequences for
Suppose you use an octal or hexadecimal
escape to represent a regexp metacharacter.
@@ -5397,7 +5400,7 @@ escape sequences literally when used in regexp constants.
Thus,
@node Regexp Operators
@section Regular Expression Operators
@cindex regular expressions @subentry operators
address@hidden metacharacters in regular expressions
address@hidden metacharacters @subentry in regular expressions
You can combine regular expressions with special characters,
called @dfn{regular expression operators} or @dfn{metacharacters}, to
@@ -6892,7 +6895,7 @@ existing fields.
@cindex @code{OFS} variable
@cindex output field separator @address@hidden variable}
address@hidden field separators @address@hidden
address@hidden field separator @address@hidden
This recomputation affects and is affected by
@code{NF} (the number of fields; @pxref{Fields}).
For example, the value of @code{NF} is set to the number of the highest
@@ -7026,7 +7029,7 @@ with a statement such as @samp{$1 = $1}, as described
earlier.
@cindex @code{FS} variable
@cindex fields @subentry separating
address@hidden field separators
address@hidden field separator
@cindex fields @subentry separating
The @dfn{field separator}, which is either a single character or a regular
expression, controls the way @command{awk} splits an input record into fields.
@@ -7079,9 +7082,9 @@ John Q. Smith, 29 Oak St., Walamazoo, MI 42139
this @command{awk} program extracts and prints the string
@address@hidden@address@hidden
address@hidden field separators @subentry choice of
address@hidden field separator @subentry choice of
@cindex regular expressions @subentry as field separators
address@hidden field separators @subentry regular expressions as
address@hidden field separator @subentry regular expression as
Sometimes the input data contains separator characters that don't
separate fields the way you thought they would. For instance, the
person's name in the example we just used might have a title or
@@ -7104,8 +7107,10 @@ can massage it first with a separate @command{awk}
program.)
@node Default Field Splitting
@subsection Whitespace Normally Separates Fields
address@hidden field separators @subentry whitespace as
address@hidden field separator @subentry whitespace as
@cindex whitespace @subentry as field separators
address@hidden field separator @subentry @code{FS} variable and
address@hidden separators @subentry field @subentry @code{FS} variable and
Fields are normally separated by whitespace sequences
(spaces, TABs, and newlines), not by single spaces. Two spaces in a row do not
delimit an empty field. The default value of the field separator @code{FS}
@@ -7127,7 +7132,7 @@ rules.
@subsection Using Regular Expressions to Separate Fields
@cindex regular expressions @subentry as field separators
address@hidden field separators @subentry regular expressions as
address@hidden field separator @subentry regular expression as
The previous @value{SUBSECTION}
discussed the use of single characters or simple strings as the
value of @code{FS}.
@@ -7257,7 +7262,7 @@ $ @kbd{echo a b | gawk 'BEGIN @{ FS = "" @}}
@end example
@cindex dark corner @subentry @code{FS} as null string
address@hidden @code{FS} variable @subentry as null string
address@hidden @code{FS} variable @subentry null string as
Traditionally, the behavior of @code{FS} equal to @code{""} was not defined.
In this case, most versions of Unix @command{awk} simply treat the entire
record
as only having one field.
@@ -8256,7 +8261,7 @@ the value of @code{NF} do not change.
@cindex @code{getline} command @subentry from a file
@cindex input redirection
address@hidden redirection of input
address@hidden redirection @subentry of input
@cindex @code{<} (left angle bracket) @subentry @code{<} operator (I/O)
@cindex left angle bracket (@code{<}) @subentry @code{<} operator (I/O)
@cindex operators @subentry input/output
@@ -8554,7 +8559,7 @@ program and start testing the new record against every
pattern.
However, the new record is tested against any subsequent rules.
@cindex differences in @command{awk} and @command{gawk} @subentry
implementation limitations
address@hidden implementation issues @subentry @command{gawk} @subentry limits
address@hidden implementation issues, @command{gawk} @subentry limits
@cindex @command{awk} @subentry implementations @subentry limits
@cindex @command{gawk} @subentry implementation issues @subentry limits
@item
@@ -8990,7 +8995,7 @@ expression. Numeric values are converted to strings and
then printed.
@cindex records @subentry printing
@cindex lines @subentry blank, printing
address@hidden text @subentry printing
address@hidden text, printing
The simple statement @samp{print} with no items is equivalent to
@samp{print $0}: it prints the entire current record. To print a blank
line, use @samp{print ""}.
@@ -9479,7 +9484,7 @@ which they may appear:
@cindex differences in @command{awk} and @command{gawk} @subentry
@code{print}/@code{printf} statements
@cindex @code{printf} statement @subentry positional specifiers
@c the code{} does NOT start a secondary
address@hidden positional specifiers @subentry @code{printf} statement
address@hidden positional specifiers, @code{printf} statement
@item @address@hidden
An integer constant followed by a @samp{$} is a @dfn{positional specifier}.
Normally, format specifications are applied to arguments in the order
@@ -9755,7 +9760,7 @@ awk 'BEGIN @{ format = "%-10s %s\n"
@section Redirecting Output of @code{print} and @code{printf}
@cindex output redirection
address@hidden redirection of output
address@hidden redirection @subentry of output
@cindex @option{--sandbox} option @subentry output redirection with
@code{print} @subentry @code{printf}
So far, the output from @code{print} and @code{printf} has gone
to the standard
@@ -9936,7 +9941,7 @@ for the same file is definitely poor style, and is
confusing to readers
of your program.)
@cindex differences in @command{awk} and @command{gawk} @subentry
implementation limitations
address@hidden implementation issues @subentry @command{gawk} @subentry limits
address@hidden implementation issues, @command{gawk} @subentry limits
@cindex @command{awk} @subentry implementation issues @subentry pipes
@cindex @command{gawk} @subentry implementation issues @subentry pipes
@ifnotinfo
@@ -12085,7 +12090,7 @@ the string constant @code{"0"} is actually true,
because it is non-null.
@cindex comparison expressions
@cindex expressions @subentry comparison
@cindex expressions, matching @seeentry{comparison expressions}
address@hidden matching, expressions @seeentry{comparison expressions}
address@hidden matching @subentry expressions @seeentry{comparison expressions}
@cindex relational operators @seeentry{comparison operators}
@cindex operators, relational @seeentry{operators, comparison}
@cindex variables @subentry types of @subentry comparison expressions and
@@ -14751,7 +14756,7 @@ Its default value is @code{"%.6g"}.
@cindex @command{gawk} @subentry @code{FIELDWIDTHS} variable in
@cindex @code{FIELDWIDTHS} variable
@cindex differences in @command{awk} and @command{gawk} @subentry
@code{FIELDWIDTHS} variable
address@hidden field separators @subentry @code{FIELDWIDTHS} variable and
address@hidden field separator @subentry @code{FIELDWIDTHS} variable and
@cindex separators @subentry field @subentry @code{FIELDWIDTHS} variable and
@item FIELDWIDTHS #
A space-separated list of columns that tells @command{gawk}
@@ -14766,7 +14771,7 @@ overrides the use of @code{FS} and @code{FPAT} for
field splitting.
@cindex @command{gawk} @subentry @code{FPAT} variable in
@cindex @code{FPAT} variable
@cindex differences in @command{awk} and @command{gawk} @subentry @code{FPAT}
variable
address@hidden field separators @subentry @code{FPAT} variable and
address@hidden field separator @subentry @code{FPAT} variable and
@cindex separators @subentry field @subentry @code{FPAT} variable and
@item FPAT #
A regular expression (as a string) that tells @command{gawk}
@@ -14777,7 +14782,7 @@ overrides the use of @code{FS} and @code{FIELDWIDTHS}
for field splitting.
@cindex @code{FS} variable
@cindex separators @subentry field
address@hidden field separators
address@hidden field separator
@item FS
The input field separator (@pxref{Field Separators}).
The value is a single-character string or a multicharacter regular
@@ -14868,7 +14873,7 @@ strings in general expressions; this is now done by
@code{CONVFMT}.
@cindex @code{print} statement @subentry @code{OFMT} variable and
@cindex @code{OFS} variable
@cindex separators @subentry field
address@hidden field separators
address@hidden field separator
@item OFS
The output field separator (@pxref{Output Separators}). It is
output between the fields printed by a @code{print} statement. Its
@@ -15264,7 +15269,7 @@ The value of the @code{getuid()} system call.
@item PROCINFO["version"]
@cindex version of @subentry @command{gawk}
address@hidden @command{gawk} version
address@hidden @command{gawk} @subentry version of
The version of @command{gawk}.
@end table
@@ -16532,7 +16537,7 @@ string value from @code{xyz}---this time
@code{"12.15"}---because the value of
@code{CONVFMT} only allows two significant digits. This test fails,
because @code{"12.15"} is different from @code{"12.153"}.
address@hidden converting integer array subscripts
address@hidden converting @subentry integer array subscripts to strings
@cindex integer array indices
According to the rules for conversions
(@pxref{Conversion}), integer
@@ -16627,7 +16632,7 @@ on the command line (@pxref{Options}).
@node Delete
@section The @code{delete} Statement
@cindex @code{delete} statement
address@hidden deleting elements in arrays
address@hidden deleting @subentry elements in arrays
@cindex arrays @subentry elements @subentry deleting
@cindex elements in arrays @subentry deleting
@@ -16683,7 +16688,7 @@ is not in the array is deleted.
@cindex common extensions @subentry @code{delete} to delete entire arrays
@cindex extensions @subentry common @subentry @code{delete} to delete entire
arrays
@cindex arrays @subentry deleting entire contents
address@hidden deleting entire arrays
address@hidden deleting @subentry entire arrays
@cindex @code{delete} @var{array}
@cindex differences in @command{awk} and @command{gawk} @subentry array
elements, deleting
All the elements of an array may be deleted with a single statement
@@ -17694,7 +17699,7 @@ If @option{--posix} is supplied, using an array
argument is a fatal error
@item @code{match(@var{string}, @var{regexp}} address@hidden, @address@hidden)}
@cindexawkfunc{match}
address@hidden string @subentry regular expression match
address@hidden string @subentry regular expression match of
@cindex match regexp in string
Search @var{string} for the
longest, leftmost substring matched by the regular expression
@@ -17942,7 +17947,7 @@ pival = sprintf("pi = %.2f (approx.)", 22/7)
assigns the string @address@hidden = 3.14 (approx.)}} to the variable
@code{pival}.
@cindexgawkfunc{strtonum}
address@hidden converting @subentry string to number
address@hidden converting @subentry string to numbers
@item @code{strtonum(@var{str}) #}
Examine @var{str} and return its numeric value. If @var{str}
begins with a leading @samp{0}, @code{strtonum()} assumes that @var{str}
@@ -19592,7 +19597,7 @@ Optional parameters are enclosed in square brackets ([
]):
@table @asis
@cindexgawkfunc{bindtextdomain}
address@hidden set @subentry directory of message catalogs
address@hidden set directory of message catalogs
@item @code{bindtextdomain(@var{directory}} address@hidden,} @address@hidden)}
Set the directory in which
@command{gawk} will look for message translation files, in case they
@@ -19674,7 +19679,7 @@ The definition of a function named @var{name} looks
like this:
@cindex names @subentry functions
@cindex functions @subentry names of
address@hidden namespace issues @subentry functions
address@hidden naming issues @subentry functions
@noindent
Here, @var{name} is the name of the function to define. A valid function
name is like a valid variable name: a sequence of letters, digits, and
@@ -19955,7 +19960,7 @@ an error.
@node Variable Scope
@subsubsection Controlling Variable Scope
address@hidden local variables, in a function
address@hidden local variables @subentry in a function
@cindex variables @subentry local to a function
Unlike in many languages,
there is no way to make a variable local to a @address@hidden @dots{}
@address@hidden block in
@@ -20959,7 +20964,7 @@ comparisons use only lowercase letters.
@cindex names @subentry arrays/variables
@cindex names @subentry functions
address@hidden namespace issues
address@hidden naming issues
@cindex @command{awk} programs @subentry documenting
@cindex documentation @subentry of @command{awk} programs
Due to the way the @command{awk} language evolved, variables are either
@@ -22633,7 +22638,7 @@ use @code{getopt()} to process their arguments.
@node Passwd Functions
@section Reading the User Database
address@hidden libraries of @command{awk} functions @subentry user database
@subentry reading
address@hidden libraries of @command{awk} functions @subentry user database,
reading
@cindex functions @subentry library @subentry user database, reading
@cindex user database, reading
@cindex database @subentry users, reading
@@ -22653,7 +22658,7 @@ for a similar suite that retrieves information from the
group database.
@cindex C library functions @subentry @code{getpwent()}
@cindex @code{getpwent()} user-defined function
@cindex user-defined @subentry function @subentry @code{getpwent()}
address@hidden users @subentry information about @subentry retrieving
address@hidden users, information about @subentry retrieving
@cindex login information
@cindex account information
@cindex password file
@@ -22997,7 +23002,7 @@ uses these functions.
@node Group Functions
@section Reading the Group Database
address@hidden libraries of @command{awk} functions @subentry group database
@subentry reading
address@hidden libraries of @command{awk} functions @subentry group database,
reading
@cindex functions @subentry library @subentry group database, reading
@cindex group database, reading
@cindex database @subentry group, reading
@@ -23832,7 +23837,7 @@ BEGIN @{
@c endfile
@end example
address@hidden field separators @subentry spaces as
address@hidden field separator @subentry spaces as
The code must take
special care when the field delimiter is a space. Using
a single space (@address@hidden" "}}) for the value of @code{FS} is
@@ -24301,7 +24306,7 @@ function usage()
@subsection Printing Out User Information
@cindex printing @subentry user information
address@hidden users @subentry information about @subentry printing
address@hidden users, information about @subentry printing
@cindex @command{id} utility
The @command{id} utility lists a user's real and effective user ID numbers,
real and effective group ID numbers, and the user's group set, if any.
@@ -24708,7 +24713,7 @@ END @{
@c FIXME: One day, update to current POSIX version of uniq
@cindex printing @subentry unduplicated lines of text
address@hidden text @subentry printing @subentry unduplicated lines of
address@hidden text, printing @subentry unduplicated lines of
@cindex @command{uniq} utility
The @command{uniq} utility reads sorted lines of data on its standard
input, and by default removes duplicate lines. In other words, it only
@@ -28355,7 +28360,7 @@ is a count showing how many times the condition was
true.
The count for the @code{else}
indicates how many times the test failed.
address@hidden loops, count for header, in a profile
address@hidden loops @subentry count for header, in a profile
@item
The count for a loop header (such as @code{for}
or @code{while}) shows how many times the loop test was executed.
@@ -28685,7 +28690,7 @@ by calling the @code{textdomain()} function.
@cindex @code{.pot} files
@cindex files @subentry @code{.pot}
@cindex portable object @subentry template files
address@hidden files @subentry portable object template
address@hidden files @subentry portable object @subentry template file
(@file{.pot})
@item
Messages from the application are extracted from the source code and
collected into a portable object template file (@file{guide.pot}),
@@ -28696,7 +28701,7 @@ lookup of the translations.
@cindex @code{.po} files
@cindex files @subentry @code{.po}
address@hidden portable object files
address@hidden portable object @subentry files
@cindex files @subentry portable object
@item
For each language with a translator, @file{guide.pot}
@@ -29040,7 +29045,7 @@ and use translations from @command{awk}.
@cindex @code{.po} files
@cindex files @subentry @code{.po}
address@hidden portable object files
address@hidden portable object @subentry files
@cindex files @subentry portable object
Once a program's translatable strings have been marked, they must
be extracted to create the initial @file{.pot} file.
@@ -29099,7 +29104,7 @@ translations for @command{guide}.
@subsection Rearranging @code{printf} Arguments
@cindex @code{printf} statement @subentry positional specifiers
address@hidden positional specifiers @subentry @code{printf} statement
address@hidden positional specifiers, @code{printf} statement
Format strings for @code{printf} and @code{sprintf()}
(@pxref{Printf})
present a special problem for translation.
@@ -29167,7 +29172,7 @@ This is somewhat counterintuitive.
@end quotation
@cindex @code{printf} statement @subentry positional specifiers @subentry
mixing with regular formats
address@hidden positional specifiers @subentry @code{printf} statement
@subentry mixing with regular formats
address@hidden positional specifiers, @code{printf} statement @subentry mixing
with regular formats
@cindex format specifiers @subentry mixing regular with positional specifiers
@command{gawk} does not allow you to mix regular format specifiers
and those with positional specifiers in the same string:
@@ -29351,7 +29356,6 @@ msgstr "Like, the scoop is"
@c endfile
@end example
address@hidden Linux
@cindex GNU/Linux
@quotation NOTE
The following instructions apply to GNU/Linux with the GNU C Library. Be
@@ -29396,7 +29400,7 @@ $ @kbd{mkdir en_US.UTF-8 en_US.UTF-8/LC_MESSAGES}
@cindex files @subentry @code{.po} @subentry converting to @code{.mo}
@cindex @code{.mo} files, converting from @code{.po}
@cindex files @subentry @code{.mo}, converting from @code{.po}
address@hidden portable object files @subentry converting to message object
files
address@hidden portable object @subentry files @subentry converting to message
object files
@cindex files @subentry portable object @subentry converting to message object
files
@cindex message object files @subentry converting from portable object files
@cindex files @subentry message object @subentry converting from portable
object files
@@ -30026,7 +30030,7 @@ controlling breakpoints are:
@cindex debugger @subentry commands @subentry @code{break}
@cindex @code{break} debugger command
@cindex @code{b} debugger command (alias for @code{break})
address@hidden set @subentry breakpoint
address@hidden set breakpoint
@cindex breakpoint @subentry setting
@item @code{break} address@hidden@code{:address@hidden | @var{function}]
address@hidden"@var{expression}"}]
@itemx @code{b} address@hidden@code{:address@hidden | @var{function}]
address@hidden"@var{expression}"}]
@@ -30383,7 +30387,7 @@ You can also set special @command{awk} variables, such
as @code{FS},
@cindex debugger @subentry commands @subentry @code{watch}
@cindex @code{watch} debugger command
@cindex @code{w} debugger command (alias for @code{watch})
address@hidden set @subentry watchpoint
address@hidden set watchpoint
@item @code{watch} @var{var} | @address@hidden
address@hidden"@var{expression}"}]
@itemx @code{w} @var{var} | @address@hidden address@hidden"@var{expression}"}]
Add variable @var{var} (or field @address@hidden) to the watch list.
@@ -30495,7 +30499,7 @@ List arguments of the selected frame.
@item break
@cindex show in debugger @subentry breakpoints
address@hidden breakpoint, show all in debugger
address@hidden breakpoint @subentry show all in debugger
List all currently set breakpoints.
@item display
@@ -30514,7 +30518,7 @@ line numbers.
@item locals
@cindex show in debugger @subentry local variables
address@hidden local variables, show in debugger
address@hidden local variables @subentry show in debugger
List local variables of the selected frame.
@item source
@@ -31143,7 +31147,7 @@ of @code{BEGIN}, @code{BEGINFILE}, @code{END}, and
@code{ENDFILE} rules.
@section Namespace and Component Naming Rules
@cindex naming rules, namespace and component names
address@hidden namespace names, naming rules
address@hidden namespaces @subentry naming rules
@c not "component names" to merge with other index entry
@cindex component name @subentry naming rules
A number of rules apply to the namespace and component names, as follows.
@@ -35393,7 +35397,7 @@ information about how @command{gawk} was invoked.
@node Extension Versioning
@subsubsection API Version Constants and Variables
@cindex API @subentry version
address@hidden extension API @subentry version
address@hidden extension API @subentry version number
The API provides both a ``major'' and a ``minor'' version number.
The API versions are available at compile time as C preprocessor defines
@@ -39596,26 +39600,32 @@ on other platforms, the appropriate location may be
different.
@table @command
@cindex @command{gawkpath_default} shell function
address@hidden shell function @subentry @command{gawkpath_default}
@item gawkpath_default
Reset the @env{AWKPATH} environment variable to its default value.
@cindex @command{gawkpath_prepend} shell function
address@hidden shell function @subentry @command{gawkpath_prepend}
@item gawkpath_prepend
Add the argument to the front of the @env{AWKPATH} environment variable.
@cindex @command{gawkpath_append} shell function
address@hidden shell function @subentry @command{gawkpath_append}
@item gawkpath_append
Add the argument to the end of the @env{AWKPATH} environment variable.
@cindex @command{gawklibpath_default} shell function
address@hidden shell function @subentry @command{gawklibpath_default}
@item gawklibpath_default
Reset the @env{AWKLIBPATH} environment variable to its default value.
@cindex @command{gawklibpath_prepend} shell function
address@hidden shell function @subentry @command{gawklibpath_prepend}
@item gawklibpath_prepend
Add the argument to the front of the @env{AWKLIBPATH} environment variable.
@cindex @command{gawklibpath_append} shell function
address@hidden shell function @subentry @command{gawklibpath_append}
@item gawklibpath_append
Add the argument to the end of the @env{AWKLIBPATH} environment variable.
@@ -39774,7 +39784,7 @@ See also the @file{README_d/README.pc} file in the
distribution.
@node PC Binary Installation
@appendixsubsubsec Installing a Prepared Distribution for MS-Windows Systems
address@hidden installation @subentry MS-Windows
address@hidden installing @command{gawk} @subentry MS-Windows
The only supported binary distribution for MS-Windows systems
is that provided by Eli Zaretskii's
@uref{https://sourceforge.net/projects/ezwinports/,
@@ -39948,7 +39958,7 @@ When compared to GNU/Linux on the same system, the
@samp{configure}
step on Cygwin takes considerably longer. However, it does finish,
and then the @samp{make} proceeds as usual.
address@hidden installation @subentry Cygwin
address@hidden installing @command{gawk} @subentry Cygwin
You may also install @command{gawk} using the regular Cygwin installer.
In general Cygwin supplies the latest released version.
@@ -39980,7 +39990,7 @@ translation of @code{"\r\n"}, because it won't.
@c now address@hidden
@cindex @command{gawk} @subentry VMS version of
address@hidden installation @subentry VMS
address@hidden installing @command{gawk} @subentry VMS
This @value{SUBSECTION} describes how to compile and install @command{gawk}
under VMS.
The older designation ``VMS'' is used throughout to refer to OpenVMS.
@@ -40194,7 +40204,7 @@ flag is required to force Unix-style parsing rather
than @code{DCL} parsing.
If any other dash-type options (or multiple parameters such as @value{DF}s to
process) are present, there is no ambiguity and @option{--} can be omitted.
address@hidden exit status @subentry of @command{gawk} @subentry on VMS
address@hidden exit status, of @command{gawk} @subentry on VMS
The @code{exit} value is a Unix-style value and is encoded into a VMS exit
status value when the program exits.
@@ -40238,7 +40248,7 @@ of @env{AWKPATH} is a comma-separated list of directory
specifications.
When defining it, the value should be quoted so that it retains a single
translation and not a multitranslation @code{RMS} searchlist.
address@hidden redirection on VMS
address@hidden redirection @subentry on VMS
This restriction also applies to running @command{gawk} under GNV,
as redirection is always to a DCL command.
@@ -40800,7 +40810,7 @@ implementations. Many are POSIX-compliant; others are
less so.
@node Notes
@appendix Implementation Notes
@cindex @command{gawk} @subentry implementation issues
address@hidden implementation issues @subentry @command{gawk}
address@hidden implementation issues, @command{gawk}
This appendix contains information mainly of interest to implementers and
maintainers of @command{gawk}. Everything in it applies specifically to
@@ -40821,7 +40831,7 @@ maintainers of @command{gawk}. Everything in it
applies specifically to
@cindex @command{gawk} @subentry implementation issues @subentry downward
compatibility
@cindex @command{gawk} @subentry implementation issues @subentry debugging
@cindex troubleshooting @subentry @command{gawk}
address@hidden implementation issues @subentry @command{gawk} @subentry
debugging
address@hidden implementation issues, @command{gawk} @subentry debugging
@xref{POSIX/GNU},
for a summary of the GNU extensions to the @command{awk} language and program.
@@ -42494,8 +42504,6 @@ The @command{gawk} extension API provides constructor
functions
The GNU implementation of @command{awk}.
@cindex GPL (General Public License)
address@hidden General Public License (GPL)
address@hidden GNU General Public License
@item General Public License
This document describes the terms under which @command{gawk} and its source
code may be distributed. (@xref{Copying}.)
@@ -42889,7 +42897,6 @@ and POSIX systems. Used for the @command{gawk}
functions
@code{mktime()}, @code{strftime()}, and @code{systime()}.
See also ``Epoch,'' ``GMT,'' and ``UTC.''
address@hidden Linux
@cindex GNU/Linux
@cindex Unix
@cindex BSD-based operating systems
-----------------------------------------------------------------------
Summary of changes:
doc/gawk.texi | 138 ++++++++++++++++++++++++++++++--------------------------
doc/gawktexi.in | 135 ++++++++++++++++++++++++++++--------------------------
2 files changed, 144 insertions(+), 129 deletions(-)
hooks/post-receive
--
gawk
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [gawk-diffs] [SCM] gawk branch, feature/better-index, updated. gawk-4.1.0-3756-g1a4ad4a,
Arnold Robbins <=