[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[SCM] gawk branch, gawk-5.1-stable, updated. gawk-4.1.0-4316-gd249840
|
From: |
Arnold Robbins |
|
Subject: |
[SCM] gawk branch, gawk-5.1-stable, updated. gawk-4.1.0-4316-gd249840 |
|
Date: |
Mon, 27 Sep 2021 04:19:52 -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, gawk-5.1-stable has been updated
via d249840cccab9490a5fd9580ba5aa6181930bca5 (commit)
from f597ee8f9ac128f88f85639ffbce6d7248776f75 (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=d249840cccab9490a5fd9580ba5aa6181930bca5
commit d249840cccab9490a5fd9580ba5aa6181930bca5
Author: Arnold D. Robbins <arnold@skeeve.com>
Date: Mon Sep 27 11:19:37 2021 +0300
Documentation updates.
diff --git a/doc/ChangeLog b/doc/ChangeLog
index a4f61ad..361de52 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2021-09-27 Arnold D. Robbins <arnold@skeeve.com>
+
+ * gawktexi.in: Small cleanups from Antonio Columbo. General
+ review of usage of @code.
+
2021-09-24 Arnold D. Robbins <arnold@skeeve.com>
* gawktexi.in (Building the Documentation): Improve the text,
diff --git a/doc/gawk.info b/doc/gawk.info
index c393a24..671c67c 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -26737,8 +26737,8 @@ termed a "symbol table". The functions are as follows:
'awk_bool_t sym_update_ns(const char *name_space, const char *name,
awk_value_t *value);'
This is like 'sym_update()', but the 'name_space' parameter allows
you to specify which namespace 'name' is part of. 'name_space'
- cannot be 'NULL'. If it is '""' or '"awk', then 'name' is searched
- for in the default 'awk' namespace.
+ cannot be 'NULL'. If it is '""' or '"awk"', then 'name' is
+ searched for in the default 'awk' namespace.
An extension can look up the value of 'gawk''s special variables.
However, with the exception of the 'PROCINFO' array, an extension cannot
@@ -30565,12 +30565,13 @@ Various '.c', '.y', and '.h' files
of the subdirectories.
'NEWS'
- A list of changes to 'gawk' since the last release or patch.
+ A list of changes to 'gawk' since the last release or patch. There
+ may be similar files in other subdirectories.
'NEWS.0'
'NEWS.1'
- Older lists of changes to 'gawk'. There are similar files in all
- of the subdirectories.
+ Older lists of changes to 'gawk'. There may be similar files in
+ other subdirectories.
'COPYING'
The GNU General Public License.
@@ -35428,7 +35429,7 @@ Index
* arrays, sorting, IGNORECASE variable and: Array Sorting Functions.
(line 88)
* artificial intelligence, gawk and: Distribution contents.
- (line 63)
+ (line 64)
* ASCII: Escape Sequences. (line 31)
* ASCII <1>: Bracket Expressions. (line 79)
* ASCII <2>: Scalar Constants. (line 20)
@@ -35741,8 +35742,9 @@ Index
(line 51)
* buffers, flushing: I/O Functions. (line 32)
* buffers, flushing <1>: I/O Functions. (line 168)
-* bug reports, email address, bug-gawk@gnu.org: Bug address. (line 56)
-* bug-gawk@gnu.org bug reporting address: Bug address. (line 56)
+* bug reports, email address, <bug-gawk@gnu.org>: Bug address.
+ (line 56)
+* <bug-gawk@gnu.org> bug reporting address: Bug address. (line 56)
* built-in functions: Functions. (line 6)
* built-in functions, evaluation order: Calling Built-in. (line 30)
* BusyBox Awk: Other Versions. (line 92)
@@ -36337,7 +36339,7 @@ Index
* elements in arrays, order of access by in operator: Scanning an Array.
(line 48)
* elements in arrays, deleting: Delete. (line 6)
-* email address for bug reports, bug-gawk@gnu.org: Bug address.
+* email address for bug reports, <bug-gawk@gnu.org>: Bug address.
(line 56)
* empty array elements: Reference to Elements.
(line 18)
@@ -38224,7 +38226,7 @@ Index
(line 6)
* Texinfo <3>: Extract Program. (line 12)
* Texinfo <4>: Distribution contents.
- (line 88)
+ (line 89)
* Texinfo <5>: Adding Code. (line 100)
* text, printing: Print. (line 22)
* text, printing, unduplicated lines of: Uniq Program. (line 6)
@@ -38968,130 +38970,130 @@ Ref: table-value-types-returned1081917
Node: Accessing Parameters1082853
Node: Symbol Table Access1084090
Node: Symbol table by name1084602
-Ref: Symbol table by name-Footnote-11087626
-Node: Symbol table by cookie1087754
-Ref: Symbol table by cookie-Footnote-11091939
-Node: Cached values1092003
-Ref: Cached values-Footnote-11095539
-Node: Array Manipulation1095692
-Ref: Array Manipulation-Footnote-11096783
-Node: Array Data Types1096820
-Ref: Array Data Types-Footnote-11099478
-Node: Array Functions1099570
-Node: Flattening Arrays1104068
-Node: Creating Arrays1111044
-Node: Redirection API1115811
-Node: Extension API Variables1118644
-Node: Extension Versioning1119355
-Ref: gawk-api-version1119784
-Node: Extension GMP/MPFR Versioning1121515
-Node: Extension API Informational Variables1123143
-Node: Extension API Boilerplate1124216
-Node: Changes from API V11128190
-Node: Finding Extensions1129762
-Node: Extension Example1130321
-Node: Internal File Description1131119
-Node: Internal File Ops1135199
-Ref: Internal File Ops-Footnote-11146549
-Node: Using Internal File Ops1146689
-Ref: Using Internal File Ops-Footnote-11149072
-Node: Extension Samples1149346
-Node: Extension Sample File Functions1150875
-Node: Extension Sample Fnmatch1158524
-Node: Extension Sample Fork1160011
-Node: Extension Sample Inplace1161229
-Node: Extension Sample Ord1164855
-Node: Extension Sample Readdir1165691
-Ref: table-readdir-file-types1166580
-Node: Extension Sample Revout1167647
-Node: Extension Sample Rev2way1168236
-Node: Extension Sample Read write array1168976
-Node: Extension Sample Readfile1170918
-Node: Extension Sample Time1172013
-Node: Extension Sample API Tests1173765
-Node: gawkextlib1174257
-Node: Extension summary1177175
-Node: Extension Exercises1180877
-Node: Language History1182119
-Node: V7/SVR3.11183775
-Node: SVR41185927
-Node: POSIX1187361
-Node: BTL1188742
-Node: POSIX/GNU1189471
-Node: Feature History1195249
-Node: Common Extensions1212424
-Node: Ranges and Locales1213707
-Ref: Ranges and Locales-Footnote-11218323
-Ref: Ranges and Locales-Footnote-21218350
-Ref: Ranges and Locales-Footnote-31218585
-Node: Contributors1218808
-Node: History summary1224805
-Node: Installation1226185
-Node: Gawk Distribution1227129
-Node: Getting1227613
-Node: Extracting1228576
-Node: Distribution contents1230214
-Node: Unix Installation1237300
-Node: Quick Installation1238104
-Node: Compiling with MPFR1240580
-Node: Shell Startup Files1241272
-Node: Additional Configuration Options1242361
-Node: Configuration Philosophy1244676
-Node: Compiling from Git1247072
-Node: Building the Documentation1247627
-Node: Non-Unix Installation1249011
-Node: PC Installation1249471
-Node: PC Binary Installation1250309
-Node: PC Compiling1250744
-Node: PC Using1251861
-Node: Cygwin1255414
-Node: MSYS1256638
-Node: VMS Installation1257240
-Node: VMS Compilation1257959
-Ref: VMS Compilation-Footnote-11259188
-Node: VMS Dynamic Extensions1259246
-Node: VMS Installation Details1260931
-Node: VMS Running1263193
-Node: VMS GNV1267472
-Node: Bugs1268186
-Node: Bug definition1269098
-Node: Bug address1271602
-Node: Usenet1274990
-Node: Performance bugs1275999
-Node: Asking for help1278920
-Node: Maintainers1280882
-Node: Other Versions1282076
-Node: Installation summary1289928
-Node: Notes1291292
-Node: Compatibility Mode1292086
-Node: Additions1292868
-Node: Accessing The Source1293793
-Node: Adding Code1295230
-Node: New Ports1301449
-Node: Derived Files1305824
-Ref: Derived Files-Footnote-11311484
-Ref: Derived Files-Footnote-21311519
-Ref: Derived Files-Footnote-31312117
-Node: Future Extensions1312231
-Node: Implementation Limitations1312889
-Node: Extension Design1314099
-Node: Old Extension Problems1315243
-Ref: Old Extension Problems-Footnote-11316761
-Node: Extension New Mechanism Goals1316818
-Ref: Extension New Mechanism Goals-Footnote-11320182
-Node: Extension Other Design Decisions1320371
-Node: Extension Future Growth1322484
-Node: Notes summary1323090
-Node: Basic Concepts1324248
-Node: Basic High Level1324929
-Ref: figure-general-flow1325211
-Ref: figure-process-flow1325896
-Ref: Basic High Level-Footnote-11329197
-Node: Basic Data Typing1329382
-Node: Glossary1332710
-Node: Copying1364595
-Node: GNU Free Documentation License1402138
-Node: Index1427258
+Ref: Symbol table by name-Footnote-11087627
+Node: Symbol table by cookie1087755
+Ref: Symbol table by cookie-Footnote-11091940
+Node: Cached values1092004
+Ref: Cached values-Footnote-11095540
+Node: Array Manipulation1095693
+Ref: Array Manipulation-Footnote-11096784
+Node: Array Data Types1096821
+Ref: Array Data Types-Footnote-11099479
+Node: Array Functions1099571
+Node: Flattening Arrays1104069
+Node: Creating Arrays1111045
+Node: Redirection API1115812
+Node: Extension API Variables1118645
+Node: Extension Versioning1119356
+Ref: gawk-api-version1119785
+Node: Extension GMP/MPFR Versioning1121516
+Node: Extension API Informational Variables1123144
+Node: Extension API Boilerplate1124217
+Node: Changes from API V11128191
+Node: Finding Extensions1129763
+Node: Extension Example1130322
+Node: Internal File Description1131120
+Node: Internal File Ops1135200
+Ref: Internal File Ops-Footnote-11146550
+Node: Using Internal File Ops1146690
+Ref: Using Internal File Ops-Footnote-11149073
+Node: Extension Samples1149347
+Node: Extension Sample File Functions1150876
+Node: Extension Sample Fnmatch1158525
+Node: Extension Sample Fork1160012
+Node: Extension Sample Inplace1161230
+Node: Extension Sample Ord1164856
+Node: Extension Sample Readdir1165692
+Ref: table-readdir-file-types1166581
+Node: Extension Sample Revout1167648
+Node: Extension Sample Rev2way1168237
+Node: Extension Sample Read write array1168977
+Node: Extension Sample Readfile1170919
+Node: Extension Sample Time1172014
+Node: Extension Sample API Tests1173766
+Node: gawkextlib1174258
+Node: Extension summary1177176
+Node: Extension Exercises1180878
+Node: Language History1182120
+Node: V7/SVR3.11183776
+Node: SVR41185928
+Node: POSIX1187362
+Node: BTL1188743
+Node: POSIX/GNU1189472
+Node: Feature History1195250
+Node: Common Extensions1212425
+Node: Ranges and Locales1213708
+Ref: Ranges and Locales-Footnote-11218324
+Ref: Ranges and Locales-Footnote-21218351
+Ref: Ranges and Locales-Footnote-31218586
+Node: Contributors1218809
+Node: History summary1224806
+Node: Installation1226186
+Node: Gawk Distribution1227130
+Node: Getting1227614
+Node: Extracting1228577
+Node: Distribution contents1230215
+Node: Unix Installation1237357
+Node: Quick Installation1238161
+Node: Compiling with MPFR1240637
+Node: Shell Startup Files1241329
+Node: Additional Configuration Options1242418
+Node: Configuration Philosophy1244733
+Node: Compiling from Git1247129
+Node: Building the Documentation1247684
+Node: Non-Unix Installation1249068
+Node: PC Installation1249528
+Node: PC Binary Installation1250366
+Node: PC Compiling1250801
+Node: PC Using1251918
+Node: Cygwin1255471
+Node: MSYS1256695
+Node: VMS Installation1257297
+Node: VMS Compilation1258016
+Ref: VMS Compilation-Footnote-11259245
+Node: VMS Dynamic Extensions1259303
+Node: VMS Installation Details1260988
+Node: VMS Running1263250
+Node: VMS GNV1267529
+Node: Bugs1268243
+Node: Bug definition1269155
+Node: Bug address1271659
+Node: Usenet1275047
+Node: Performance bugs1276056
+Node: Asking for help1278977
+Node: Maintainers1280939
+Node: Other Versions1282133
+Node: Installation summary1289985
+Node: Notes1291349
+Node: Compatibility Mode1292143
+Node: Additions1292925
+Node: Accessing The Source1293850
+Node: Adding Code1295287
+Node: New Ports1301506
+Node: Derived Files1305881
+Ref: Derived Files-Footnote-11311541
+Ref: Derived Files-Footnote-21311576
+Ref: Derived Files-Footnote-31312174
+Node: Future Extensions1312288
+Node: Implementation Limitations1312946
+Node: Extension Design1314156
+Node: Old Extension Problems1315300
+Ref: Old Extension Problems-Footnote-11316818
+Node: Extension New Mechanism Goals1316875
+Ref: Extension New Mechanism Goals-Footnote-11320239
+Node: Extension Other Design Decisions1320428
+Node: Extension Future Growth1322541
+Node: Notes summary1323147
+Node: Basic Concepts1324305
+Node: Basic High Level1324986
+Ref: figure-general-flow1325268
+Ref: figure-process-flow1325953
+Ref: Basic High Level-Footnote-11329254
+Node: Basic Data Typing1329439
+Node: Glossary1332767
+Node: Copying1364652
+Node: GNU Free Documentation License1402195
+Node: Index1427315
End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index d11f904..4e1b2cb 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -3860,7 +3860,7 @@ The following list describes options mandated by the
POSIX standard:
@itemx --field-separator @var{fs}
@cindex @option{-F} option
@cindex @option{--field-separator} option
-@cindex @code{FS} variable @subentry @code{--field-separator} option and
+@cindex @code{FS} variable @subentry @option{--field-separator} option and
Set the @code{FS} variable to @var{fs}
(@pxref{Field Separators}).
@@ -4195,7 +4195,7 @@ if @command{gawk} is not compiled to use the GNU MPFR and
MP libraries
@cindex @option{--non-decimal-data} option
@cindex hexadecimal values, enabling interpretation of
@cindex octal values, enabling interpretation of
-@cindex troubleshooting @subentry @code{--non-decimal-data} option
+@cindex troubleshooting @subentry @option{--non-decimal-data} option
Enable automatic interpretation of octal and hexadecimal
values in input data
(@pxref{Nondecimal Data}).
@@ -4300,8 +4300,8 @@ data (@pxref{Locales}).
@c @cindex automatic warnings
@c @cindex warnings, automatic
-@cindex @option{--traditional} option @subentry @code{--posix} option and
-@cindex @option{--posix} option @subentry @code{--traditional} option and
+@cindex @option{--traditional} option @subentry @option{--posix} option and
+@cindex @option{--posix} option @subentry @option{--traditional} option and
If you supply both @option{--traditional} and @option{--posix} on the
command line, @option{--posix} takes precedence. @command{gawk}
issues a warning if both options are supplied.
@@ -6661,13 +6661,13 @@ in @ref{Regexp Operators}.
@end ifnotdocbook
@end ifnottex
-@item @code{--posix}
+@item @option{--posix}
Match only POSIX regexps; the GNU operators are not special
(e.g., @samp{\w} matches a literal @samp{w}). Interval expressions
are allowed.
@cindex Brian Kernighan's @command{awk}
-@item @code{--traditional}
+@item @option{--traditional}
Match traditional Unix @command{awk} regexps. The GNU operators
are not special, and interval expressions are not available.
Because BWK @command{awk} supports them,
@@ -6675,7 +6675,7 @@ the POSIX character classes (@samp{[[:alnum:]]}, etc.)
are available.
Characters described by octal and hexadecimal escape sequences are
treated literally, even if they represent regexp metacharacters.
-@item @code{--re-interval}
+@item @option{--re-interval}
Allow interval expressions in regexps, if @option{--traditional}
has been provided.
Otherwise, interval expressions are available by default.
@@ -14135,8 +14135,8 @@ Field reference.
@cindex @code{+} (plus sign) @subentry @code{++} operator
@cindex plus sign (@code{+}) @subentry @code{++} operator
-@cindex @code{-} (hyphen) @subentry @code{--} operator
-@cindex hyphen (@code{-}) @subentry @code{--} operator
+@cindex @code{-} (hyphen) @subentry @option{--} operator
+@cindex hyphen (@code{-}) @subentry @option{--} operator
@item @code{++ --}
Increment, decrement.
@@ -20700,7 +20700,7 @@ that illustrates the use of these functions:
@cindex @code{bits2str()} user-defined function
@cindex user-defined @subentry function @subentry @code{bits2str()}
-@cindex @code{testbits.awk} program
+@cindex @file{testbits.awk} program
@example
@group
@c file eg/lib/bits2str.awk
@@ -23624,7 +23624,7 @@ mechanism for dealing with files that can't be opened.
However, the
code here provides a portable solution.} You can do this by prepending
the following program to your @command{awk} program:
-@cindex @code{readable.awk} program
+@cindex @file{readable.awk} program
@example
@c file eg/lib/readable.awk
# readable.awk --- library file to skip over unreadable files
@@ -23682,7 +23682,7 @@ in @ref{Filetrans Function}, the following library file
calls a function named
@code{zerofile()} that the user must provide. The arguments passed are
the @value{FN} and the position in @code{ARGV} where it was found:
-@cindex @code{zerofile.awk} program
+@cindex @file{zerofile.awk} program
@example
@c file eg/lib/zerofile.awk
# zerofile.awk --- library file to process empty input files
@@ -23742,7 +23742,7 @@ Some users have suggested an additional command-line
option for @command{gawk}
to disable command-line assignments. However, some simple programming with
a library file does the trick:
-@cindex @code{noassign.awk} program
+@cindex @file{noassign.awk} program
@example
@c file eg/lib/noassign.awk
# noassign.awk --- library file to avoid the need for a
@@ -25380,7 +25380,7 @@ functions needed, and a @code{usage()} function that
prints out a usage
message and exits. @code{usage()} is called if invalid arguments are
supplied:
-@cindex @code{cut.awk} program
+@cindex @file{cut.awk} program
@example
@c file eg/prog/cut.awk
# cut.awk --- implement cut in awk
@@ -25735,7 +25735,7 @@ that processes the command-line arguments with
@code{getopt()}. The @option{-i}
@code{IGNORECASE} predefined variable
(@pxref{Built-in Variables}):
-@cindex @code{egrep.awk} program
+@cindex @file{egrep.awk} program
@example
@c file eg/prog/egrep.awk
# egrep.awk --- simulate egrep in awk
@@ -26002,7 +26002,7 @@ The program is moderately straightforward. All the
work is done in the
It starts with explanatory comments, a list of options,
and then a @code{usage()} function:
-@cindex @code{id.awk} program
+@cindex @file{id.awk} program
@example
@c file eg/prog/id.awk
# id.awk --- implement id in awk
@@ -26403,7 +26403,7 @@ a @code{usage()} function describing the options. The
variable
@code{common} keeps the function's lines short so that they
look nice on the page:
-@cindex @code{split.awk} program
+@cindex @file{split.awk} program
@example
@c file eg/prog/split.awk
# split.awk --- do split in awk
@@ -26721,7 +26721,7 @@ If the first argument is @option{-a}, then the flag
variable
Finally, @command{awk} is forced to read the standard input by setting
@code{ARGV[1]} to @code{"-"} and @code{ARGC} to two:
-@cindex @code{tee.awk} program
+@cindex @file{tee.awk} program
@example
@c file eg/prog/tee.awk
# tee.awk --- tee in awk
@@ -26870,7 +26870,7 @@ and the @code{join()} library function
The program begins with a @code{usage()} function and then a brief outline of
the options and their meanings in comments:
-@cindex @code{uniq.awk} program
+@cindex @file{uniq.awk} program
@example
@c file eg/prog/uniq.awk
@group
@@ -27218,7 +27218,7 @@ The @code{BEGIN} rule does the argument processing.
The variable
@code{print_total} is true if more than one file is named on the
command line:
-@cindex @code{wc.awk} program
+@cindex @file{wc.awk} program
@example
@c file eg/prog/wc.awk
# wc.awk --- count lines, words, characters, bytes
@@ -27415,7 +27415,7 @@ If there are no fields left after removing all the
punctuation, the
current record is skipped. Otherwise, the program loops through each
word, comparing it to the previous one:
-@cindex @code{dupword.awk} program
+@cindex @file{dupword.awk} program
@example
@c file eg/prog/dupword.awk
# dupword.awk --- find duplicate words in text
@@ -27507,7 +27507,7 @@ Just for a change, this program uses a @code{switch}
statement
@code{if}-@code{else} statements instead.
Here is the program:
-@cindex @code{alarm.awk} program
+@cindex @file{alarm.awk} program
@example
@c file eg/prog/alarm.awk
# alarm.awk --- set an alarm
@@ -27703,7 +27703,7 @@ as the target. The main program sets two global
variables, @code{FROM} and
Finally, the processing rule simply calls @code{translate()} for each record:
-@cindex @code{translate.awk} program
+@cindex @file{translate.awk} program
@example
@c file eg/prog/translate.awk
# translate.awk --- do tr-like stuff
@@ -27856,7 +27856,7 @@ that there are two blank lines at the top and two blank
lines at the bottom.
The @code{END} rule arranges to flush the final page of labels; there may
not have been an even multiple of 20 labels in the data:
-@cindex @code{labels.awk} program
+@cindex @file{labels.awk} program
@example
@c file eg/prog/labels.awk
# labels.awk --- print mailing labels
@@ -27987,7 +27987,7 @@ to remove punctuation characters. Finally, we solve
the third problem
by using the system @command{sort} utility to process the output of the
@command{awk} script. Here is the new version of the program:
-@cindex @code{wordfreq.awk} program
+@cindex @file{wordfreq.awk} program
@example
@c file eg/prog/wordfreq.awk
# wordfreq.awk --- print list of word frequencies
@@ -28079,7 +28079,7 @@ Each element of @code{lines} is a unique command, and
the indices of
The @code{END} rule simply prints out the lines, in order:
@cindex Rakitzis, Byron
-@cindex @code{histsort.awk} program
+@cindex @file{histsort.awk} program
@example
@c file eg/prog/histsort.awk
# histsort.awk --- compact a shell history file
@@ -28249,7 +28249,7 @@ The first rule handles calling @code{system()},
checking that a command is
given (@code{NF} is at least three) and also checking that the command
exits with a zero exit status, signifying OK:
-@cindex @code{extract.awk} program
+@cindex @file{extract.awk} program
@example
@c file eg/prog/extract.awk
# extract.awk --- extract files and run programs from Texinfo files
@@ -28991,7 +28991,7 @@ The following program uses arrays of arrays to bring
together
words with the same signature and array sorting to print the words
in sorted order:
-@cindex @code{anagram.awk} program
+@cindex @file{anagram.awk} program
@example
@c file eg/prog/anagram.awk
# anagram.awk --- An implementation of the anagram-finding algorithm
@@ -29275,7 +29275,7 @@ information is printed. Modify the @command{awk}
version
same way.
@item
-The @code{split.awk} program (@pxref{Split Program}) assumes
+The @file{split.awk} program (@pxref{Split Program}) assumes
that letters are contiguous in the character set,
which isn't true for EBCDIC systems.
Fix this problem.
@@ -29535,9 +29535,9 @@ Because it is common to have decimal data with leading
zeros, and because
using this facility could lead to surprising results, the default is to leave
it
disabled. If you want it, you must explicitly request it.
-@cindex programming conventions @subentry @code{--non-decimal-data} option
+@cindex programming conventions @subentry @option{--non-decimal-data} option
@cindex @option{--non-decimal-data} option @subentry @code{strtonum()}
function and
-@cindex @code{strtonum()} function (@command{gawk}) @subentry
@code{--non-decimal-data} option and
+@cindex @code{strtonum()} function (@command{gawk}) @subentry
@option{--non-decimal-data} option and
@quotation CAUTION
@emph{Use of this option is not recommended.}
It can break old programs very badly.
@@ -31365,7 +31365,7 @@ the initial @file{.pot} file:
gawk --gen-pot -f guide.awk > guide.pot
@end example
-@cindex @code{xgettext} utility
+@cindex @command{xgettext} utility
When run with @option{--gen-pot}, @command{gawk} does not execute your
program. Instead, it parses it as usual and prints all marked strings
to standard output in the format of a GNU @command{gettext} Portable Object
@@ -36868,7 +36868,7 @@ variables (such as @code{ARGC} or @code{NF}).
@item awk_bool_t sym_update_ns(const char *name_space, const char *name,
awk_value_t *value);
This is like @code{sym_update()}, but the @code{name_space} parameter allows
you
to specify which namespace @code{name} is part of. @code{name_space} cannot be
-@code{NULL}. If it is @code{""} or @code{"awk}, then @code{name} is searched
+@code{NULL}. If it is @code{""} or @code{"awk"}, then @code{name} is searched
for in the default @code{awk} namespace.
@end table
@@ -39542,7 +39542,7 @@ Next, go to
@url{https://sourceforge.net/projects/gawkextlib/files} to
download @code{gawkextlib} and any extensions that you would like to build.
The @file{README} file at that site explains how to build the code. If you
installed @command{gawk} in a non-standard location, you will need to
-specify @code{./configure --with-gawk=@var{/path/to/gawk}} to find it.
+specify @samp{./configure --with-gawk=@var{/path/to/gawk}} to find it.
You may need to use the @command{sudo} utility
to install both @command{gawk} and @code{gawkextlib}, depending upon
how your system works.
@@ -41704,7 +41704,7 @@ you are using the one compressed with the GNU Gzip
program (@command{gzip}).
Once you have the distribution (e.g.,
@file{gawk-@value{VERSION}.@value{PATCHLEVEL}.tar.gz}),
-use @code{gzip} to expand the
+use @command{gzip} to expand the
file and then use @command{tar} to extract it. You can use the following
pipeline to produce the @command{gawk} distribution:
@@ -41787,11 +41787,12 @@ There are similar files in all of the subdirectories.
@item NEWS
A list of changes to @command{gawk} since the last release or patch.
+There may be similar files in other subdirectories.
@item NEWS.0
@itemx NEWS.1
Older lists of changes to @command{gawk}.
-There are similar files in all of the subdirectories.
+There may be similar files in other subdirectories.
@item COPYING
The GNU General Public License.
@@ -42137,7 +42138,7 @@ command line when compiling @command{gawk} from
scratch, including:
@table @code
@cindex @option{--disable-extensions} configuration option
-@cindex configuration option @subentry @code{--disable-extensions}
+@cindex configuration option @subentry @option{--disable-extensions}
@item --disable-extensions
Disable the extension mechanism within @command{gawk}. With this
option, it is not possible to use dynamic extensions. This also
@@ -42149,7 +42150,7 @@ The default action is to dynamically check if the
extensions
can be configured and compiled.
@cindex @option{--disable-lint} configuration option
-@cindex configuration option @subentry @code{--disable-lint}
+@cindex configuration option @subentry @option{--disable-lint}
@item --disable-lint
Disable all lint checking within @command{gawk}. The
@option{--lint} and @option{--lint-old} options
@@ -42172,21 +42173,21 @@ to fail. This option may be removed at a later date.
@end quotation
@cindex @option{--disable-mpfr} configuration option
-@cindex configuration option @subentry @code{--disable-mpfr}
+@cindex configuration option @subentry @option{--disable-mpfr}
@item --disable-mpfr
Skip checking for the MPFR and GMP libraries. This is useful
mainly for the developers, to make sure nothing breaks if
MPFR support is not available.
@cindex @option{--disable-nls} configuration option
-@cindex configuration option @subentry @code{--disable-nls}
+@cindex configuration option @subentry @option{--disable-nls}
@item --disable-nls
Disable all message-translation facilities.
This is usually not desirable, but it may bring you some slight performance
improvement.
@cindex @option{--enable-versioned-extension-dir} configuration option
-@cindex configuration option @subentry @code{--enable-versioned-extension-dir}
+@cindex configuration option @subentry
@option{--enable-versioned-extension-dir}
@item --enable-versioned-extension-dir
Use a versioned directory for extensions. The directory name will
include the major and minor API versions in it. This makes it possible
@@ -43033,9 +43034,9 @@ not (or not exclusively) in HTML.
understood in common by all the maintainers.}
@end enumerate
-@cindex @code{bug-gawk@@gnu.org} bug reporting address
-@cindex email address for bug reports, @code{bug-gawk@@gnu.org}
-@cindex bug reports, email address, @code{bug-gawk@@gnu.org}
+@cindex @email{bug-gawk@@gnu.org} bug reporting address
+@cindex email address for bug reports, @email{bug-gawk@@gnu.org}
+@cindex bug reports, email address, @email{bug-gawk@@gnu.org}
Once you have a precise problem description, send email to
@EMAIL{bug-gawk@@gnu.org,bug dash gawk at gnu dot org}.
@@ -43856,7 +43857,7 @@ submit your changes.
information.)
Using this format makes it easy for me to apply your changes to the
-master version of the @command{gawk} source code (using @code{patch}).
+master version of the @command{gawk} source code (using @command{patch}).
If I have to apply the changes manually, using a text editor, I may
not do so, particularly if there are lots of changes.
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 4b69f12..a9693ce 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -3770,7 +3770,7 @@ The following list describes options mandated by the
POSIX standard:
@itemx --field-separator @var{fs}
@cindex @option{-F} option
@cindex @option{--field-separator} option
-@cindex @code{FS} variable @subentry @code{--field-separator} option and
+@cindex @code{FS} variable @subentry @option{--field-separator} option and
Set the @code{FS} variable to @var{fs}
(@pxref{Field Separators}).
@@ -4105,7 +4105,7 @@ if @command{gawk} is not compiled to use the GNU MPFR and
MP libraries
@cindex @option{--non-decimal-data} option
@cindex hexadecimal values, enabling interpretation of
@cindex octal values, enabling interpretation of
-@cindex troubleshooting @subentry @code{--non-decimal-data} option
+@cindex troubleshooting @subentry @option{--non-decimal-data} option
Enable automatic interpretation of octal and hexadecimal
values in input data
(@pxref{Nondecimal Data}).
@@ -4210,8 +4210,8 @@ data (@pxref{Locales}).
@c @cindex automatic warnings
@c @cindex warnings, automatic
-@cindex @option{--traditional} option @subentry @code{--posix} option and
-@cindex @option{--posix} option @subentry @code{--traditional} option and
+@cindex @option{--traditional} option @subentry @option{--posix} option and
+@cindex @option{--posix} option @subentry @option{--traditional} option and
If you supply both @option{--traditional} and @option{--posix} on the
command line, @option{--posix} takes precedence. @command{gawk}
issues a warning if both options are supplied.
@@ -6345,13 +6345,13 @@ in @ref{Regexp Operators}.
@end ifnotdocbook
@end ifnottex
-@item @code{--posix}
+@item @option{--posix}
Match only POSIX regexps; the GNU operators are not special
(e.g., @samp{\w} matches a literal @samp{w}). Interval expressions
are allowed.
@cindex Brian Kernighan's @command{awk}
-@item @code{--traditional}
+@item @option{--traditional}
Match traditional Unix @command{awk} regexps. The GNU operators
are not special, and interval expressions are not available.
Because BWK @command{awk} supports them,
@@ -6359,7 +6359,7 @@ the POSIX character classes (@samp{[[:alnum:]]}, etc.)
are available.
Characters described by octal and hexadecimal escape sequences are
treated literally, even if they represent regexp metacharacters.
-@item @code{--re-interval}
+@item @option{--re-interval}
Allow interval expressions in regexps, if @option{--traditional}
has been provided.
Otherwise, interval expressions are available by default.
@@ -13322,8 +13322,8 @@ Field reference.
@cindex @code{+} (plus sign) @subentry @code{++} operator
@cindex plus sign (@code{+}) @subentry @code{++} operator
-@cindex @code{-} (hyphen) @subentry @code{--} operator
-@cindex hyphen (@code{-}) @subentry @code{--} operator
+@cindex @code{-} (hyphen) @subentry @option{--} operator
+@cindex hyphen (@code{-}) @subentry @option{--} operator
@item @code{++ --}
Increment, decrement.
@@ -19680,7 +19680,7 @@ that illustrates the use of these functions:
@cindex @code{bits2str()} user-defined function
@cindex user-defined @subentry function @subentry @code{bits2str()}
-@cindex @code{testbits.awk} program
+@cindex @file{testbits.awk} program
@example
@group
@c file eg/lib/bits2str.awk
@@ -22506,7 +22506,7 @@ mechanism for dealing with files that can't be opened.
However, the
code here provides a portable solution.} You can do this by prepending
the following program to your @command{awk} program:
-@cindex @code{readable.awk} program
+@cindex @file{readable.awk} program
@example
@c file eg/lib/readable.awk
# readable.awk --- library file to skip over unreadable files
@@ -22564,7 +22564,7 @@ in @ref{Filetrans Function}, the following library file
calls a function named
@code{zerofile()} that the user must provide. The arguments passed are
the @value{FN} and the position in @code{ARGV} where it was found:
-@cindex @code{zerofile.awk} program
+@cindex @file{zerofile.awk} program
@example
@c file eg/lib/zerofile.awk
# zerofile.awk --- library file to process empty input files
@@ -22624,7 +22624,7 @@ Some users have suggested an additional command-line
option for @command{gawk}
to disable command-line assignments. However, some simple programming with
a library file does the trick:
-@cindex @code{noassign.awk} program
+@cindex @file{noassign.awk} program
@example
@c file eg/lib/noassign.awk
# noassign.awk --- library file to avoid the need for a
@@ -24262,7 +24262,7 @@ functions needed, and a @code{usage()} function that
prints out a usage
message and exits. @code{usage()} is called if invalid arguments are
supplied:
-@cindex @code{cut.awk} program
+@cindex @file{cut.awk} program
@example
@c file eg/prog/cut.awk
# cut.awk --- implement cut in awk
@@ -24617,7 +24617,7 @@ that processes the command-line arguments with
@code{getopt()}. The @option{-i}
@code{IGNORECASE} predefined variable
(@pxref{Built-in Variables}):
-@cindex @code{egrep.awk} program
+@cindex @file{egrep.awk} program
@example
@c file eg/prog/egrep.awk
# egrep.awk --- simulate egrep in awk
@@ -24884,7 +24884,7 @@ The program is moderately straightforward. All the
work is done in the
It starts with explanatory comments, a list of options,
and then a @code{usage()} function:
-@cindex @code{id.awk} program
+@cindex @file{id.awk} program
@example
@c file eg/prog/id.awk
# id.awk --- implement id in awk
@@ -25285,7 +25285,7 @@ a @code{usage()} function describing the options. The
variable
@code{common} keeps the function's lines short so that they
look nice on the page:
-@cindex @code{split.awk} program
+@cindex @file{split.awk} program
@example
@c file eg/prog/split.awk
# split.awk --- do split in awk
@@ -25603,7 +25603,7 @@ If the first argument is @option{-a}, then the flag
variable
Finally, @command{awk} is forced to read the standard input by setting
@code{ARGV[1]} to @code{"-"} and @code{ARGC} to two:
-@cindex @code{tee.awk} program
+@cindex @file{tee.awk} program
@example
@c file eg/prog/tee.awk
# tee.awk --- tee in awk
@@ -25752,7 +25752,7 @@ and the @code{join()} library function
The program begins with a @code{usage()} function and then a brief outline of
the options and their meanings in comments:
-@cindex @code{uniq.awk} program
+@cindex @file{uniq.awk} program
@example
@c file eg/prog/uniq.awk
@group
@@ -26100,7 +26100,7 @@ The @code{BEGIN} rule does the argument processing.
The variable
@code{print_total} is true if more than one file is named on the
command line:
-@cindex @code{wc.awk} program
+@cindex @file{wc.awk} program
@example
@c file eg/prog/wc.awk
# wc.awk --- count lines, words, characters, bytes
@@ -26297,7 +26297,7 @@ If there are no fields left after removing all the
punctuation, the
current record is skipped. Otherwise, the program loops through each
word, comparing it to the previous one:
-@cindex @code{dupword.awk} program
+@cindex @file{dupword.awk} program
@example
@c file eg/prog/dupword.awk
# dupword.awk --- find duplicate words in text
@@ -26389,7 +26389,7 @@ Just for a change, this program uses a @code{switch}
statement
@code{if}-@code{else} statements instead.
Here is the program:
-@cindex @code{alarm.awk} program
+@cindex @file{alarm.awk} program
@example
@c file eg/prog/alarm.awk
# alarm.awk --- set an alarm
@@ -26585,7 +26585,7 @@ as the target. The main program sets two global
variables, @code{FROM} and
Finally, the processing rule simply calls @code{translate()} for each record:
-@cindex @code{translate.awk} program
+@cindex @file{translate.awk} program
@example
@c file eg/prog/translate.awk
# translate.awk --- do tr-like stuff
@@ -26738,7 +26738,7 @@ that there are two blank lines at the top and two blank
lines at the bottom.
The @code{END} rule arranges to flush the final page of labels; there may
not have been an even multiple of 20 labels in the data:
-@cindex @code{labels.awk} program
+@cindex @file{labels.awk} program
@example
@c file eg/prog/labels.awk
# labels.awk --- print mailing labels
@@ -26869,7 +26869,7 @@ to remove punctuation characters. Finally, we solve
the third problem
by using the system @command{sort} utility to process the output of the
@command{awk} script. Here is the new version of the program:
-@cindex @code{wordfreq.awk} program
+@cindex @file{wordfreq.awk} program
@example
@c file eg/prog/wordfreq.awk
# wordfreq.awk --- print list of word frequencies
@@ -26961,7 +26961,7 @@ Each element of @code{lines} is a unique command, and
the indices of
The @code{END} rule simply prints out the lines, in order:
@cindex Rakitzis, Byron
-@cindex @code{histsort.awk} program
+@cindex @file{histsort.awk} program
@example
@c file eg/prog/histsort.awk
# histsort.awk --- compact a shell history file
@@ -27131,7 +27131,7 @@ The first rule handles calling @code{system()},
checking that a command is
given (@code{NF} is at least three) and also checking that the command
exits with a zero exit status, signifying OK:
-@cindex @code{extract.awk} program
+@cindex @file{extract.awk} program
@example
@c file eg/prog/extract.awk
# extract.awk --- extract files and run programs from Texinfo files
@@ -27873,7 +27873,7 @@ The following program uses arrays of arrays to bring
together
words with the same signature and array sorting to print the words
in sorted order:
-@cindex @code{anagram.awk} program
+@cindex @file{anagram.awk} program
@example
@c file eg/prog/anagram.awk
# anagram.awk --- An implementation of the anagram-finding algorithm
@@ -28157,7 +28157,7 @@ information is printed. Modify the @command{awk}
version
same way.
@item
-The @code{split.awk} program (@pxref{Split Program}) assumes
+The @file{split.awk} program (@pxref{Split Program}) assumes
that letters are contiguous in the character set,
which isn't true for EBCDIC systems.
Fix this problem.
@@ -28417,9 +28417,9 @@ Because it is common to have decimal data with leading
zeros, and because
using this facility could lead to surprising results, the default is to leave
it
disabled. If you want it, you must explicitly request it.
-@cindex programming conventions @subentry @code{--non-decimal-data} option
+@cindex programming conventions @subentry @option{--non-decimal-data} option
@cindex @option{--non-decimal-data} option @subentry @code{strtonum()}
function and
-@cindex @code{strtonum()} function (@command{gawk}) @subentry
@code{--non-decimal-data} option and
+@cindex @code{strtonum()} function (@command{gawk}) @subentry
@option{--non-decimal-data} option and
@quotation CAUTION
@emph{Use of this option is not recommended.}
It can break old programs very badly.
@@ -30247,7 +30247,7 @@ the initial @file{.pot} file:
gawk --gen-pot -f guide.awk > guide.pot
@end example
-@cindex @code{xgettext} utility
+@cindex @command{xgettext} utility
When run with @option{--gen-pot}, @command{gawk} does not execute your
program. Instead, it parses it as usual and prints all marked strings
to standard output in the format of a GNU @command{gettext} Portable Object
@@ -35711,7 +35711,7 @@ variables (such as @code{ARGC} or @code{NF}).
@item awk_bool_t sym_update_ns(const char *name_space, const char *name,
awk_value_t *value);
This is like @code{sym_update()}, but the @code{name_space} parameter allows
you
to specify which namespace @code{name} is part of. @code{name_space} cannot be
-@code{NULL}. If it is @code{""} or @code{"awk}, then @code{name} is searched
+@code{NULL}. If it is @code{""} or @code{"awk"}, then @code{name} is searched
for in the default @code{awk} namespace.
@end table
@@ -38385,7 +38385,7 @@ Next, go to
@url{https://sourceforge.net/projects/gawkextlib/files} to
download @code{gawkextlib} and any extensions that you would like to build.
The @file{README} file at that site explains how to build the code. If you
installed @command{gawk} in a non-standard location, you will need to
-specify @code{./configure --with-gawk=@var{/path/to/gawk}} to find it.
+specify @samp{./configure --with-gawk=@var{/path/to/gawk}} to find it.
You may need to use the @command{sudo} utility
to install both @command{gawk} and @code{gawkextlib}, depending upon
how your system works.
@@ -40547,7 +40547,7 @@ you are using the one compressed with the GNU Gzip
program (@command{gzip}).
Once you have the distribution (e.g.,
@file{gawk-@value{VERSION}.@value{PATCHLEVEL}.tar.gz}),
-use @code{gzip} to expand the
+use @command{gzip} to expand the
file and then use @command{tar} to extract it. You can use the following
pipeline to produce the @command{gawk} distribution:
@@ -40630,11 +40630,12 @@ There are similar files in all of the subdirectories.
@item NEWS
A list of changes to @command{gawk} since the last release or patch.
+There may be similar files in other subdirectories.
@item NEWS.0
@itemx NEWS.1
Older lists of changes to @command{gawk}.
-There are similar files in all of the subdirectories.
+There may be similar files in other subdirectories.
@item COPYING
The GNU General Public License.
@@ -40980,7 +40981,7 @@ command line when compiling @command{gawk} from
scratch, including:
@table @code
@cindex @option{--disable-extensions} configuration option
-@cindex configuration option @subentry @code{--disable-extensions}
+@cindex configuration option @subentry @option{--disable-extensions}
@item --disable-extensions
Disable the extension mechanism within @command{gawk}. With this
option, it is not possible to use dynamic extensions. This also
@@ -40992,7 +40993,7 @@ The default action is to dynamically check if the
extensions
can be configured and compiled.
@cindex @option{--disable-lint} configuration option
-@cindex configuration option @subentry @code{--disable-lint}
+@cindex configuration option @subentry @option{--disable-lint}
@item --disable-lint
Disable all lint checking within @command{gawk}. The
@option{--lint} and @option{--lint-old} options
@@ -41015,21 +41016,21 @@ to fail. This option may be removed at a later date.
@end quotation
@cindex @option{--disable-mpfr} configuration option
-@cindex configuration option @subentry @code{--disable-mpfr}
+@cindex configuration option @subentry @option{--disable-mpfr}
@item --disable-mpfr
Skip checking for the MPFR and GMP libraries. This is useful
mainly for the developers, to make sure nothing breaks if
MPFR support is not available.
@cindex @option{--disable-nls} configuration option
-@cindex configuration option @subentry @code{--disable-nls}
+@cindex configuration option @subentry @option{--disable-nls}
@item --disable-nls
Disable all message-translation facilities.
This is usually not desirable, but it may bring you some slight performance
improvement.
@cindex @option{--enable-versioned-extension-dir} configuration option
-@cindex configuration option @subentry @code{--enable-versioned-extension-dir}
+@cindex configuration option @subentry
@option{--enable-versioned-extension-dir}
@item --enable-versioned-extension-dir
Use a versioned directory for extensions. The directory name will
include the major and minor API versions in it. This makes it possible
@@ -41876,9 +41877,9 @@ not (or not exclusively) in HTML.
understood in common by all the maintainers.}
@end enumerate
-@cindex @code{bug-gawk@@gnu.org} bug reporting address
-@cindex email address for bug reports, @code{bug-gawk@@gnu.org}
-@cindex bug reports, email address, @code{bug-gawk@@gnu.org}
+@cindex @email{bug-gawk@@gnu.org} bug reporting address
+@cindex email address for bug reports, @email{bug-gawk@@gnu.org}
+@cindex bug reports, email address, @email{bug-gawk@@gnu.org}
Once you have a precise problem description, send email to
@EMAIL{bug-gawk@@gnu.org,bug dash gawk at gnu dot org}.
@@ -42699,7 +42700,7 @@ submit your changes.
information.)
Using this format makes it easy for me to apply your changes to the
-master version of the @command{gawk} source code (using @code{patch}).
+master version of the @command{gawk} source code (using @command{patch}).
If I have to apply the changes manually, using a text editor, I may
not do so, particularly if there are lots of changes.
-----------------------------------------------------------------------
Summary of changes:
doc/ChangeLog | 5 ++
doc/gawk.info | 270 ++++++++++++++++++++++++++++----------------------------
doc/gawk.texi | 91 +++++++++----------
doc/gawktexi.in | 91 +++++++++----------
4 files changed, 233 insertions(+), 224 deletions(-)
hooks/post-receive
--
gawk
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [SCM] gawk branch, gawk-5.1-stable, updated. gawk-4.1.0-4316-gd249840,
Arnold Robbins <=