[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-3752-g473d5d5 |
|
Date: |
Sun, 28 Apr 2019 12:48:22 -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 473d5d54f209e5a436a97b7f97b8f7c48048edc9 (commit)
from 34f5c17223396cae9585826bdd8d8ed9cc70198f (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=473d5d54f209e5a436a97b7f97b8f7c48048edc9
commit 473d5d54f209e5a436a97b7f97b8f7c48048edc9
Author: Arnold D. Robbins <address@hidden>
Date: Sun Apr 28 19:48:10 2019 +0300
More indexing updates.
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 3a3fc0a..a671d32 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -5825,7 +5825,7 @@ when in compatibility mode (@pxref{Options}).
@cindex bracket expressions
@cindex bracket expressions @subentry range expressions
@cindex range expressions (regexps)
address@hidden character lists in regular expressions
address@hidden bracket expressions @subentry character lists
As mentioned earlier, a bracket expression matches any character among
those listed between the opening and closing square brackets.
@@ -9147,6 +9147,8 @@ worth of data the first time. Because of this, changing
the value
of timeout like in the preceding example is not very useful.
@end quotation
address@hidden @env{GAWK_READ_TIMEOUT} environment variable
address@hidden environment variables @subentry @env{GAWK_READ_TIMEOUT}
If the @code{PROCINFO} element is not present and the
@env{GAWK_READ_TIMEOUT} environment variable exists,
@command{gawk} uses its value to initialize the timeout value.
@@ -10987,6 +10989,8 @@ For standard output, you may use @code{PROCINFO["-",
"NONFATAL"]}
or @code{PROCINFO["/dev/stdout", "NONFATAL"]}. For standard error, use
@code{PROCINFO["/dev/stderr", "NONFATAL"]}.
address@hidden @env{GAWK_SOCK_RETRIES} environment variable
address@hidden environment variables @subentry @env{GAWK_SOCK_RETRIES}
When attempting to open a TCP/IP socket (@pxref{TCP/IP Networking}),
@command{gawk} tries multiple times. The @env{GAWK_SOCK_RETRIES}
environment variable (@pxref{Other Environment Variables}) allows you to
@@ -11737,7 +11741,7 @@ this @value{SECTION} discusses this important facet of
@command{awk}.
@node Strings And Numbers
@subsubsection How @command{awk} Converts Between Strings and Numbers
address@hidden converting @subentry strings to numbers
address@hidden converting @subentry string to numbers
@cindex strings @subentry converting
@cindex numbers @subentry converting
@cindex converting @subentry numbers to strings
@@ -20285,7 +20289,7 @@ $ @kbd{gawk -f testbits.awk}
@print{} rshift(0x99, 2) = 0x26 = 00100110
@end example
address@hidden converting @subentry strings to numbers
address@hidden converting @subentry string to numbers
@cindex strings @subentry converting
@cindex numbers @subentry converting
@cindex converting @subentry numbers to strings
@@ -28853,7 +28857,7 @@ remain more difficult to use than two-way pipes.} @c
8/2014
@cindex input/output @subentry two-way
@cindex @code{|} (vertical bar) @subentry @code{|&} operator (I/O)
@cindex vertical bar (@code{|}) @subentry @code{|&} operator (I/O)
address@hidden @command{csh} utility @subentry @code{|&} operator @subentry
comparison with
address@hidden @command{csh} utility @subentry @code{|&} operator, comparison
with
However, with @command{gawk}, it is possible to
open a @emph{two-way} pipe to another process. The second process is
termed a @dfn{coprocess}, as it runs in parallel with @command{gawk}.
@@ -29840,6 +29844,8 @@ look to see if @env{LANGUAGE} is defined, and if so,
use the shell's
@command{unset} command to remove it.
@end quotation
address@hidden @env{GAWK_LOCALE_DIR} environment variable
address@hidden environment variables @subentry @env{GAWK_LOCALE_DIR}
For testing translations of @command{gawk} itself, you can set
the @env{GAWK_LOCALE_DIR} environment variable. See the documentation
for the C @code{bindtextdomain()} function and also see
@@ -30348,6 +30354,14 @@ file and then to create the @file{guide.mo} file.
The directory has the form @address@hidden/LC_MESSAGES}, where
@var{locale} is a locale name known to the C @command{gettext} routines.
address@hidden @env{LANGUAGE} environment variable
address@hidden environment variables @subentry @env{LANGUAGE}
address@hidden @env{LC_ALL} environment variable
address@hidden environment variables @subentry @env{LC_ALL}
address@hidden @env{LANG} environment variable
address@hidden environment variables @subentry @env{LANG}
address@hidden @env{LC_MESSAGES} environment variable
address@hidden environment variables @subentry @env{LC_MESSAGES}
How do we know which locale to use? It turns out that there are
four different environment variables used by the C @command{gettext} routines.
In order, they are @env{$LANGUAGE}, @env{$LC_ALL}, @env{$LANG}, and
@@ -30519,7 +30533,7 @@ In that case, what can you expect from such a tool?
The answer to that
depends on the language being debugged, but in general, you can expect at
least the following:
address@hidden debugger capabilities
address@hidden debugger @subentry capabilities
@itemize @value{BULLET}
@item
The ability to watch a program execute its instructions one by one,
@@ -30582,7 +30596,7 @@ invoked. Commands that print the call stack print
information about
each stack frame (as detailed later on).
@item Breakpoint
address@hidden breakpoint (debugger)
address@hidden breakpoint
During debugging, you often wish to let the program run until it
reaches a certain point, and then continue execution from there one
statement (or instruction) at a time. The way to do this is to set
@@ -30717,9 +30731,9 @@ a breakpoint in @file{uniq.awk} is at the beginning of
the function
the breakpoint, use the @code{b} (breakpoint) command:
@cindex debugger @subentry setting a breakpoint
address@hidden debugger @subentry @code{breakpoint} command
address@hidden debugger @subentry @code{break} command
address@hidden debugger @subentry @code{b} command
address@hidden debugger @subentry commands @subentry @code{breakpoint}
address@hidden debugger @subentry commands @subentry @code{break}
address@hidden debugger @subentry commands @subentry @code{b} (@code{break})
@example
gawk> @kbd{b are_equal}
@print{} Breakpoint 1 set at file `awklib/eg/prog/uniq.awk', line 63
@@ -30730,7 +30744,7 @@ Now type @samp{r} or @samp{run} and the program runs
until it hits
the breakpoint for the first time:
@cindex debugger @subentry running the program
address@hidden debugger @subentry @code{run} command
address@hidden debugger @subentry commands @subentry @code{run}
@example
gawk> @kbd{r}
@print{} Starting program:
@@ -30747,8 +30761,8 @@ let's see how we got to where we are. At the prompt,
we type @samp{bt}
listing of the current stack frames:
@cindex debugger @subentry stack frames, showing
address@hidden debugger @subentry @code{bt} command
address@hidden debugger @subentry @code{backtrace} command
address@hidden debugger @subentry commands @subentry @code{bt}
(@code{backtrace})
address@hidden debugger @subentry commands @subentry @code{backtrace}
@example
gawk> @kbd{bt}
@print{} #0 are_equal(n, m, clast, cline, alast, aline)
@@ -30768,8 +30782,8 @@ of some variables. Let's say we type @samp{p n}
@code{n}, a parameter to @code{are_equal()}. Actually, the debugger
gives us:
address@hidden debugger @subentry @code{print} command
address@hidden debugger @subentry @code{p} command
address@hidden debugger @subentry commands @subentry @code{print}
address@hidden debugger @subentry commands @subentry @code{p} (@code{print})
@example
gawk> @kbd{p n}
@print{} n = untyped variable
@@ -30820,8 +30834,8 @@ be inside this function. To investigate further, we
must begin
``stepping through'' the lines of @code{are_equal()}. We start by typing
@samp{n} (for ``next''):
address@hidden debugger @subentry @code{n} command
address@hidden debugger @subentry @code{next} command
address@hidden debugger @subentry commands @subentry @code{n} (@code{next})
address@hidden debugger @subentry commands @subentry @code{next}
@example
@group
gawk> @kbd{n}
@@ -30997,8 +31011,8 @@ will otherwise just run as if it was not under the
debugger. The commands for
controlling breakpoints are:
@table @asis
address@hidden debugger commands @subentry @code{b} (@code{break})
address@hidden debugger commands @subentry @code{break}
address@hidden debugger @subentry commands @subentry @code{b} (@code{break})
address@hidden debugger @subentry commands @subentry @code{break}
@cindex @code{break} debugger command
@cindex @code{b} debugger command (alias for @code{break})
@cindex set @subentry breakpoint
@@ -31032,7 +31046,7 @@ evaluates whenever the breakpoint is reached. If the
condition is true,
then the debugger stops execution and prompts for a command. Otherwise,
it continues executing the program.
address@hidden debugger commands @subentry @code{clear}
address@hidden debugger @subentry commands @subentry @code{clear}
@cindex @code{clear} debugger command
@cindex delete breakpoint @subentry at location
@cindex breakpoint @subentry at location, how to delete
@@ -31054,7 +31068,7 @@ Delete breakpoint(s) set at line number @var{n} in
source file @var{filename}.
Delete breakpoint(s) set at entry to function @var{function}.
@end table
address@hidden debugger commands @subentry @code{condition}
address@hidden debugger @subentry commands @subentry @code{condition}
@cindex @code{condition} debugger command
@cindex breakpoint @subentry condition
@item @code{condition} @var{n} @code{"@var{expression}"}
@@ -31067,8 +31081,8 @@ the debugger continues executing the program. If the
condition expression is
not specified, any existing condition is removed (i.e., the breakpoint or
watchpoint is made unconditional).
address@hidden debugger commands @subentry @code{d} (@code{delete})
address@hidden debugger commands @subentry @code{delete}
address@hidden debugger @subentry commands @subentry @code{d} (@code{delete})
address@hidden debugger @subentry commands @subentry @code{delete}
@cindex @code{delete} debugger command
@cindex @code{d} debugger command (alias for @code{delete})
@cindex delete breakpoint @subentry by number
@@ -31078,7 +31092,7 @@ watchpoint is made unconditional).
Delete specified breakpoints or a range of breakpoints. Delete
all defined breakpoints if no argument is supplied.
address@hidden debugger commands @subentry @code{disable}
address@hidden debugger @subentry commands @subentry @code{disable}
@cindex @code{disable} debugger command
@cindex disable breakpoint
@cindex breakpoint @subentry how to disable or enable
@@ -31086,8 +31100,8 @@ all defined breakpoints if no argument is supplied.
Disable specified breakpoints or a range of breakpoints. Without
any argument, disable all breakpoints.
address@hidden debugger commands @subentry @code{e} (@code{enable})
address@hidden debugger commands @subentry @code{enable}
address@hidden debugger @subentry commands @subentry @code{e} (@code{enable})
address@hidden debugger @subentry commands @subentry @code{enable}
@cindex @code{enable} debugger command
@cindex @code{e} debugger command (alias for @code{enable})
@cindex enable breakpoint
@@ -31108,15 +31122,15 @@ Enable the breakpoints temporarily, then disable each
one when
the program stops at it.
@end table
address@hidden debugger commands @subentry @code{ignore}
address@hidden debugger @subentry commands @subentry @code{ignore}
@cindex @code{ignore} debugger command
@cindex ignore breakpoint
@item @code{ignore} @var{n} @var{count}
Ignore breakpoint number @var{n} the next @var{count} times it is
hit.
address@hidden debugger commands @subentry @code{t} (@code{tbreak})
address@hidden debugger commands @subentry @code{tbreak}
address@hidden debugger @subentry commands @subentry @code{t} (@code{tbreak})
address@hidden debugger @subentry commands @subentry @code{tbreak}
@cindex @code{tbreak} debugger command
@cindex @code{t} debugger command (alias for @code{tbreak})
@cindex temporary breakpoint
@@ -31134,11 +31148,11 @@ and observing its behavior. There are more commands
for controlling
execution of the program than we saw in our earlier example:
@table @asis
address@hidden debugger commands @subentry @code{commands}
address@hidden debugger @subentry commands @subentry @code{commands}
@cindex @code{commands} debugger command
address@hidden debugger commands @subentry @code{silent}
address@hidden debugger @subentry commands @subentry @code{silent}
@cindex @code{silent} debugger command
address@hidden debugger commands @subentry @code{end}
address@hidden debugger @subentry commands @subentry @code{end}
@cindex @code{end} debugger command
@cindex breakpoint @subentry commands to execute at
@cindex commands to execute at breakpoint
@@ -31167,8 +31181,8 @@ gawk> @kbd{commands}
gawk>
@end example
address@hidden debugger commands @subentry @code{c} (@code{continue})
address@hidden debugger commands @subentry @code{continue}
address@hidden debugger @subentry commands @subentry @code{c} (@code{continue})
address@hidden debugger @subentry commands @subentry @code{continue}
@cindex continue program, in debugger
@cindex @code{continue} debugger command
@item @code{continue} address@hidden
@@ -31177,14 +31191,14 @@ Resume program execution. If continued from a
breakpoint and @var{count} is
specified, ignore the breakpoint at that location the next @var{count} times
before stopping.
address@hidden debugger commands @subentry @code{finish}
address@hidden debugger @subentry commands @subentry @code{finish}
@cindex @code{finish} debugger command
@item @code{finish}
Execute until the selected stack frame returns.
Print the returned value.
address@hidden debugger commands @subentry @code{n} (@code{next})
address@hidden debugger commands @subentry @code{next}
address@hidden debugger @subentry commands @subentry @code{n} (@code{next})
address@hidden debugger @subentry commands @subentry @code{next}
@cindex @code{next} debugger command
@cindex @code{n} debugger command (alias for @code{next})
@cindex single-step execution, in the debugger
@@ -31194,15 +31208,15 @@ Continue execution to the next source line, stepping
over function calls.
The argument @var{count} controls how many times to repeat the action, as
in @code{step}.
address@hidden debugger commands @subentry @code{ni} (@code{nexti})
address@hidden debugger commands @subentry @code{nexti}
address@hidden debugger @subentry commands @subentry @code{ni} (@code{nexti})
address@hidden debugger @subentry commands @subentry @code{nexti}
@cindex @code{nexti} debugger command
@cindex @code{ni} debugger command (alias for @code{nexti})
@item @code{nexti} address@hidden
@itemx @code{ni} address@hidden
Execute one (or @var{count}) instruction(s), stepping over function calls.
address@hidden debugger commands @subentry @code{return}
address@hidden debugger @subentry commands @subentry @code{return}
@cindex @code{return} debugger command
@item @code{return} address@hidden
Cancel execution of a function call. If @var{value} (either a string or a
@@ -31211,8 +31225,8 @@ frame other than the innermost one (the currently
executing function; i.e.,
frame number 0), discard all inner frames in addition to the selected one,
and the caller of that frame becomes the innermost frame.
address@hidden debugger commands @subentry @code{r} (@code{run})
address@hidden debugger commands @subentry @code{run}
address@hidden debugger @subentry commands @subentry @code{r} (@code{run})
address@hidden debugger @subentry commands @subentry @code{run}
@cindex @code{run} debugger command
@cindex @code{r} debugger command (alias for @code{run})
@item @code{run}
@@ -31221,8 +31235,8 @@ Start/restart execution of the program. When
restarting, the debugger
retains the current breakpoints, watchpoints, command history,
automatic display variables, and debugger options.
address@hidden debugger commands @subentry @code{s} (@code{step})
address@hidden debugger commands @subentry @code{step}
address@hidden debugger @subentry commands @subentry @code{s} (@code{step})
address@hidden debugger @subentry commands @subentry @code{step}
@cindex @code{step} debugger command
@cindex @code{s} debugger command (alias for @code{step})
@item @code{step} address@hidden
@@ -31232,8 +31246,8 @@ current stack frame, stepping inside any function
called within
the line. If the argument @var{count} is supplied, steps that many times
before
stopping, unless it encounters a breakpoint or watchpoint.
address@hidden debugger commands @subentry @code{si} (@code{stepi})
address@hidden debugger commands @subentry @code{stepi}
address@hidden debugger @subentry commands @subentry @code{si} (@code{stepi})
address@hidden debugger @subentry commands @subentry @code{stepi}
@cindex @code{stepi} debugger command
@cindex @code{si} debugger command (alias for @code{stepi})
@item @code{stepi} address@hidden
@@ -31242,8 +31256,8 @@ Execute one (or @var{count}) instruction(s), stepping
inside function calls.
(For illustration of what is meant by an ``instruction'' in @command{gawk},
see the output shown under @code{dump} in @ref{Miscellaneous Debugger
Commands}.)
address@hidden debugger commands @subentry @code{u} (@code{until})
address@hidden debugger commands @subentry @code{until}
address@hidden debugger @subentry commands @subentry @code{u} (@code{until})
address@hidden debugger @subentry commands @subentry @code{until}
@cindex @code{until} debugger command
@cindex @code{u} debugger command (alias for @code{until})
@item @code{until} address@hidden@code{:address@hidden | @var{function}]
@@ -31260,7 +31274,7 @@ stack frame returns.
The commands for viewing and changing variables inside of @command{gawk} are:
@table @asis
address@hidden debugger commands @subentry @code{display}
address@hidden debugger @subentry commands @subentry @code{display}
@cindex @code{display} debugger command
@item @code{display} address@hidden | @address@hidden
Add variable @var{var} (or field @address@hidden) to the display list.
@@ -31280,7 +31294,7 @@ no such variable of the given name exists.
Without argument, @code{display} displays the current values of
items on the list.
address@hidden debugger commands @subentry @code{eval}
address@hidden debugger @subentry commands @subentry @code{eval}
@cindex @code{eval} debugger command
@cindex evaluate expressions, in debugger
@item @code{eval "@var{awk statements}"}
@@ -31307,8 +31321,8 @@ This form of @code{eval} is similar, but it allows you
to define
@var{awk statements}, instead of using variables or function
parameters defined by the program.
address@hidden debugger commands @subentry @code{p} (@code{print})
address@hidden debugger commands @subentry @code{print}
address@hidden debugger @subentry commands @subentry @code{p} (@code{print})
address@hidden debugger @subentry commands @subentry @code{print}
@cindex @code{print} debugger command
@cindex @code{p} debugger command (alias for @code{print})
@cindex print variables, in debugger
@@ -31335,7 +31349,7 @@ gawk> @kbd{print @@a}
This prints the indices and the corresponding values for all elements in
the array @code{a}.
address@hidden debugger commands @subentry @code{printf}
address@hidden debugger @subentry commands @subentry @code{printf}
@cindex @code{printf} debugger command
@item @code{printf} @var{format} address@hidden,} @var{arg} @dots{}]
Print formatted text. The @var{format} may include escape sequences,
@@ -31343,7 +31357,7 @@ such as @samp{\n}
(@pxref{Escape Sequences}).
No newline is printed unless one is specified.
address@hidden debugger commands @subentry @code{set}
address@hidden debugger @subentry commands @subentry @code{set}
@cindex @code{set} debugger command
@cindex assign values to variables, in debugger
@item @code{set} @address@hidden@var{value}
@@ -31354,8 +31368,8 @@ String values must be enclosed between double quotes
(@code{"address@hidden@code{"}).
You can also set special @command{awk} variables, such as @code{FS},
@code{NF}, @code{NR}, and so on.
address@hidden debugger commands @subentry @code{w} (@code{watch})
address@hidden debugger commands @subentry @code{watch}
address@hidden debugger @subentry commands @subentry @code{w} (@code{watch})
address@hidden debugger @subentry commands @subentry @code{watch}
@cindex @code{watch} debugger command
@cindex @code{w} debugger command (alias for @code{watch})
@cindex set @subentry watchpoint
@@ -31373,14 +31387,14 @@ evaluates whenever the watchpoint is reached. If the
condition is true,
then the debugger stops execution and prompts for a command. Otherwise,
@command{gawk} continues executing the program.
address@hidden debugger commands @subentry @code{undisplay}
address@hidden debugger @subentry commands @subentry @code{undisplay}
@cindex @code{undisplay} debugger command
@cindex stop automatic display, in debugger
@item @code{undisplay} address@hidden
Remove item number @var{n} (or all items, if no argument) from the
automatic display list.
address@hidden debugger commands @subentry @code{unwatch}
address@hidden debugger @subentry commands @subentry @code{unwatch}
@cindex @code{unwatch} debugger command
@cindex delete watchpoint
@item @code{unwatch} address@hidden
@@ -31399,9 +31413,9 @@ and also move around in the stack to see what the state
of things was in the
functions that called the one you are in. The commands for doing this are:
@table @asis
address@hidden debugger commands @subentry @code{bt} (@code{backtrace})
address@hidden debugger commands @subentry @code{backtrace}
address@hidden debugger commands @subentry @code{where} (@code{backtrace})
address@hidden debugger @subentry commands @subentry @code{bt}
(@code{backtrace})
address@hidden debugger @subentry commands @subentry @code{backtrace}
address@hidden debugger @subentry commands @subentry @code{where}
(@code{backtrace})
@cindex @code{backtrace} debugger command
@cindex @code{bt} debugger command (alias for @code{backtrace})
@cindex @code{where} debugger command (alias for @code{backtrace})
@@ -31417,14 +31431,14 @@ function, the source @value{FN}, and the line number.
The alias @code{where} for @code{backtrace} is provided for longtime
GDB users who may be used to that command.
address@hidden debugger commands @subentry @code{down}
address@hidden debugger @subentry commands @subentry @code{down}
@cindex @code{down} debugger command
@item @code{down} address@hidden
Move @var{count} (default 1) frames down the stack toward the innermost frame.
Then select and print the frame.
address@hidden debugger commands @subentry @code{f} (@code{frame})
address@hidden debugger commands @subentry @code{frame}
address@hidden debugger @subentry commands @subentry @code{f} (@code{frame})
address@hidden debugger @subentry commands @subentry @code{frame}
@cindex @code{frame} debugger command
@cindex @code{f} debugger command (alias for @code{frame})
@item @code{frame} address@hidden
@@ -31435,7 +31449,7 @@ called the innermost one. The highest-numbered frame is
the one for the
main program. The printed information consists of the frame number,
function and argument names, source file, and the source line.
address@hidden debugger commands @subentry @code{up}
address@hidden debugger @subentry commands @subentry @code{up}
@cindex @code{up} debugger command
@item @code{up} address@hidden
Move @var{count} (default 1) frames up the stack toward the outermost frame.
@@ -31453,8 +31467,8 @@ is used with one of a number of arguments that tell it
exactly what
you want to know:
@table @asis
address@hidden debugger commands @subentry @code{i} (@code{info})
address@hidden debugger commands @subentry @code{info}
address@hidden debugger @subentry commands @subentry @code{i} (@code{info})
address@hidden debugger @subentry commands @subentry @code{info}
@cindex @code{info} debugger command
@cindex @code{i} debugger command (alias for @code{info})
@item @code{info} @var{what}
@@ -31470,7 +31484,7 @@ List arguments of the selected frame.
@item break
@cindex show in debugger @subentry breakpoints
address@hidden breakpoints, show in debugger
address@hidden breakpoint, show all in debugger
List all currently set breakpoints.
@item display
@@ -31525,8 +31539,8 @@ save the debugger's state, and the ability to run
debugger commands
from a file. The commands are:
@table @asis
address@hidden debugger commands @subentry @code{o} (@code{option})
address@hidden debugger commands @subentry @code{option}
address@hidden debugger @subentry commands @subentry @code{o} (@code{option})
address@hidden debugger @subentry commands @subentry @code{option}
@cindex @code{option} debugger command
@cindex @code{o} debugger command (alias for @code{option})
@cindex display debugger options
@@ -31608,7 +31622,7 @@ There are a few more commands that do not fit into the
previous categories, as follows:
@table @asis
address@hidden debugger commands @subentry @code{dump}
address@hidden debugger @subentry commands @subentry @code{dump}
@cindex @code{dump} debugger command
@item @code{dump} address@hidden
Dump byte code of the program to standard output or to the file
@@ -31678,8 +31692,8 @@ gawk>
Exit the debugger.
See the entry for @samp{quit}, later in this list.
address@hidden debugger commands @subentry @code{h} (@code{help})
address@hidden debugger commands @subentry @code{help}
address@hidden debugger @subentry commands @subentry @code{h} (@code{help})
address@hidden debugger @subentry commands @subentry @code{help}
@cindex @code{help} debugger command
@cindex @code{h} debugger command (alias for @code{help})
@item @code{help}
@@ -31688,8 +31702,8 @@ Print a list of all of the @command{gawk} debugger
commands with a short
summary of their usage. @samp{help @var{command}} prints the information
about the command @var{command}.
address@hidden debugger commands @subentry @code{l} (@code{list})
address@hidden debugger commands @subentry @code{list}
address@hidden debugger @subentry commands @subentry @code{l} (@code{list})
address@hidden debugger @subentry commands @subentry @code{list}
@cindex @code{list} debugger command
@cindex @code{l} debugger command (alias for @code{list})
@item @code{list} address@hidden | @code{+} | @var{n} |
@address@hidden:address@hidden | @address@hidden | @var{function}]
@@ -31722,8 +31736,8 @@ Print lines centered around the beginning of the
function @var{function}. This command may change the current source file.
@end table
address@hidden debugger commands @subentry @code{q} (@code{quit})
address@hidden debugger commands @subentry @code{quit}
address@hidden debugger @subentry commands @subentry @code{q} (@code{quit})
address@hidden debugger @subentry commands @subentry @code{quit}
@cindex @code{quit} debugger command
@cindex @code{q} debugger command (alias for @code{quit})
@cindex exit the debugger
@@ -31735,7 +31749,7 @@ and are free to go on to the next one! As we saw
earlier, if you are
running a program, the debugger warns you when you type
@samp{q} or @samp{quit}, to make sure you really want to quit.
address@hidden debugger commands @subentry @code{trace}
address@hidden debugger @subentry commands @subentry @code{trace}
@cindex @code{trace} debugger command
@item @code{trace} address@hidden | @code{off}]
Turn on or off continuous printing of the instructions that are about to
@@ -32119,7 +32133,8 @@ of @code{BEGIN}, @code{BEGINFILE}, @code{END}, and
@code{ENDFILE} rules.
@cindex naming rules, namespace and component names
@cindex namespace names, naming rules
address@hidden component names @subentry naming rules
address@hidden not "component names" to merge with other index entry
address@hidden component name @subentry naming rules
A number of rules apply to the namespace and component names, as follows.
@itemize @bullet
@@ -45333,5 +45348,3 @@ Add a section explaining recursion from ground zero.
Probably
easiest to do it with factorial as the example. Explain that
recursion needs a stopping condition. Thanks to
Bill Duncan <address@hidden> for the suggestion.
-
-Add an entry for all env vars @cindex environment variables @subentry
@env{FOO}.
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index e3ea5dc..e2c2e47 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -5652,7 +5652,7 @@ when in compatibility mode (@pxref{Options}).
@cindex bracket expressions
@cindex bracket expressions @subentry range expressions
@cindex range expressions (regexps)
address@hidden character lists in regular expressions
address@hidden bracket expressions @subentry character lists
As mentioned earlier, a bracket expression matches any character among
those listed between the opening and closing square brackets.
@@ -8745,6 +8745,8 @@ worth of data the first time. Because of this, changing
the value
of timeout like in the preceding example is not very useful.
@end quotation
address@hidden @env{GAWK_READ_TIMEOUT} environment variable
address@hidden environment variables @subentry @env{GAWK_READ_TIMEOUT}
If the @code{PROCINFO} element is not present and the
@env{GAWK_READ_TIMEOUT} environment variable exists,
@command{gawk} uses its value to initialize the timeout value.
@@ -10471,6 +10473,8 @@ For standard output, you may use @code{PROCINFO["-",
"NONFATAL"]}
or @code{PROCINFO["/dev/stdout", "NONFATAL"]}. For standard error, use
@code{PROCINFO["/dev/stderr", "NONFATAL"]}.
address@hidden @env{GAWK_SOCK_RETRIES} environment variable
address@hidden environment variables @subentry @env{GAWK_SOCK_RETRIES}
When attempting to open a TCP/IP socket (@pxref{TCP/IP Networking}),
@command{gawk} tries multiple times. The @env{GAWK_SOCK_RETRIES}
environment variable (@pxref{Other Environment Variables}) allows you to
@@ -11192,7 +11196,7 @@ this @value{SECTION} discusses this important facet of
@command{awk}.
@node Strings And Numbers
@subsubsection How @command{awk} Converts Between Strings and Numbers
address@hidden converting @subentry strings to numbers
address@hidden converting @subentry string to numbers
@cindex strings @subentry converting
@cindex numbers @subentry converting
@cindex converting @subentry numbers to strings
@@ -19394,7 +19398,7 @@ $ @kbd{gawk -f testbits.awk}
@print{} rshift(0x99, 2) = 0x26 = 00100110
@end example
address@hidden converting @subentry strings to numbers
address@hidden converting @subentry string to numbers
@cindex strings @subentry converting
@cindex numbers @subentry converting
@cindex converting @subentry numbers to strings
@@ -27864,7 +27868,7 @@ remain more difficult to use than two-way pipes.} @c
8/2014
@cindex input/output @subentry two-way
@cindex @code{|} (vertical bar) @subentry @code{|&} operator (I/O)
@cindex vertical bar (@code{|}) @subentry @code{|&} operator (I/O)
address@hidden @command{csh} utility @subentry @code{|&} operator @subentry
comparison with
address@hidden @command{csh} utility @subentry @code{|&} operator, comparison
with
However, with @command{gawk}, it is possible to
open a @emph{two-way} pipe to another process. The second process is
termed a @dfn{coprocess}, as it runs in parallel with @command{gawk}.
@@ -28851,6 +28855,8 @@ look to see if @env{LANGUAGE} is defined, and if so,
use the shell's
@command{unset} command to remove it.
@end quotation
address@hidden @env{GAWK_LOCALE_DIR} environment variable
address@hidden environment variables @subentry @env{GAWK_LOCALE_DIR}
For testing translations of @command{gawk} itself, you can set
the @env{GAWK_LOCALE_DIR} environment variable. See the documentation
for the C @code{bindtextdomain()} function and also see
@@ -29359,6 +29365,14 @@ file and then to create the @file{guide.mo} file.
The directory has the form @address@hidden/LC_MESSAGES}, where
@var{locale} is a locale name known to the C @command{gettext} routines.
address@hidden @env{LANGUAGE} environment variable
address@hidden environment variables @subentry @env{LANGUAGE}
address@hidden @env{LC_ALL} environment variable
address@hidden environment variables @subentry @env{LC_ALL}
address@hidden @env{LANG} environment variable
address@hidden environment variables @subentry @env{LANG}
address@hidden @env{LC_MESSAGES} environment variable
address@hidden environment variables @subentry @env{LC_MESSAGES}
How do we know which locale to use? It turns out that there are
four different environment variables used by the C @command{gettext} routines.
In order, they are @env{$LANGUAGE}, @env{$LC_ALL}, @env{$LANG}, and
@@ -29530,7 +29544,7 @@ In that case, what can you expect from such a tool?
The answer to that
depends on the language being debugged, but in general, you can expect at
least the following:
address@hidden debugger capabilities
address@hidden debugger @subentry capabilities
@itemize @value{BULLET}
@item
The ability to watch a program execute its instructions one by one,
@@ -29593,7 +29607,7 @@ invoked. Commands that print the call stack print
information about
each stack frame (as detailed later on).
@item Breakpoint
address@hidden breakpoint (debugger)
address@hidden breakpoint
During debugging, you often wish to let the program run until it
reaches a certain point, and then continue execution from there one
statement (or instruction) at a time. The way to do this is to set
@@ -29728,9 +29742,9 @@ a breakpoint in @file{uniq.awk} is at the beginning of
the function
the breakpoint, use the @code{b} (breakpoint) command:
@cindex debugger @subentry setting a breakpoint
address@hidden debugger @subentry @code{breakpoint} command
address@hidden debugger @subentry @code{break} command
address@hidden debugger @subentry @code{b} command
address@hidden debugger @subentry commands @subentry @code{breakpoint}
address@hidden debugger @subentry commands @subentry @code{break}
address@hidden debugger @subentry commands @subentry @code{b} (@code{break})
@example
gawk> @kbd{b are_equal}
@print{} Breakpoint 1 set at file `awklib/eg/prog/uniq.awk', line 63
@@ -29741,7 +29755,7 @@ Now type @samp{r} or @samp{run} and the program runs
until it hits
the breakpoint for the first time:
@cindex debugger @subentry running the program
address@hidden debugger @subentry @code{run} command
address@hidden debugger @subentry commands @subentry @code{run}
@example
gawk> @kbd{r}
@print{} Starting program:
@@ -29758,8 +29772,8 @@ let's see how we got to where we are. At the prompt,
we type @samp{bt}
listing of the current stack frames:
@cindex debugger @subentry stack frames, showing
address@hidden debugger @subentry @code{bt} command
address@hidden debugger @subentry @code{backtrace} command
address@hidden debugger @subentry commands @subentry @code{bt}
(@code{backtrace})
address@hidden debugger @subentry commands @subentry @code{backtrace}
@example
gawk> @kbd{bt}
@print{} #0 are_equal(n, m, clast, cline, alast, aline)
@@ -29779,8 +29793,8 @@ of some variables. Let's say we type @samp{p n}
@code{n}, a parameter to @code{are_equal()}. Actually, the debugger
gives us:
address@hidden debugger @subentry @code{print} command
address@hidden debugger @subentry @code{p} command
address@hidden debugger @subentry commands @subentry @code{print}
address@hidden debugger @subentry commands @subentry @code{p} (@code{print})
@example
gawk> @kbd{p n}
@print{} n = untyped variable
@@ -29831,8 +29845,8 @@ be inside this function. To investigate further, we
must begin
``stepping through'' the lines of @code{are_equal()}. We start by typing
@samp{n} (for ``next''):
address@hidden debugger @subentry @code{n} command
address@hidden debugger @subentry @code{next} command
address@hidden debugger @subentry commands @subentry @code{n} (@code{next})
address@hidden debugger @subentry commands @subentry @code{next}
@example
@group
gawk> @kbd{n}
@@ -30008,8 +30022,8 @@ will otherwise just run as if it was not under the
debugger. The commands for
controlling breakpoints are:
@table @asis
address@hidden debugger commands @subentry @code{b} (@code{break})
address@hidden debugger commands @subentry @code{break}
address@hidden debugger @subentry commands @subentry @code{b} (@code{break})
address@hidden debugger @subentry commands @subentry @code{break}
@cindex @code{break} debugger command
@cindex @code{b} debugger command (alias for @code{break})
@cindex set @subentry breakpoint
@@ -30043,7 +30057,7 @@ evaluates whenever the breakpoint is reached. If the
condition is true,
then the debugger stops execution and prompts for a command. Otherwise,
it continues executing the program.
address@hidden debugger commands @subentry @code{clear}
address@hidden debugger @subentry commands @subentry @code{clear}
@cindex @code{clear} debugger command
@cindex delete breakpoint @subentry at location
@cindex breakpoint @subentry at location, how to delete
@@ -30065,7 +30079,7 @@ Delete breakpoint(s) set at line number @var{n} in
source file @var{filename}.
Delete breakpoint(s) set at entry to function @var{function}.
@end table
address@hidden debugger commands @subentry @code{condition}
address@hidden debugger @subentry commands @subentry @code{condition}
@cindex @code{condition} debugger command
@cindex breakpoint @subentry condition
@item @code{condition} @var{n} @code{"@var{expression}"}
@@ -30078,8 +30092,8 @@ the debugger continues executing the program. If the
condition expression is
not specified, any existing condition is removed (i.e., the breakpoint or
watchpoint is made unconditional).
address@hidden debugger commands @subentry @code{d} (@code{delete})
address@hidden debugger commands @subentry @code{delete}
address@hidden debugger @subentry commands @subentry @code{d} (@code{delete})
address@hidden debugger @subentry commands @subentry @code{delete}
@cindex @code{delete} debugger command
@cindex @code{d} debugger command (alias for @code{delete})
@cindex delete breakpoint @subentry by number
@@ -30089,7 +30103,7 @@ watchpoint is made unconditional).
Delete specified breakpoints or a range of breakpoints. Delete
all defined breakpoints if no argument is supplied.
address@hidden debugger commands @subentry @code{disable}
address@hidden debugger @subentry commands @subentry @code{disable}
@cindex @code{disable} debugger command
@cindex disable breakpoint
@cindex breakpoint @subentry how to disable or enable
@@ -30097,8 +30111,8 @@ all defined breakpoints if no argument is supplied.
Disable specified breakpoints or a range of breakpoints. Without
any argument, disable all breakpoints.
address@hidden debugger commands @subentry @code{e} (@code{enable})
address@hidden debugger commands @subentry @code{enable}
address@hidden debugger @subentry commands @subentry @code{e} (@code{enable})
address@hidden debugger @subentry commands @subentry @code{enable}
@cindex @code{enable} debugger command
@cindex @code{e} debugger command (alias for @code{enable})
@cindex enable breakpoint
@@ -30119,15 +30133,15 @@ Enable the breakpoints temporarily, then disable each
one when
the program stops at it.
@end table
address@hidden debugger commands @subentry @code{ignore}
address@hidden debugger @subentry commands @subentry @code{ignore}
@cindex @code{ignore} debugger command
@cindex ignore breakpoint
@item @code{ignore} @var{n} @var{count}
Ignore breakpoint number @var{n} the next @var{count} times it is
hit.
address@hidden debugger commands @subentry @code{t} (@code{tbreak})
address@hidden debugger commands @subentry @code{tbreak}
address@hidden debugger @subentry commands @subentry @code{t} (@code{tbreak})
address@hidden debugger @subentry commands @subentry @code{tbreak}
@cindex @code{tbreak} debugger command
@cindex @code{t} debugger command (alias for @code{tbreak})
@cindex temporary breakpoint
@@ -30145,11 +30159,11 @@ and observing its behavior. There are more commands
for controlling
execution of the program than we saw in our earlier example:
@table @asis
address@hidden debugger commands @subentry @code{commands}
address@hidden debugger @subentry commands @subentry @code{commands}
@cindex @code{commands} debugger command
address@hidden debugger commands @subentry @code{silent}
address@hidden debugger @subentry commands @subentry @code{silent}
@cindex @code{silent} debugger command
address@hidden debugger commands @subentry @code{end}
address@hidden debugger @subentry commands @subentry @code{end}
@cindex @code{end} debugger command
@cindex breakpoint @subentry commands to execute at
@cindex commands to execute at breakpoint
@@ -30178,8 +30192,8 @@ gawk> @kbd{commands}
gawk>
@end example
address@hidden debugger commands @subentry @code{c} (@code{continue})
address@hidden debugger commands @subentry @code{continue}
address@hidden debugger @subentry commands @subentry @code{c} (@code{continue})
address@hidden debugger @subentry commands @subentry @code{continue}
@cindex continue program, in debugger
@cindex @code{continue} debugger command
@item @code{continue} address@hidden
@@ -30188,14 +30202,14 @@ Resume program execution. If continued from a
breakpoint and @var{count} is
specified, ignore the breakpoint at that location the next @var{count} times
before stopping.
address@hidden debugger commands @subentry @code{finish}
address@hidden debugger @subentry commands @subentry @code{finish}
@cindex @code{finish} debugger command
@item @code{finish}
Execute until the selected stack frame returns.
Print the returned value.
address@hidden debugger commands @subentry @code{n} (@code{next})
address@hidden debugger commands @subentry @code{next}
address@hidden debugger @subentry commands @subentry @code{n} (@code{next})
address@hidden debugger @subentry commands @subentry @code{next}
@cindex @code{next} debugger command
@cindex @code{n} debugger command (alias for @code{next})
@cindex single-step execution, in the debugger
@@ -30205,15 +30219,15 @@ Continue execution to the next source line, stepping
over function calls.
The argument @var{count} controls how many times to repeat the action, as
in @code{step}.
address@hidden debugger commands @subentry @code{ni} (@code{nexti})
address@hidden debugger commands @subentry @code{nexti}
address@hidden debugger @subentry commands @subentry @code{ni} (@code{nexti})
address@hidden debugger @subentry commands @subentry @code{nexti}
@cindex @code{nexti} debugger command
@cindex @code{ni} debugger command (alias for @code{nexti})
@item @code{nexti} address@hidden
@itemx @code{ni} address@hidden
Execute one (or @var{count}) instruction(s), stepping over function calls.
address@hidden debugger commands @subentry @code{return}
address@hidden debugger @subentry commands @subentry @code{return}
@cindex @code{return} debugger command
@item @code{return} address@hidden
Cancel execution of a function call. If @var{value} (either a string or a
@@ -30222,8 +30236,8 @@ frame other than the innermost one (the currently
executing function; i.e.,
frame number 0), discard all inner frames in addition to the selected one,
and the caller of that frame becomes the innermost frame.
address@hidden debugger commands @subentry @code{r} (@code{run})
address@hidden debugger commands @subentry @code{run}
address@hidden debugger @subentry commands @subentry @code{r} (@code{run})
address@hidden debugger @subentry commands @subentry @code{run}
@cindex @code{run} debugger command
@cindex @code{r} debugger command (alias for @code{run})
@item @code{run}
@@ -30232,8 +30246,8 @@ Start/restart execution of the program. When
restarting, the debugger
retains the current breakpoints, watchpoints, command history,
automatic display variables, and debugger options.
address@hidden debugger commands @subentry @code{s} (@code{step})
address@hidden debugger commands @subentry @code{step}
address@hidden debugger @subentry commands @subentry @code{s} (@code{step})
address@hidden debugger @subentry commands @subentry @code{step}
@cindex @code{step} debugger command
@cindex @code{s} debugger command (alias for @code{step})
@item @code{step} address@hidden
@@ -30243,8 +30257,8 @@ current stack frame, stepping inside any function
called within
the line. If the argument @var{count} is supplied, steps that many times
before
stopping, unless it encounters a breakpoint or watchpoint.
address@hidden debugger commands @subentry @code{si} (@code{stepi})
address@hidden debugger commands @subentry @code{stepi}
address@hidden debugger @subentry commands @subentry @code{si} (@code{stepi})
address@hidden debugger @subentry commands @subentry @code{stepi}
@cindex @code{stepi} debugger command
@cindex @code{si} debugger command (alias for @code{stepi})
@item @code{stepi} address@hidden
@@ -30253,8 +30267,8 @@ Execute one (or @var{count}) instruction(s), stepping
inside function calls.
(For illustration of what is meant by an ``instruction'' in @command{gawk},
see the output shown under @code{dump} in @ref{Miscellaneous Debugger
Commands}.)
address@hidden debugger commands @subentry @code{u} (@code{until})
address@hidden debugger commands @subentry @code{until}
address@hidden debugger @subentry commands @subentry @code{u} (@code{until})
address@hidden debugger @subentry commands @subentry @code{until}
@cindex @code{until} debugger command
@cindex @code{u} debugger command (alias for @code{until})
@item @code{until} address@hidden@code{:address@hidden | @var{function}]
@@ -30271,7 +30285,7 @@ stack frame returns.
The commands for viewing and changing variables inside of @command{gawk} are:
@table @asis
address@hidden debugger commands @subentry @code{display}
address@hidden debugger @subentry commands @subentry @code{display}
@cindex @code{display} debugger command
@item @code{display} address@hidden | @address@hidden
Add variable @var{var} (or field @address@hidden) to the display list.
@@ -30291,7 +30305,7 @@ no such variable of the given name exists.
Without argument, @code{display} displays the current values of
items on the list.
address@hidden debugger commands @subentry @code{eval}
address@hidden debugger @subentry commands @subentry @code{eval}
@cindex @code{eval} debugger command
@cindex evaluate expressions, in debugger
@item @code{eval "@var{awk statements}"}
@@ -30318,8 +30332,8 @@ This form of @code{eval} is similar, but it allows you
to define
@var{awk statements}, instead of using variables or function
parameters defined by the program.
address@hidden debugger commands @subentry @code{p} (@code{print})
address@hidden debugger commands @subentry @code{print}
address@hidden debugger @subentry commands @subentry @code{p} (@code{print})
address@hidden debugger @subentry commands @subentry @code{print}
@cindex @code{print} debugger command
@cindex @code{p} debugger command (alias for @code{print})
@cindex print variables, in debugger
@@ -30346,7 +30360,7 @@ gawk> @kbd{print @@a}
This prints the indices and the corresponding values for all elements in
the array @code{a}.
address@hidden debugger commands @subentry @code{printf}
address@hidden debugger @subentry commands @subentry @code{printf}
@cindex @code{printf} debugger command
@item @code{printf} @var{format} address@hidden,} @var{arg} @dots{}]
Print formatted text. The @var{format} may include escape sequences,
@@ -30354,7 +30368,7 @@ such as @samp{\n}
(@pxref{Escape Sequences}).
No newline is printed unless one is specified.
address@hidden debugger commands @subentry @code{set}
address@hidden debugger @subentry commands @subentry @code{set}
@cindex @code{set} debugger command
@cindex assign values to variables, in debugger
@item @code{set} @address@hidden@var{value}
@@ -30365,8 +30379,8 @@ String values must be enclosed between double quotes
(@code{"address@hidden@code{"}).
You can also set special @command{awk} variables, such as @code{FS},
@code{NF}, @code{NR}, and so on.
address@hidden debugger commands @subentry @code{w} (@code{watch})
address@hidden debugger commands @subentry @code{watch}
address@hidden debugger @subentry commands @subentry @code{w} (@code{watch})
address@hidden debugger @subentry commands @subentry @code{watch}
@cindex @code{watch} debugger command
@cindex @code{w} debugger command (alias for @code{watch})
@cindex set @subentry watchpoint
@@ -30384,14 +30398,14 @@ evaluates whenever the watchpoint is reached. If the
condition is true,
then the debugger stops execution and prompts for a command. Otherwise,
@command{gawk} continues executing the program.
address@hidden debugger commands @subentry @code{undisplay}
address@hidden debugger @subentry commands @subentry @code{undisplay}
@cindex @code{undisplay} debugger command
@cindex stop automatic display, in debugger
@item @code{undisplay} address@hidden
Remove item number @var{n} (or all items, if no argument) from the
automatic display list.
address@hidden debugger commands @subentry @code{unwatch}
address@hidden debugger @subentry commands @subentry @code{unwatch}
@cindex @code{unwatch} debugger command
@cindex delete watchpoint
@item @code{unwatch} address@hidden
@@ -30410,9 +30424,9 @@ and also move around in the stack to see what the state
of things was in the
functions that called the one you are in. The commands for doing this are:
@table @asis
address@hidden debugger commands @subentry @code{bt} (@code{backtrace})
address@hidden debugger commands @subentry @code{backtrace}
address@hidden debugger commands @subentry @code{where} (@code{backtrace})
address@hidden debugger @subentry commands @subentry @code{bt}
(@code{backtrace})
address@hidden debugger @subentry commands @subentry @code{backtrace}
address@hidden debugger @subentry commands @subentry @code{where}
(@code{backtrace})
@cindex @code{backtrace} debugger command
@cindex @code{bt} debugger command (alias for @code{backtrace})
@cindex @code{where} debugger command (alias for @code{backtrace})
@@ -30428,14 +30442,14 @@ function, the source @value{FN}, and the line number.
The alias @code{where} for @code{backtrace} is provided for longtime
GDB users who may be used to that command.
address@hidden debugger commands @subentry @code{down}
address@hidden debugger @subentry commands @subentry @code{down}
@cindex @code{down} debugger command
@item @code{down} address@hidden
Move @var{count} (default 1) frames down the stack toward the innermost frame.
Then select and print the frame.
address@hidden debugger commands @subentry @code{f} (@code{frame})
address@hidden debugger commands @subentry @code{frame}
address@hidden debugger @subentry commands @subentry @code{f} (@code{frame})
address@hidden debugger @subentry commands @subentry @code{frame}
@cindex @code{frame} debugger command
@cindex @code{f} debugger command (alias for @code{frame})
@item @code{frame} address@hidden
@@ -30446,7 +30460,7 @@ called the innermost one. The highest-numbered frame is
the one for the
main program. The printed information consists of the frame number,
function and argument names, source file, and the source line.
address@hidden debugger commands @subentry @code{up}
address@hidden debugger @subentry commands @subentry @code{up}
@cindex @code{up} debugger command
@item @code{up} address@hidden
Move @var{count} (default 1) frames up the stack toward the outermost frame.
@@ -30464,8 +30478,8 @@ is used with one of a number of arguments that tell it
exactly what
you want to know:
@table @asis
address@hidden debugger commands @subentry @code{i} (@code{info})
address@hidden debugger commands @subentry @code{info}
address@hidden debugger @subentry commands @subentry @code{i} (@code{info})
address@hidden debugger @subentry commands @subentry @code{info}
@cindex @code{info} debugger command
@cindex @code{i} debugger command (alias for @code{info})
@item @code{info} @var{what}
@@ -30481,7 +30495,7 @@ List arguments of the selected frame.
@item break
@cindex show in debugger @subentry breakpoints
address@hidden breakpoints, show in debugger
address@hidden breakpoint, show all in debugger
List all currently set breakpoints.
@item display
@@ -30536,8 +30550,8 @@ save the debugger's state, and the ability to run
debugger commands
from a file. The commands are:
@table @asis
address@hidden debugger commands @subentry @code{o} (@code{option})
address@hidden debugger commands @subentry @code{option}
address@hidden debugger @subentry commands @subentry @code{o} (@code{option})
address@hidden debugger @subentry commands @subentry @code{option}
@cindex @code{option} debugger command
@cindex @code{o} debugger command (alias for @code{option})
@cindex display debugger options
@@ -30619,7 +30633,7 @@ There are a few more commands that do not fit into the
previous categories, as follows:
@table @asis
address@hidden debugger commands @subentry @code{dump}
address@hidden debugger @subentry commands @subentry @code{dump}
@cindex @code{dump} debugger command
@item @code{dump} address@hidden
Dump byte code of the program to standard output or to the file
@@ -30689,8 +30703,8 @@ gawk>
Exit the debugger.
See the entry for @samp{quit}, later in this list.
address@hidden debugger commands @subentry @code{h} (@code{help})
address@hidden debugger commands @subentry @code{help}
address@hidden debugger @subentry commands @subentry @code{h} (@code{help})
address@hidden debugger @subentry commands @subentry @code{help}
@cindex @code{help} debugger command
@cindex @code{h} debugger command (alias for @code{help})
@item @code{help}
@@ -30699,8 +30713,8 @@ Print a list of all of the @command{gawk} debugger
commands with a short
summary of their usage. @samp{help @var{command}} prints the information
about the command @var{command}.
address@hidden debugger commands @subentry @code{l} (@code{list})
address@hidden debugger commands @subentry @code{list}
address@hidden debugger @subentry commands @subentry @code{l} (@code{list})
address@hidden debugger @subentry commands @subentry @code{list}
@cindex @code{list} debugger command
@cindex @code{l} debugger command (alias for @code{list})
@item @code{list} address@hidden | @code{+} | @var{n} |
@address@hidden:address@hidden | @address@hidden | @var{function}]
@@ -30733,8 +30747,8 @@ Print lines centered around the beginning of the
function @var{function}. This command may change the current source file.
@end table
address@hidden debugger commands @subentry @code{q} (@code{quit})
address@hidden debugger commands @subentry @code{quit}
address@hidden debugger @subentry commands @subentry @code{q} (@code{quit})
address@hidden debugger @subentry commands @subentry @code{quit}
@cindex @code{quit} debugger command
@cindex @code{q} debugger command (alias for @code{quit})
@cindex exit the debugger
@@ -30746,7 +30760,7 @@ and are free to go on to the next one! As we saw
earlier, if you are
running a program, the debugger warns you when you type
@samp{q} or @samp{quit}, to make sure you really want to quit.
address@hidden debugger commands @subentry @code{trace}
address@hidden debugger @subentry commands @subentry @code{trace}
@cindex @code{trace} debugger command
@item @code{trace} address@hidden | @code{off}]
Turn on or off continuous printing of the instructions that are about to
@@ -31130,7 +31144,8 @@ of @code{BEGIN}, @code{BEGINFILE}, @code{END}, and
@code{ENDFILE} rules.
@cindex naming rules, namespace and component names
@cindex namespace names, naming rules
address@hidden component names @subentry naming rules
address@hidden not "component names" to merge with other index entry
address@hidden component name @subentry naming rules
A number of rules apply to the namespace and component names, as follows.
@itemize @bullet
@@ -44305,5 +44320,3 @@ Add a section explaining recursion from ground zero.
Probably
easiest to do it with factorial as the example. Explain that
recursion needs a stopping condition. Thanks to
Bill Duncan <address@hidden> for the suggestion.
-
-Add an entry for all env vars @cindex environment variables @subentry
@env{FOO}.
-----------------------------------------------------------------------
Summary of changes:
doc/gawk.texi | 173 ++++++++++++++++++++++++++++++--------------------------
doc/gawktexi.in | 173 ++++++++++++++++++++++++++++++--------------------------
2 files changed, 186 insertions(+), 160 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-3752-g473d5d5,
Arnold Robbins <=