From 0ee3d3f87171f701504d6b5517ddaffb8ab4bec5 Mon Sep 17 00:00:00 2001 From: "Arnold D. Robbins" Date: Sun, 7 May 2023 21:15:54 +0300 Subject: Small doc improvement. --- doc/ChangeLog | 4 ++++ doc/gawk.info | 72 ++++++++++++++++++++++++++++++++------------------------- doc/gawk.texi | 9 ++++++++ doc/gawktexi.in | 9 ++++++++ 4 files changed, 63 insertions(+), 31 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index d00fe552..72ef6f73 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2023-05-07 Arnold D. Robbins + + * gawktexi.in (Other Versions): Add a note about cppawk. + 2023-05-04 Arnold D. Robbins * wordlist: Add some more words. diff --git a/doc/gawk.info b/doc/gawk.info index 82af1e98..36a7ee90 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -32728,6 +32728,14 @@ QSE ‘awk’ The project may also be frozen; no new code changes have been made since approximately 2014. +‘cppawk’ + Quoting from the web page, “‘cppawk’ is a tiny shell script that is + used like ‘awk’. It invokes the C preprocessor (GNU ‘cpp’) on the + Awk code and calls Awk on the result.” This program may be of use + if the way ‘gawk’’s ‘@include’ facility works doesn’t suit your + needs. For more information, see + . + Other versions See also the “Versions and implementations” section of the Wikipedia article @@ -36712,6 +36720,7 @@ Index * cos: Numeric Functions. (line 15) * cosine: Numeric Functions. (line 15) * counting words, lines, characters, and bytes: Wc Program. (line 6) +* cppawk: Other Versions. (line 190) * csh utility: Statements/Lines. (line 45) * csh utility, POSIXLY_CORRECT environment variable: Options. (line 411) * csh utility, |& operator, comparison with: Two-way I/O. (line 27) @@ -38986,6 +38995,7 @@ Index * source code, awkcc: Other Versions. (line 167) * source code, QSE awk: Other Versions. (line 174) * source code, QuikTrim Awk: Other Versions. (line 178) +* source code, cppawk: Other Versions. (line 190) * source file, show in debugger: Debugger Info. (line 37) * source files, search path for: Programs Exercises. (line 70) * sparse arrays: Array Intro. (line 76) @@ -39958,37 +39968,37 @@ Node: Performance bugs1355304 Node: Asking for help1358322 Node: Maintainers1360313 Node: Other Versions1361340 -Node: Installation summary1370272 -Node: Notes1371656 -Node: Compatibility Mode1372466 -Node: Additions1373288 -Node: Accessing The Source1374233 -Node: Adding Code1375768 -Node: New Ports1382904 -Node: Derived Files1387414 -Ref: Derived Files-Footnote-11393261 -Ref: Derived Files-Footnote-21393296 -Ref: Derived Files-Footnote-31393913 -Node: Future Extensions1394027 -Node: Implementation Limitations1394699 -Node: Extension Design1395941 -Node: Old Extension Problems1397105 -Ref: Old Extension Problems-Footnote-11398681 -Node: Extension New Mechanism Goals1398742 -Ref: Extension New Mechanism Goals-Footnote-11402238 -Node: Extension Other Design Decisions1402439 -Node: Extension Future Growth1404638 -Node: Notes summary1405262 -Node: Basic Concepts1406475 -Node: Basic High Level1407160 -Ref: figure-general-flow1407442 -Ref: figure-process-flow1408149 -Ref: Basic High Level-Footnote-11411550 -Node: Basic Data Typing1411739 -Node: Glossary1415157 -Node: Copying1448279 -Node: GNU Free Documentation License1486040 -Node: Index1511363 +Node: Installation summary1370683 +Node: Notes1372067 +Node: Compatibility Mode1372877 +Node: Additions1373699 +Node: Accessing The Source1374644 +Node: Adding Code1376179 +Node: New Ports1383315 +Node: Derived Files1387825 +Ref: Derived Files-Footnote-11393672 +Ref: Derived Files-Footnote-21393707 +Ref: Derived Files-Footnote-31394324 +Node: Future Extensions1394438 +Node: Implementation Limitations1395110 +Node: Extension Design1396352 +Node: Old Extension Problems1397516 +Ref: Old Extension Problems-Footnote-11399092 +Node: Extension New Mechanism Goals1399153 +Ref: Extension New Mechanism Goals-Footnote-11402649 +Node: Extension Other Design Decisions1402850 +Node: Extension Future Growth1405049 +Node: Notes summary1405673 +Node: Basic Concepts1406886 +Node: Basic High Level1407571 +Ref: figure-general-flow1407853 +Ref: figure-process-flow1408560 +Ref: Basic High Level-Footnote-11411961 +Node: Basic Data Typing1412150 +Node: Glossary1415568 +Node: Copying1448690 +Node: GNU Free Documentation License1486451 +Node: Index1511774  End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 6e5fd251..344ea62e 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -44661,6 +44661,15 @@ download link. The project may also be frozen; no new code changes have been made since approximately 2014. +@item @command{cppawk} +@cindex @command{cppawk} +@cindex source code @subentry @command{cppawk} +Quoting from the web page, ``@command{cppawk} is a tiny shell script that is +used like @command{awk}. It invokes the C preprocessor (GNU @command{cpp}) on the Awk +code and calls Awk on the result.'' This program may be of use if +the way @command{gawk}'s @code{@@include} facility works doesn't suit +your needs. For more information, see @uref{https://www.kylheku.com/cgit/cppawk/}. + @item Other versions See also the ``Versions and implementations'' section of the @uref{https://en.wikipedia.org/wiki/Awk_language#Versions_and_implementations, diff --git a/doc/gawktexi.in b/doc/gawktexi.in index fdb688dd..06279a08 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -43549,6 +43549,15 @@ download link. The project may also be frozen; no new code changes have been made since approximately 2014. +@item @command{cppawk} +@cindex @command{cppawk} +@cindex source code @subentry @command{cppawk} +Quoting from the web page, ``@command{cppawk} is a tiny shell script that is +used like @command{awk}. It invokes the C preprocessor (GNU @command{cpp}) on the Awk +code and calls Awk on the result.'' This program may be of use if +the way @command{gawk}'s @code{@@include} facility works doesn't suit +your needs. For more information, see @uref{https://www.kylheku.com/cgit/cppawk/}. + @item Other versions See also the ``Versions and implementations'' section of the @uref{https://en.wikipedia.org/wiki/Awk_language#Versions_and_implementations, -- cgit v1.2.1