aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
Diffstat
-rw-r--r--doc/ChangeLog5
-rw-r--r--doc/gawk.info277
-rw-r--r--doc/gawk.texi90
-rw-r--r--doc/gawktexi.in90
4 files changed, 204 insertions, 258 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index c71ec99e..3edc0f37 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2014-05-20 Arnold D. Robbins <arnold@skeeve.com>
+
+ * gawktexi.in: Misc improvements for docbook, consistency
+ in table and figure captions.
+
2014-05-17 Arnold D. Robbins <arnold@skeeve.com>
* gawktexi.in: Edits through Chapter 16.
diff --git a/doc/gawk.info b/doc/gawk.info
index e860045e..55cc9829 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -21383,7 +21383,7 @@ binary format.
`"quad"' Basic 128-bit quadruple precision.
`"oct"' 256-bit octuple precision.
-Table 15.3: Predefined precision strings for `PREC'
+Table 15.3: Predefined Precision Strings For `PREC'
The following example illustrates the effects of changing precision
on arithmetic operations:
@@ -21761,7 +21761,8 @@ File: gawk.info, Node: Extension Mechanism Outline, Next: Extension API Descri
Communication between `gawk' and an extension is two-way. First, when
an extension is loaded, it is passed a pointer to a `struct' whose
-fields are function pointers. This is shown in *note load-extension::.
+fields are function pointers. This is shown in *note
+figure-load-extension::.
API
Struct
@@ -21793,7 +21794,7 @@ Figure 16.1: Loading The Extension
function pointers, at runtime, without needing (link-time) access to
`gawk''s symbols. One of these function pointers is to a function for
"registering" new built-in functions. This is shown in *note
-load-new-function::.
+figure-load-new-function::.
register_ext_func({ "chdir", do_chdir, 1 });
@@ -21813,7 +21814,7 @@ Figure 16.2: Loading The New Function
with `gawk' by passing function pointers to the functions that provide
the new feature (`do_chdir()', for example). `gawk' associates the
function pointer with a name and can then call it, using a defined
-calling convention. This is shown in *note call-new-function::.
+calling convention. This is shown in *note figure-call-new-function::.
BEGIN {
chdir("/path") (*fnptr)(1);
@@ -22188,7 +22189,7 @@ Requested: Scalar Scalar Scalar false false
Value false false false false
Cookie
-Table 16.1: Value Types Returned
+Table 16.1: API Value Types Returned

File: gawk.info, Node: Memory Allocation Functions, Next: Constructor Functions, Prev: Requesting Values, Up: Extension API Description
@@ -24826,7 +24827,7 @@ Letter File Type
`s' Socket
`u' Anything else (unknown)
-Table 16.2: File types returned by `readdir()'
+Table 16.2: File Types Returned By `readdir()'
On systems without the file type information, the third field is
always `u'.
@@ -33607,137 +33608,137 @@ Node: Dynamic Extensions874884
Node: Extension Intro876342
Node: Plugin License877607
Node: Extension Mechanism Outline878292
-Ref: load-extension878709
-Ref: load-new-function880187
-Ref: call-new-function881182
-Node: Extension API Description883166
-Node: Extension API Functions Introduction884616
-Node: General Data Types889482
-Ref: General Data Types-Footnote-1895175
-Node: Requesting Values895474
-Ref: table-value-types-returned896211
-Node: Memory Allocation Functions897165
-Ref: Memory Allocation Functions-Footnote-1899911
-Node: Constructor Functions900007
-Node: Registration Functions901765
-Node: Extension Functions902450
-Node: Exit Callback Functions904752
-Node: Extension Version String906001
-Node: Input Parsers906651
-Node: Output Wrappers916454
-Node: Two-way processors920970
-Node: Printing Messages923173
-Ref: Printing Messages-Footnote-1924250
-Node: Updating `ERRNO'924402
-Node: Accessing Parameters925141
-Node: Symbol Table Access926371
-Node: Symbol table by name926885
-Node: Symbol table by cookie928861
-Ref: Symbol table by cookie-Footnote-1932994
-Node: Cached values933057
-Ref: Cached values-Footnote-1936562
-Node: Array Manipulation936653
-Ref: Array Manipulation-Footnote-1937751
-Node: Array Data Types937790
-Ref: Array Data Types-Footnote-1940493
-Node: Array Functions940585
-Node: Flattening Arrays944459
-Node: Creating Arrays951311
-Node: Extension API Variables956042
-Node: Extension Versioning956678
-Node: Extension API Informational Variables958579
-Node: Extension API Boilerplate959665
-Node: Finding Extensions963469
-Node: Extension Example964029
-Node: Internal File Description964759
-Node: Internal File Ops968850
-Ref: Internal File Ops-Footnote-1980396
-Node: Using Internal File Ops980536
-Ref: Using Internal File Ops-Footnote-1982883
-Node: Extension Samples983149
-Node: Extension Sample File Functions984673
-Node: Extension Sample Fnmatch992240
-Node: Extension Sample Fork993719
-Node: Extension Sample Inplace994932
-Node: Extension Sample Ord996710
-Node: Extension Sample Readdir997546
-Ref: table-readdir-file-types998401
-Node: Extension Sample Revout999200
-Node: Extension Sample Rev2way999791
-Node: Extension Sample Read write array1000532
-Node: Extension Sample Readfile1002411
-Node: Extension Sample API Tests1003511
-Node: Extension Sample Time1004036
-Node: gawkextlib1005351
-Node: Language History1008132
-Node: V7/SVR3.11009725
-Node: SVR41012045
-Node: POSIX1013487
-Node: BTL1014873
-Node: POSIX/GNU1015607
-Node: Feature History1021206
-Node: Common Extensions1034182
-Node: Ranges and Locales1035494
-Ref: Ranges and Locales-Footnote-11040111
-Ref: Ranges and Locales-Footnote-21040138
-Ref: Ranges and Locales-Footnote-31040372
-Node: Contributors1040593
-Node: Installation1045974
-Node: Gawk Distribution1046868
-Node: Getting1047352
-Node: Extracting1048178
-Node: Distribution contents1049870
-Node: Unix Installation1055591
-Node: Quick Installation1056208
-Node: Additional Configuration Options1058654
-Node: Configuration Philosophy1060390
-Node: Non-Unix Installation1062744
-Node: PC Installation1063202
-Node: PC Binary Installation1064513
-Node: PC Compiling1066361
-Node: PC Testing1069321
-Node: PC Using1070497
-Node: Cygwin1074665
-Node: MSYS1075474
-Node: VMS Installation1075988
-Node: VMS Compilation1076784
-Ref: VMS Compilation-Footnote-11078036
-Node: VMS Dynamic Extensions1078094
-Node: VMS Installation Details1079467
-Node: VMS Running1081718
-Node: VMS GNV1084552
-Node: VMS Old Gawk1085275
-Node: Bugs1085745
-Node: Other Versions1089663
-Node: Notes1095747
-Node: Compatibility Mode1096547
-Node: Additions1097330
-Node: Accessing The Source1098257
-Node: Adding Code1099697
-Node: New Ports1105742
-Node: Derived Files1109877
-Ref: Derived Files-Footnote-11115198
-Ref: Derived Files-Footnote-21115232
-Ref: Derived Files-Footnote-31115832
-Node: Future Extensions1115930
-Node: Implementation Limitations1116513
-Node: Extension Design1117761
-Node: Old Extension Problems1118915
-Ref: Old Extension Problems-Footnote-11120423
-Node: Extension New Mechanism Goals1120480
-Ref: Extension New Mechanism Goals-Footnote-11123845
-Node: Extension Other Design Decisions1124031
-Node: Extension Future Growth1126137
-Node: Old Extension Mechanism1126973
-Node: Basic Concepts1128713
-Node: Basic High Level1129394
-Ref: figure-general-flow1129666
-Ref: figure-process-flow1130265
-Ref: Basic High Level-Footnote-11133494
-Node: Basic Data Typing1133679
-Node: Glossary1137034
-Node: Copying1162265
-Node: GNU Free Documentation License1199821
-Node: Index1224957
+Ref: figure-load-extension878716
+Ref: figure-load-new-function880201
+Ref: figure-call-new-function881203
+Node: Extension API Description883187
+Node: Extension API Functions Introduction884637
+Node: General Data Types889503
+Ref: General Data Types-Footnote-1895196
+Node: Requesting Values895495
+Ref: table-value-types-returned896232
+Node: Memory Allocation Functions897190
+Ref: Memory Allocation Functions-Footnote-1899936
+Node: Constructor Functions900032
+Node: Registration Functions901790
+Node: Extension Functions902475
+Node: Exit Callback Functions904777
+Node: Extension Version String906026
+Node: Input Parsers906676
+Node: Output Wrappers916479
+Node: Two-way processors920995
+Node: Printing Messages923198
+Ref: Printing Messages-Footnote-1924275
+Node: Updating `ERRNO'924427
+Node: Accessing Parameters925166
+Node: Symbol Table Access926396
+Node: Symbol table by name926910
+Node: Symbol table by cookie928886
+Ref: Symbol table by cookie-Footnote-1933019
+Node: Cached values933082
+Ref: Cached values-Footnote-1936587
+Node: Array Manipulation936678
+Ref: Array Manipulation-Footnote-1937776
+Node: Array Data Types937815
+Ref: Array Data Types-Footnote-1940518
+Node: Array Functions940610
+Node: Flattening Arrays944484
+Node: Creating Arrays951336
+Node: Extension API Variables956067
+Node: Extension Versioning956703
+Node: Extension API Informational Variables958604
+Node: Extension API Boilerplate959690
+Node: Finding Extensions963494
+Node: Extension Example964054
+Node: Internal File Description964784
+Node: Internal File Ops968875
+Ref: Internal File Ops-Footnote-1980421
+Node: Using Internal File Ops980561
+Ref: Using Internal File Ops-Footnote-1982908
+Node: Extension Samples983174
+Node: Extension Sample File Functions984698
+Node: Extension Sample Fnmatch992265
+Node: Extension Sample Fork993744
+Node: Extension Sample Inplace994957
+Node: Extension Sample Ord996735
+Node: Extension Sample Readdir997571
+Ref: table-readdir-file-types998426
+Node: Extension Sample Revout999225
+Node: Extension Sample Rev2way999816
+Node: Extension Sample Read write array1000557
+Node: Extension Sample Readfile1002436
+Node: Extension Sample API Tests1003536
+Node: Extension Sample Time1004061
+Node: gawkextlib1005376
+Node: Language History1008157
+Node: V7/SVR3.11009750
+Node: SVR41012070
+Node: POSIX1013512
+Node: BTL1014898
+Node: POSIX/GNU1015632
+Node: Feature History1021231
+Node: Common Extensions1034207
+Node: Ranges and Locales1035519
+Ref: Ranges and Locales-Footnote-11040136
+Ref: Ranges and Locales-Footnote-21040163
+Ref: Ranges and Locales-Footnote-31040397
+Node: Contributors1040618
+Node: Installation1045999
+Node: Gawk Distribution1046893
+Node: Getting1047377
+Node: Extracting1048203
+Node: Distribution contents1049895
+Node: Unix Installation1055616
+Node: Quick Installation1056233
+Node: Additional Configuration Options1058679
+Node: Configuration Philosophy1060415
+Node: Non-Unix Installation1062769
+Node: PC Installation1063227
+Node: PC Binary Installation1064538
+Node: PC Compiling1066386
+Node: PC Testing1069346
+Node: PC Using1070522
+Node: Cygwin1074690
+Node: MSYS1075499
+Node: VMS Installation1076013
+Node: VMS Compilation1076809
+Ref: VMS Compilation-Footnote-11078061
+Node: VMS Dynamic Extensions1078119
+Node: VMS Installation Details1079492
+Node: VMS Running1081743
+Node: VMS GNV1084577
+Node: VMS Old Gawk1085300
+Node: Bugs1085770
+Node: Other Versions1089688
+Node: Notes1095772
+Node: Compatibility Mode1096572
+Node: Additions1097355
+Node: Accessing The Source1098282
+Node: Adding Code1099722
+Node: New Ports1105767
+Node: Derived Files1109902
+Ref: Derived Files-Footnote-11115223
+Ref: Derived Files-Footnote-21115257
+Ref: Derived Files-Footnote-31115857
+Node: Future Extensions1115955
+Node: Implementation Limitations1116538
+Node: Extension Design1117786
+Node: Old Extension Problems1118940
+Ref: Old Extension Problems-Footnote-11120448
+Node: Extension New Mechanism Goals1120505
+Ref: Extension New Mechanism Goals-Footnote-11123870
+Node: Extension Other Design Decisions1124056
+Node: Extension Future Growth1126162
+Node: Old Extension Mechanism1126998
+Node: Basic Concepts1128738
+Node: Basic High Level1129419
+Ref: figure-general-flow1129691
+Ref: figure-process-flow1130290
+Ref: Basic High Level-Footnote-11133519
+Node: Basic Data Typing1133704
+Node: Glossary1137059
+Node: Copying1162290
+Node: GNU Free Documentation License1199846
+Node: Index1224982

End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index eeacd2c6..e0222443 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -1571,12 +1571,14 @@ contains additional appendices and other end material.
To save space, we have omitted them from the
printed edition. You may find them online, as follows:
-@uref{http://www.gnu.org/software/gawk/manual/html_node/Notes.html}
+@uref{http://www.gnu.org/software/gawk/manual/html_node/Notes.html,
+The appendix on implementation notes}
describes how to disable @command{gawk}'s extensions, as
well as how to contribute new code to @command{gawk},
and some possible future directions for @command{gawk} development.
-@uref{http://www.gnu.org/software/gawk/manual/html_node/Basic-Concepts.html}
+@uref{http://www.gnu.org/software/gawk/manual/html_node/Basic-Concepts.html,
+The appendix on basic concepts}
provides some very cursory background material for those who
are completely unfamiliar with computer programming.
@@ -2064,9 +2066,6 @@ May, 2014
@ifdocbook
-@docbook
-<partintro>
-@end docbook
Part I describes the @command{awk} language and @command{gawk} program
in detail. It starts with the basics, and continues through all of
the features of @command{awk}. Included also are many, but not all,
@@ -2101,9 +2100,6 @@ following chapters:
@item
@ref{Functions}.
@end itemize
-@docbook
-</partintro>
-@end docbook
@end ifdocbook
@node Getting Started
@@ -18152,8 +18148,7 @@ Operands | 0 | 1 | 0 | 1 | 0 | 1
@end tex
@docbook
-<table id="table-bitwise-ops">
-<title>Bitwise Operations</title>
+<informaltable>
<tgroup cols="7" colsep="1">
<colspec colname="c1"/>
@@ -18213,7 +18208,7 @@ Operands | 0 | 1 | 0 | 1 | 0 | 1
</tbody>
</tgroup>
-</table>
+</informaltable>
@end docbook
@end float
@@ -19518,10 +19513,6 @@ for (i = 1; i <= n; i++)
@end ifnotinfo
@ifdocbook
-
-@docbook
-<partintro>
-@end docbook
Part II shows how to use @command{awk} and @command{gawk} for problem solving.
There is lots of code here for you to read and learn from.
It contains the following chapters:
@@ -19533,9 +19524,6 @@ It contains the following chapters:
@item
@ref{Sample Programs}.
@end itemize
-@docbook
-</partintro>
-@end docbook
@end ifdocbook
@node Library Functions
@@ -25621,10 +25609,6 @@ BEGIN {
@end ifnotinfo
@ifdocbook
-
-@docbook
-<partintro>
-@end docbook
Part III focuses on features specific to @command{gawk}.
It contains the following chapters:
@@ -25644,9 +25628,6 @@ It contains the following chapters:
@item
@ref{Dynamic Extensions}.
@end itemize
-@docbook
-</partintro>
-@end docbook
@end ifdocbook
@node Advanced Features
@@ -29797,7 +29778,7 @@ shown in @ref{table-predefined-precision-strings},
to emulate an IEEE 754 binary format.
@float Table,table-predefined-precision-strings
-@caption{Predefined precision strings for @code{PREC}}
+@caption{Predefined Precision Strings For @code{PREC}}
@multitable {@code{"double"}} {12345678901234567890123456789012345}
@headitem @code{PREC} @tab IEEE 754 Binary Format
@item @code{"half"} @tab 16-bit half-precision.
@@ -30253,30 +30234,30 @@ Communication between
is loaded, it is passed a pointer to a @code{struct} whose fields are
function pointers.
@ifnotdocbook
-This is shown in @ref{load-extension}.
+This is shown in @ref{figure-load-extension}.
@end ifnotdocbook
@ifdocbook
-This is shown in @inlineraw{docbook, <xref linkend="load-extension"/>}.
+This is shown in @inlineraw{docbook, <xref linkend="figure-load-extension"/>}.
@end ifdocbook
@ifnotdocbook
-@float Figure,load-extension
+@float Figure,figure-load-extension
@caption{Loading The Extension}
@c FIXME: One day, it should not be necessary to have two cases,
@c but rather just the one without the "txt" final argument.
@c This applies to the other figures as well.
@ifinfo
-@center @image{api-figure1, , , Loading the extension, txt}
+@center @image{api-figure1, , , Loading The Extension, txt}
@end ifinfo
@ifnotinfo
-@center @image{api-figure1, , , Loading the extension}
+@center @image{api-figure1, , , Loading The Extension}
@end ifnotinfo
@end float
@end ifnotdocbook
@docbook
-<figure id="load-extension">
-<title>Loading the extension</title>
+<figure id="figure-load-extension">
+<title>Loading The Extension</title>
<graphic fileref="api-figure1.eps"/>
</figure>
@end docbook
@@ -30286,27 +30267,27 @@ function pointers, at runtime, without needing (link-time) access
to @command{gawk}'s symbols. One of these function pointers is to a
function for ``registering'' new built-in functions.
@ifnotdocbook
-This is shown in @ref{load-new-function}.
+This is shown in @ref{figure-load-new-function}.
@end ifnotdocbook
@ifdocbook
-This is shown in @inlineraw{docbook, <xref linkend="load-new-function"/>}.
+This is shown in @inlineraw{docbook, <xref linkend="figure-load-new-function"/>}.
@end ifdocbook
@ifnotdocbook
-@float Figure,load-new-function
+@float Figure,figure-load-new-function
@caption{Loading The New Function}
@ifinfo
-@center @image{api-figure2, , , Loading the new function, txt}
+@center @image{api-figure2, , , Loading The New Function, txt}
@end ifinfo
@ifnotinfo
-@center @image{api-figure2, , , Loading the new function}
+@center @image{api-figure2, , , Loading The New Function}
@end ifnotinfo
@end float
@end ifnotdocbook
@docbook
-<figure id="load-new-function">
-<title>Loading the new function</title>
+<figure id="figure-load-new-function">
+<title>Loading The New Function</title>
<graphic fileref="api-figure2.eps"/>
</figure>
@end docbook
@@ -30317,14 +30298,14 @@ provide the new feature (@code{do_chdir()}, for example). @command{gawk}
associates the function pointer with a name and can then call it, using a
defined calling convention.
@ifnotdocbook
-This is shown in @ref{call-new-function}.
+This is shown in @ref{figure-call-new-function}.
@end ifnotdocbook
@ifdocbook
-This is shown in @inlineraw{docbook, <xref linkend="call-new-function"/>}.
+This is shown in @inlineraw{docbook, <xref linkend="figure-call-new-function"/>}.
@end ifdocbook
@ifnotdocbook
-@float Figure,call-new-function
+@float Figure,figure-call-new-function
@caption{Calling The New Function}
@ifinfo
@center @image{api-figure3, , , Calling the new function, txt}
@@ -30336,7 +30317,7 @@ This is shown in @inlineraw{docbook, <xref linkend="call-new-function"/>}.
@end ifnotdocbook
@docbook
-<figure id="call-new-function">
+<figure id="figure-call-new-function">
<title>Calling The New Function</title>
<graphic fileref="api-figure3.eps"/>
</figure>
@@ -30719,9 +30700,9 @@ value type, as appropriate. This behavior is summarized in
@ref{table-value-types-returned}.
@c FIXME: Try to do this with spans...
-@ifdocbook
-@anchor{table-value-types-returned}
-@end ifdocbook
+
+@float Table,table-value-types-returned
+@caption{API Value Types Returned}
@docbook
<informaltable>
<tgroup cols="2">
@@ -30806,8 +30787,6 @@ value type, as appropriate. This behavior is summarized in
@ifnotplaintext
@ifnotdocbook
-@float Table,table-value-types-returned
-@caption{Value Types Returned}
@multitable @columnfractions .50 .50
@headitem @tab Type of Actual Value:
@end multitable
@@ -30820,12 +30799,9 @@ value type, as appropriate. This behavior is summarized in
@item @tab @b{Undefined} @tab String @tab Number @tab Array @tab Undefined
@item @tab @b{Value Cookie} @tab false @tab false @tab false @tab false
@end multitable
-@end float
@end ifnotdocbook
@end ifnotplaintext
@ifplaintext
-@float Table,table-value-types-returned
-@caption{Value Types Returned}
@example
+-------------------------------------------------+
| Type of Actual Value: |
@@ -30849,8 +30825,8 @@ value type, as appropriate. This behavior is summarized in
| | Cookie | | | | |
+-----------+-----------+------------+------------+-----------+-----------+
@end example
-@end float
@end ifplaintext
+@end float
@node Memory Allocation Functions
@subsection Memory Allocation Functions and Convenience Macros
@@ -33722,7 +33698,7 @@ indicating the type of the file. The letters are file types are shown
in @ref{table-readdir-file-types}.
@float Table,table-readdir-file-types
-@caption{File types returned by @code{readdir()}}
+@caption{File Types Returned By @code{readdir()}}
@multitable @columnfractions .1 .9
@headitem Letter @tab File Type
@item @code{b} @tab Block device
@@ -34025,9 +34001,6 @@ See the project's web site for more information.
@ifdocbook
-@docbook
-<partintro>
-@end docbook
@ifclear FOR_PRINT
Part IV contains the appendixes (including the two licenses that cover
the @command{gawk} source code and this @value{DOCUMENT}, respectively)
@@ -34062,9 +34035,6 @@ Part IV contains two appendixes:
@ref{GNU Free Documentation License}.
@end ifclear
@end itemize
-@docbook
-</partintro>
-@end docbook
@end ifdocbook
@node Language History
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 17d52797..3599b727 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -1538,12 +1538,14 @@ contains additional appendices and other end material.
To save space, we have omitted them from the
printed edition. You may find them online, as follows:
-@uref{http://www.gnu.org/software/gawk/manual/html_node/Notes.html}
+@uref{http://www.gnu.org/software/gawk/manual/html_node/Notes.html,
+The appendix on implementation notes}
describes how to disable @command{gawk}'s extensions, as
well as how to contribute new code to @command{gawk},
and some possible future directions for @command{gawk} development.
-@uref{http://www.gnu.org/software/gawk/manual/html_node/Basic-Concepts.html}
+@uref{http://www.gnu.org/software/gawk/manual/html_node/Basic-Concepts.html,
+The appendix on basic concepts}
provides some very cursory background material for those who
are completely unfamiliar with computer programming.
@@ -2031,9 +2033,6 @@ May, 2014
@ifdocbook
-@docbook
-<partintro>
-@end docbook
Part I describes the @command{awk} language and @command{gawk} program
in detail. It starts with the basics, and continues through all of
the features of @command{awk}. Included also are many, but not all,
@@ -2068,9 +2067,6 @@ following chapters:
@item
@ref{Functions}.
@end itemize
-@docbook
-</partintro>
-@end docbook
@end ifdocbook
@node Getting Started
@@ -17325,8 +17321,7 @@ Operands | 0 | 1 | 0 | 1 | 0 | 1
@end tex
@docbook
-<table id="table-bitwise-ops">
-<title>Bitwise Operations</title>
+<informaltable>
<tgroup cols="7" colsep="1">
<colspec colname="c1"/>
@@ -17386,7 +17381,7 @@ Operands | 0 | 1 | 0 | 1 | 0 | 1
</tbody>
</tgroup>
-</table>
+</informaltable>
@end docbook
@end float
@@ -18691,10 +18686,6 @@ for (i = 1; i <= n; i++)
@end ifnotinfo
@ifdocbook
-
-@docbook
-<partintro>
-@end docbook
Part II shows how to use @command{awk} and @command{gawk} for problem solving.
There is lots of code here for you to read and learn from.
It contains the following chapters:
@@ -18706,9 +18697,6 @@ It contains the following chapters:
@item
@ref{Sample Programs}.
@end itemize
-@docbook
-</partintro>
-@end docbook
@end ifdocbook
@node Library Functions
@@ -24765,10 +24753,6 @@ BEGIN {
@end ifnotinfo
@ifdocbook
-
-@docbook
-<partintro>
-@end docbook
Part III focuses on features specific to @command{gawk}.
It contains the following chapters:
@@ -24788,9 +24772,6 @@ It contains the following chapters:
@item
@ref{Dynamic Extensions}.
@end itemize
-@docbook
-</partintro>
-@end docbook
@end ifdocbook
@node Advanced Features
@@ -28941,7 +28922,7 @@ shown in @ref{table-predefined-precision-strings},
to emulate an IEEE 754 binary format.
@float Table,table-predefined-precision-strings
-@caption{Predefined precision strings for @code{PREC}}
+@caption{Predefined Precision Strings For @code{PREC}}
@multitable {@code{"double"}} {12345678901234567890123456789012345}
@headitem @code{PREC} @tab IEEE 754 Binary Format
@item @code{"half"} @tab 16-bit half-precision.
@@ -29397,30 +29378,30 @@ Communication between
is loaded, it is passed a pointer to a @code{struct} whose fields are
function pointers.
@ifnotdocbook
-This is shown in @ref{load-extension}.
+This is shown in @ref{figure-load-extension}.
@end ifnotdocbook
@ifdocbook
-This is shown in @inlineraw{docbook, <xref linkend="load-extension"/>}.
+This is shown in @inlineraw{docbook, <xref linkend="figure-load-extension"/>}.
@end ifdocbook
@ifnotdocbook
-@float Figure,load-extension
+@float Figure,figure-load-extension
@caption{Loading The Extension}
@c FIXME: One day, it should not be necessary to have two cases,
@c but rather just the one without the "txt" final argument.
@c This applies to the other figures as well.
@ifinfo
-@center @image{api-figure1, , , Loading the extension, txt}
+@center @image{api-figure1, , , Loading The Extension, txt}
@end ifinfo
@ifnotinfo
-@center @image{api-figure1, , , Loading the extension}
+@center @image{api-figure1, , , Loading The Extension}
@end ifnotinfo
@end float
@end ifnotdocbook
@docbook
-<figure id="load-extension">
-<title>Loading the extension</title>
+<figure id="figure-load-extension">
+<title>Loading The Extension</title>
<graphic fileref="api-figure1.eps"/>
</figure>
@end docbook
@@ -29430,27 +29411,27 @@ function pointers, at runtime, without needing (link-time) access
to @command{gawk}'s symbols. One of these function pointers is to a
function for ``registering'' new built-in functions.
@ifnotdocbook
-This is shown in @ref{load-new-function}.
+This is shown in @ref{figure-load-new-function}.
@end ifnotdocbook
@ifdocbook
-This is shown in @inlineraw{docbook, <xref linkend="load-new-function"/>}.
+This is shown in @inlineraw{docbook, <xref linkend="figure-load-new-function"/>}.
@end ifdocbook
@ifnotdocbook
-@float Figure,load-new-function
+@float Figure,figure-load-new-function
@caption{Loading The New Function}
@ifinfo
-@center @image{api-figure2, , , Loading the new function, txt}
+@center @image{api-figure2, , , Loading The New Function, txt}
@end ifinfo
@ifnotinfo
-@center @image{api-figure2, , , Loading the new function}
+@center @image{api-figure2, , , Loading The New Function}
@end ifnotinfo
@end float
@end ifnotdocbook
@docbook
-<figure id="load-new-function">
-<title>Loading the new function</title>
+<figure id="figure-load-new-function">
+<title>Loading The New Function</title>
<graphic fileref="api-figure2.eps"/>
</figure>
@end docbook
@@ -29461,14 +29442,14 @@ provide the new feature (@code{do_chdir()}, for example). @command{gawk}
associates the function pointer with a name and can then call it, using a
defined calling convention.
@ifnotdocbook
-This is shown in @ref{call-new-function}.
+This is shown in @ref{figure-call-new-function}.
@end ifnotdocbook
@ifdocbook
-This is shown in @inlineraw{docbook, <xref linkend="call-new-function"/>}.
+This is shown in @inlineraw{docbook, <xref linkend="figure-call-new-function"/>}.
@end ifdocbook
@ifnotdocbook
-@float Figure,call-new-function
+@float Figure,figure-call-new-function
@caption{Calling The New Function}
@ifinfo
@center @image{api-figure3, , , Calling the new function, txt}
@@ -29480,7 +29461,7 @@ This is shown in @inlineraw{docbook, <xref linkend="call-new-function"/>}.
@end ifnotdocbook
@docbook
-<figure id="call-new-function">
+<figure id="figure-call-new-function">
<title>Calling The New Function</title>
<graphic fileref="api-figure3.eps"/>
</figure>
@@ -29863,9 +29844,9 @@ value type, as appropriate. This behavior is summarized in
@ref{table-value-types-returned}.
@c FIXME: Try to do this with spans...
-@ifdocbook
-@anchor{table-value-types-returned}
-@end ifdocbook
+
+@float Table,table-value-types-returned
+@caption{API Value Types Returned}
@docbook
<informaltable>
<tgroup cols="2">
@@ -29950,8 +29931,6 @@ value type, as appropriate. This behavior is summarized in
@ifnotplaintext
@ifnotdocbook
-@float Table,table-value-types-returned
-@caption{Value Types Returned}
@multitable @columnfractions .50 .50
@headitem @tab Type of Actual Value:
@end multitable
@@ -29964,12 +29943,9 @@ value type, as appropriate. This behavior is summarized in
@item @tab @b{Undefined} @tab String @tab Number @tab Array @tab Undefined
@item @tab @b{Value Cookie} @tab false @tab false @tab false @tab false
@end multitable
-@end float
@end ifnotdocbook
@end ifnotplaintext
@ifplaintext
-@float Table,table-value-types-returned
-@caption{Value Types Returned}
@example
+-------------------------------------------------+
| Type of Actual Value: |
@@ -29993,8 +29969,8 @@ value type, as appropriate. This behavior is summarized in
| | Cookie | | | | |
+-----------+-----------+------------+------------+-----------+-----------+
@end example
-@end float
@end ifplaintext
+@end float
@node Memory Allocation Functions
@subsection Memory Allocation Functions and Convenience Macros
@@ -32866,7 +32842,7 @@ indicating the type of the file. The letters are file types are shown
in @ref{table-readdir-file-types}.
@float Table,table-readdir-file-types
-@caption{File types returned by @code{readdir()}}
+@caption{File Types Returned By @code{readdir()}}
@multitable @columnfractions .1 .9
@headitem Letter @tab File Type
@item @code{b} @tab Block device
@@ -33169,9 +33145,6 @@ See the project's web site for more information.
@ifdocbook
-@docbook
-<partintro>
-@end docbook
@ifclear FOR_PRINT
Part IV contains the appendixes (including the two licenses that cover
the @command{gawk} source code and this @value{DOCUMENT}, respectively)
@@ -33206,9 +33179,6 @@ Part IV contains two appendixes:
@ref{GNU Free Documentation License}.
@end ifclear
@end itemize
-@docbook
-</partintro>
-@end docbook
@end ifdocbook
@node Language History
generated by cgit v1.2.3 (git 2.25.1) at 2025-05-06 01:34:32 +0000