More docbook fixes.

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