diff options
| -rw-r--r-- | doc/ChangeLog | 7 | ||||
| -rw-r--r-- | doc/gawk.info | 184 | ||||
| -rw-r--r-- | doc/gawk.texi | 74 | ||||
| -rw-r--r-- | doc/gawktexi.in | 74 |
4 files changed, 234 insertions, 105 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 8a00b6ab..43970352 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,10 @@ +2021-09-24 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in (Building the Documentation): Improve the text, + add info on building the HTML doc. Thanks to Antonio Columbo + for the encouragement. + (Distribution Contents): Update with more files. + 2021-09-23 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in (Strong Regexp Constants): Document that they diff --git a/doc/gawk.info b/doc/gawk.info index 11971ca1..5ee07cb2 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -30681,16 +30681,21 @@ Various '.c', '.y', and '.h' files 'ChangeLog' A detailed list of source code changes as bugs are fixed or - improvements made. + improvements made. There are similar files in all of the + subdirectories. 'ChangeLog.0' - An older list of source code changes. +'ChangeLog.1' + Older lists of source code changes. There are similar files in all + of the subdirectories. 'NEWS' A list of changes to 'gawk' since the last release or patch. 'NEWS.0' - An older list of changes to 'gawk'. +'NEWS.1' + Older lists of changes to 'gawk'. There are similar files in all + of the subdirectories. 'COPYING' The GNU General Public License. @@ -30751,6 +30756,16 @@ Various '.c', '.y', and '.h' files 'doc/gawkinet.info' The generated Info file for 'TCP/IP Internetworking with 'gawk''. +'doc/gawkworkflow.texi' + The Texinfo source file for *note (General Introduction, + gawkworkflow, Participating in 'gawk' Development)Top::. It should + be processed with TeX (via 'texi2dvi' or 'texi2pdf') to produce a + printed document and with 'makeinfo' to produce an Info or HTML + file. + +'doc/gawkorkflow.info' + The generated Info file for 'Participating in 'gawk' Development'. + 'doc/igawk.1' The 'troff' source for a manual page describing the 'igawk' program presented in *note Igawk Program::. (Since 'gawk' can do its own @@ -31085,17 +31100,18 @@ File: gawk.info, Node: Building the Documentation, Prev: Compiling from Git, B.2.6 Building the Documentation -------------------------------- -The Info documentation is included in the distribution tar files and in -Git; you should not need to rebuild it. However, if it needs to be -done, simply running 'make' will do it, assuming that you have a recent -enough version of 'makeinfo' installed. +The generated Info documentation is included in the distribution 'tar' +files and in the Git source code repository; you should not need to +rebuild it. However, if it needs to be done, simply running 'make' will +do it, assuming that you have a recent enough version of 'makeinfo' +installed. - If you wish to build the PDF version of the manual, you will need to + If you wish to build the PDF version of the manuals, you will need to have TeX installed, and possibly additional packages that provide the -necessary fonts and tools, such as 'ps2pdf'. You will also need GNU -Troff ('groff') installed in order to format the reference card and the -manual page. Managing this process is beyond the scope of this Info -file. +necessary fonts and tools, such as 'dvi2pdf' and 'ps2pdf'. You will +also need GNU Troff ('groff') installed in order to format the reference +card and the manual page (*note Distribution contents::). Managing this +process is beyond the scope of this Info file. Assuming you have all you need, then the following commands produce the PDF versions of the documentation: @@ -31103,6 +31119,18 @@ the PDF versions of the documentation: cd doc make pdf +This creates PDF versions of all three Texinfo documents included in the +distribution, as well as of the manual page and the reference card. + + Similarly, if you have a recent enough version of 'makeinfo', you can +make the HTML version of the manuals with: + + cd doc + make html + +This creates HTML versions of all three Texinfo documents included in +the distribution. + File: gawk.info, Node: Non-Unix Installation, Next: Bugs, Prev: Unix Installation, Up: Installation @@ -35525,7 +35553,7 @@ Index * arrays, sorting, IGNORECASE variable and: Array Sorting Functions. (line 88) * artificial intelligence, gawk and: Distribution contents. - (line 58) + (line 63) * ASCII: Escape Sequences. (line 31) * ASCII <1>: Bracket Expressions. (line 79) * ASCII <2>: Scalar Constants. (line 20) @@ -36392,6 +36420,12 @@ Index * do-while statement: Do Statement. (line 6) * documentation, online: Manual History. (line 11) * documentation, of awk programs: Library Names. (line 6) +* documentation, building, Info files: Building the Documentation. + (line 6) +* documentation, building, PDF: Building the Documentation. + (line 12) +* documentation, building, HTML: Building the Documentation. + (line 28) * documents, searching: Dupword Program. (line 6) * dollar sign ($), regexp operator: Regexp Operator Details. (line 31) @@ -38317,7 +38351,7 @@ Index (line 6) * Texinfo <3>: Extract Program. (line 12) * Texinfo <4>: Distribution contents. - (line 83) + (line 88) * Texinfo <5>: Adding Code. (line 100) * text, printing: Print. (line 22) * text, printing, unduplicated lines of: Uniq Program. (line 6) @@ -39127,67 +39161,67 @@ Node: Gawk Distribution1232946 Node: Getting1233430 Node: Extracting1234393 Node: Distribution contents1236031 -Node: Unix Installation1242511 -Node: Quick Installation1243315 -Node: Compiling with MPFR1245791 -Node: Shell Startup Files1246483 -Node: Additional Configuration Options1247572 -Node: Configuration Philosophy1249887 -Node: Compiling from Git1252283 -Node: Building the Documentation1252838 -Node: Non-Unix Installation1253760 -Node: PC Installation1254220 -Node: PC Binary Installation1255058 -Node: PC Compiling1255493 -Node: PC Using1256610 -Node: Cygwin1260163 -Node: MSYS1261387 -Node: VMS Installation1261989 -Node: VMS Compilation1262708 -Ref: VMS Compilation-Footnote-11263937 -Node: VMS Dynamic Extensions1263995 -Node: VMS Installation Details1265680 -Node: VMS Running1267942 -Node: VMS GNV1272221 -Node: Bugs1272935 -Node: Bug definition1273847 -Node: Bug address1276351 -Node: Usenet1279739 -Node: Performance bugs1280748 -Node: Asking for help1283669 -Node: Maintainers1285631 -Node: Other Versions1286825 -Node: Installation summary1294677 -Node: Notes1296041 -Node: Compatibility Mode1296835 -Node: Additions1297617 -Node: Accessing The Source1298542 -Node: Adding Code1299979 -Node: New Ports1306198 -Node: Derived Files1310573 -Ref: Derived Files-Footnote-11316233 -Ref: Derived Files-Footnote-21316268 -Ref: Derived Files-Footnote-31316866 -Node: Future Extensions1316980 -Node: Implementation Limitations1317638 -Node: Extension Design1318848 -Node: Old Extension Problems1319992 -Ref: Old Extension Problems-Footnote-11321510 -Node: Extension New Mechanism Goals1321567 -Ref: Extension New Mechanism Goals-Footnote-11324931 -Node: Extension Other Design Decisions1325120 -Node: Extension Future Growth1327233 -Node: Notes summary1327839 -Node: Basic Concepts1328997 -Node: Basic High Level1329678 -Ref: figure-general-flow1329960 -Ref: figure-process-flow1330645 -Ref: Basic High Level-Footnote-11333946 -Node: Basic Data Typing1334131 -Node: Glossary1337459 -Node: Copying1369346 -Node: GNU Free Documentation License1406889 -Node: Index1432009 +Node: Unix Installation1243117 +Node: Quick Installation1243921 +Node: Compiling with MPFR1246397 +Node: Shell Startup Files1247089 +Node: Additional Configuration Options1248178 +Node: Configuration Philosophy1250493 +Node: Compiling from Git1252889 +Node: Building the Documentation1253444 +Node: Non-Unix Installation1254828 +Node: PC Installation1255288 +Node: PC Binary Installation1256126 +Node: PC Compiling1256561 +Node: PC Using1257678 +Node: Cygwin1261231 +Node: MSYS1262455 +Node: VMS Installation1263057 +Node: VMS Compilation1263776 +Ref: VMS Compilation-Footnote-11265005 +Node: VMS Dynamic Extensions1265063 +Node: VMS Installation Details1266748 +Node: VMS Running1269010 +Node: VMS GNV1273289 +Node: Bugs1274003 +Node: Bug definition1274915 +Node: Bug address1277419 +Node: Usenet1280807 +Node: Performance bugs1281816 +Node: Asking for help1284737 +Node: Maintainers1286699 +Node: Other Versions1287893 +Node: Installation summary1295745 +Node: Notes1297109 +Node: Compatibility Mode1297903 +Node: Additions1298685 +Node: Accessing The Source1299610 +Node: Adding Code1301047 +Node: New Ports1307266 +Node: Derived Files1311641 +Ref: Derived Files-Footnote-11317301 +Ref: Derived Files-Footnote-21317336 +Ref: Derived Files-Footnote-31317934 +Node: Future Extensions1318048 +Node: Implementation Limitations1318706 +Node: Extension Design1319916 +Node: Old Extension Problems1321060 +Ref: Old Extension Problems-Footnote-11322578 +Node: Extension New Mechanism Goals1322635 +Ref: Extension New Mechanism Goals-Footnote-11325999 +Node: Extension Other Design Decisions1326188 +Node: Extension Future Growth1328301 +Node: Notes summary1328907 +Node: Basic Concepts1330065 +Node: Basic High Level1330746 +Ref: figure-general-flow1331028 +Ref: figure-process-flow1331713 +Ref: Basic High Level-Footnote-11335014 +Node: Basic Data Typing1335199 +Node: Glossary1338527 +Node: Copying1370414 +Node: GNU Free Documentation License1407957 +Node: Index1433077 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 1bde9543..a71fe804 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -64,6 +64,7 @@ @set PATCHLEVEL 1 @set GAWKINETTITLE TCP/IP Internetworking with @command{gawk} +@set GAWKWORKFLOWTITLE Participating in @command{gawk} Development @ifset FOR_PRINT @set TITLE Effective awk Programming @end ifset @@ -42028,7 +42029,7 @@ Git repository; for more information see @ref{Accessing The Source}. @node Extracting @appendixsubsec Extracting the Distribution -@command{gawk} is distributed as several @code{tar} files compressed with +@command{gawk} is distributed as several @command{tar} files compressed with different compression programs: @command{gzip}, @command{bzip2}, and @command{xz}. For simplicity, the rest of these instructions assume you are using the one compressed with the GNU Gzip program (@command{gzip}). @@ -42036,7 +42037,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 -file and then use @code{tar} to extract it. You can use the following +file and then use @command{tar} to extract it. You can use the following pipeline to produce the @command{gawk} distribution: @example @@ -42109,15 +42110,20 @@ A file providing an overview of the configuration and installation process. @item ChangeLog A detailed list of source code changes as bugs are fixed or improvements made. +There are similar files in all of the subdirectories. @item ChangeLog.0 -An older list of source code changes. +@itemx ChangeLog.1 +Older lists of source code changes. +There are similar files in all of the subdirectories. @item NEWS A list of changes to @command{gawk} since the last release or patch. @item NEWS.0 -An older list of changes to @command{gawk}. +@itemx NEWS.1 +Older lists of changes to @command{gawk}. +There are similar files in all of the subdirectories. @item COPYING The GNU General Public License. @@ -42188,6 +42194,23 @@ with @command{makeinfo} to produce an Info or HTML file. The generated Info file for @cite{@value{GAWKINETTITLE}}. +@item doc/gawkworkflow.texi +The Texinfo source file for +@ifinfo +@inforef{Top, , General Introduction, gawkworkflow, @value{GAWKWORKFLOWTITLE}}. +@end ifinfo +@ifnotinfo +@cite{@value{GAWKWORKFLOWTITLE}}. +@end ifnotinfo +It should be processed with @TeX{} +(via @command{texi2dvi} or @command{texi2pdf}) +to produce a printed document and +with @command{makeinfo} to produce an Info or HTML file. + +@item doc/gawkorkflow.info +The generated Info file for +@cite{@value{GAWKWORKFLOWTITLE}}. + @item doc/igawk.1 The @command{troff} source for a manual page describing the @command{igawk} program presented in @@ -42573,17 +42596,21 @@ cd gawk @node Building the Documentation @appendixsubsec Building the Documentation -The Info documentation is included in the distribution tar files and in -Git; you should not need to rebuild it. However, if it needs to be done, -simply running @command{make} will do it, assuming that you have a recent -enough version of @command{makeinfo} installed. - -If you wish to build the PDF version of the manual, you will need to -have @TeX{} installed, and possibly additional packages that provide the -necessary fonts and tools, such as @command{ps2pdf}. You will also need -GNU Troff (@command{groff}) installed in order to format the reference -card and the manual page. Managing this process is beyond the scope of -this @value{DOCUMENT}. +@cindex documentation @subentry building @subentry Info files +The generated Info documentation is included in the distribution +@command{tar} files and in the Git source code repository; you should +not need to rebuild it. However, if it needs to be done, simply running +@command{make} will do it, assuming that you have a recent enough version +of @command{makeinfo} installed. + +@cindex documentation @subentry building @subentry PDF +If you wish to build the PDF version of the manuals, you will need +to have @TeX{} installed, and possibly additional packages that +provide the necessary fonts and tools, such as @command{dvi2pdf} +and @command{ps2pdf}. You will also need GNU Troff (@command{groff}) +installed in order to format the reference card and the manual page +(@pxref{Distribution contents}). Managing this process is beyond the +scope of this @value{DOCUMENT}. Assuming you have all you need, then the following commands produce the PDF versions of the documentation: @@ -42593,6 +42620,23 @@ cd doc make pdf @end example +@noindent +This creates PDF versions of all three Texinfo documents included +in the distribution, as well as of the manual page and the reference card. + +@cindex documentation @subentry building @subentry HTML +Similarly, if you have a recent enough version of @command{makeinfo}, +you can make the HTML version of the manuals with: + +@example +cd doc +make html +@end example + +@noindent +This creates HTML versions of all three Texinfo documents included +in the distribution. + @node Non-Unix Installation @appendixsec Installation on Other Operating Systems diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 58aba431..9dd7479a 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -59,6 +59,7 @@ @set PATCHLEVEL 1 @set GAWKINETTITLE TCP/IP Internetworking with @command{gawk} +@set GAWKWORKFLOWTITLE Participating in @command{gawk} Development @ifset FOR_PRINT @set TITLE Effective awk Programming @end ifset @@ -40871,7 +40872,7 @@ Git repository; for more information see @ref{Accessing The Source}. @node Extracting @appendixsubsec Extracting the Distribution -@command{gawk} is distributed as several @code{tar} files compressed with +@command{gawk} is distributed as several @command{tar} files compressed with different compression programs: @command{gzip}, @command{bzip2}, and @command{xz}. For simplicity, the rest of these instructions assume you are using the one compressed with the GNU Gzip program (@command{gzip}). @@ -40879,7 +40880,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 -file and then use @code{tar} to extract it. You can use the following +file and then use @command{tar} to extract it. You can use the following pipeline to produce the @command{gawk} distribution: @example @@ -40952,15 +40953,20 @@ A file providing an overview of the configuration and installation process. @item ChangeLog A detailed list of source code changes as bugs are fixed or improvements made. +There are similar files in all of the subdirectories. @item ChangeLog.0 -An older list of source code changes. +@itemx ChangeLog.1 +Older lists of source code changes. +There are similar files in all of the subdirectories. @item NEWS A list of changes to @command{gawk} since the last release or patch. @item NEWS.0 -An older list of changes to @command{gawk}. +@itemx NEWS.1 +Older lists of changes to @command{gawk}. +There are similar files in all of the subdirectories. @item COPYING The GNU General Public License. @@ -41031,6 +41037,23 @@ with @command{makeinfo} to produce an Info or HTML file. The generated Info file for @cite{@value{GAWKINETTITLE}}. +@item doc/gawkworkflow.texi +The Texinfo source file for +@ifinfo +@inforef{Top, , General Introduction, gawkworkflow, @value{GAWKWORKFLOWTITLE}}. +@end ifinfo +@ifnotinfo +@cite{@value{GAWKWORKFLOWTITLE}}. +@end ifnotinfo +It should be processed with @TeX{} +(via @command{texi2dvi} or @command{texi2pdf}) +to produce a printed document and +with @command{makeinfo} to produce an Info or HTML file. + +@item doc/gawkorkflow.info +The generated Info file for +@cite{@value{GAWKWORKFLOWTITLE}}. + @item doc/igawk.1 The @command{troff} source for a manual page describing the @command{igawk} program presented in @@ -41416,17 +41439,21 @@ cd gawk @node Building the Documentation @appendixsubsec Building the Documentation -The Info documentation is included in the distribution tar files and in -Git; you should not need to rebuild it. However, if it needs to be done, -simply running @command{make} will do it, assuming that you have a recent -enough version of @command{makeinfo} installed. - -If you wish to build the PDF version of the manual, you will need to -have @TeX{} installed, and possibly additional packages that provide the -necessary fonts and tools, such as @command{ps2pdf}. You will also need -GNU Troff (@command{groff}) installed in order to format the reference -card and the manual page. Managing this process is beyond the scope of -this @value{DOCUMENT}. +@cindex documentation @subentry building @subentry Info files +The generated Info documentation is included in the distribution +@command{tar} files and in the Git source code repository; you should +not need to rebuild it. However, if it needs to be done, simply running +@command{make} will do it, assuming that you have a recent enough version +of @command{makeinfo} installed. + +@cindex documentation @subentry building @subentry PDF +If you wish to build the PDF version of the manuals, you will need +to have @TeX{} installed, and possibly additional packages that +provide the necessary fonts and tools, such as @command{dvi2pdf} +and @command{ps2pdf}. You will also need GNU Troff (@command{groff}) +installed in order to format the reference card and the manual page +(@pxref{Distribution contents}). Managing this process is beyond the +scope of this @value{DOCUMENT}. Assuming you have all you need, then the following commands produce the PDF versions of the documentation: @@ -41436,6 +41463,23 @@ cd doc make pdf @end example +@noindent +This creates PDF versions of all three Texinfo documents included +in the distribution, as well as of the manual page and the reference card. + +@cindex documentation @subentry building @subentry HTML +Similarly, if you have a recent enough version of @command{makeinfo}, +you can make the HTML version of the manuals with: + +@example +cd doc +make html +@end example + +@noindent +This creates HTML versions of all three Texinfo documents included +in the distribution. + @node Non-Unix Installation @appendixsec Installation on Other Operating Systems |