diff options
| -rw-r--r-- | doc/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/gawk.info | 420 | ||||
| -rw-r--r-- | doc/gawk.texi | 31 | ||||
| -rw-r--r-- | doc/gawktexi.in | 31 |
4 files changed, 271 insertions, 216 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 8386515d..72d907ca 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2014-09-18 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in: Fix italics in quotations. Some docbook special + cases. + 2014-09-15 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Document that identifiers must use the English diff --git a/doc/gawk.info b/doc/gawk.info index d94ea8bf..42465c42 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -19399,10 +19399,10 @@ File: gawk.info, Node: TCP/IP Networking, Next: Profiling, Prev: Two-way I/O, unless the host that isn't close is busy hung or dead. - In addition to being able to open a two-way pipeline to a coprocess -on the same system (*note Two-way I/O::), it is possible to make a -two-way connection to another process on another system across an IP -network connection. +In addition to being able to open a two-way pipeline to a coprocess on +the same system (*note Two-way I/O::), it is possible to make a two-way +connection to another process on another system across an IP network +connection. You can think of this as just a _very long_ two-way pipeline to a coprocess. The way `gawk' decides that you want to use TCP/IP @@ -27997,7 +27997,7 @@ B.5 Other Freely Available `awk' Implementations `// Do C++ comments work? answer: yes! of course' -- Michael Brennan - There are a number of other freely available `awk' implementations. +There are a number of other freely available `awk' implementations. This minor node briefly describes where to get them: Unix `awk' @@ -34392,210 +34392,210 @@ Node: Two-way I/O781204 Ref: Two-way I/O-Footnote-1786148 Ref: Two-way I/O-Footnote-2786327 Node: TCP/IP Networking786409 -Node: Profiling789254 -Node: Advanced Features Summary796796 -Node: Internationalization798660 -Node: I18N and L10N800140 -Node: Explaining gettext800826 -Ref: Explaining gettext-Footnote-1805852 -Ref: Explaining gettext-Footnote-2806036 -Node: Programmer i18n806201 -Ref: Programmer i18n-Footnote-1810995 -Node: Translator i18n811044 -Node: String Extraction811838 -Ref: String Extraction-Footnote-1812971 -Node: Printf Ordering813057 -Ref: Printf Ordering-Footnote-1815839 -Node: I18N Portability815903 -Ref: I18N Portability-Footnote-1818352 -Node: I18N Example818415 -Ref: I18N Example-Footnote-1821121 -Node: Gawk I18N821193 -Node: I18N Summary821831 -Node: Debugger823170 -Node: Debugging824192 -Node: Debugging Concepts824633 -Node: Debugging Terms826489 -Node: Awk Debugging829086 -Node: Sample Debugging Session829978 -Node: Debugger Invocation830498 -Node: Finding The Bug831834 -Node: List of Debugger Commands838313 -Node: Breakpoint Control839645 -Node: Debugger Execution Control843309 -Node: Viewing And Changing Data846669 -Node: Execution Stack850027 -Node: Debugger Info851540 -Node: Miscellaneous Debugger Commands855534 -Node: Readline Support860718 -Node: Limitations861610 -Node: Debugging Summary863883 -Node: Arbitrary Precision Arithmetic865051 -Node: Computer Arithmetic866538 -Ref: Computer Arithmetic-Footnote-1870925 -Node: Math Definitions870982 -Ref: table-ieee-formats874271 -Ref: Math Definitions-Footnote-1874811 -Node: MPFR features874914 -Node: FP Math Caution876531 -Ref: FP Math Caution-Footnote-1877581 -Node: Inexactness of computations877950 -Node: Inexact representation878898 -Node: Comparing FP Values880253 -Node: Errors accumulate881217 -Node: Getting Accuracy882650 -Node: Try To Round885309 -Node: Setting precision886208 -Ref: table-predefined-precision-strings886890 -Node: Setting the rounding mode888683 -Ref: table-gawk-rounding-modes889047 -Ref: Setting the rounding mode-Footnote-1892501 -Node: Arbitrary Precision Integers892680 -Ref: Arbitrary Precision Integers-Footnote-1895661 -Node: POSIX Floating Point Problems895810 -Ref: POSIX Floating Point Problems-Footnote-1899686 -Node: Floating point summary899724 -Node: Dynamic Extensions901928 -Node: Extension Intro903480 -Node: Plugin License904745 -Node: Extension Mechanism Outline905430 -Ref: figure-load-extension905854 -Ref: figure-load-new-function907339 -Ref: figure-call-new-function908341 -Node: Extension API Description910325 -Node: Extension API Functions Introduction911775 -Node: General Data Types916642 -Ref: General Data Types-Footnote-1922335 -Node: Requesting Values922634 -Ref: table-value-types-returned923371 -Node: Memory Allocation Functions924329 -Ref: Memory Allocation Functions-Footnote-1927076 -Node: Constructor Functions927172 -Node: Registration Functions928930 -Node: Extension Functions929615 -Node: Exit Callback Functions931917 -Node: Extension Version String933165 -Node: Input Parsers933815 -Node: Output Wrappers943629 -Node: Two-way processors948145 -Node: Printing Messages950349 -Ref: Printing Messages-Footnote-1951426 -Node: Updating `ERRNO'951578 -Node: Accessing Parameters952317 -Node: Symbol Table Access953547 -Node: Symbol table by name954061 -Node: Symbol table by cookie956037 -Ref: Symbol table by cookie-Footnote-1960170 -Node: Cached values960233 -Ref: Cached values-Footnote-1963737 -Node: Array Manipulation963828 -Ref: Array Manipulation-Footnote-1964926 -Node: Array Data Types964965 -Ref: Array Data Types-Footnote-1967668 -Node: Array Functions967760 -Node: Flattening Arrays971634 -Node: Creating Arrays978486 -Node: Extension API Variables983217 -Node: Extension Versioning983853 -Node: Extension API Informational Variables985754 -Node: Extension API Boilerplate986840 -Node: Finding Extensions990644 -Node: Extension Example991204 -Node: Internal File Description991934 -Node: Internal File Ops996025 -Ref: Internal File Ops-Footnote-11007457 -Node: Using Internal File Ops1007597 -Ref: Using Internal File Ops-Footnote-11009944 -Node: Extension Samples1010212 -Node: Extension Sample File Functions1011736 -Node: Extension Sample Fnmatch1019304 -Node: Extension Sample Fork1020786 -Node: Extension Sample Inplace1021999 -Node: Extension Sample Ord1023674 -Node: Extension Sample Readdir1024510 -Ref: table-readdir-file-types1025366 -Node: Extension Sample Revout1026165 -Node: Extension Sample Rev2way1026756 -Node: Extension Sample Read write array1027497 -Node: Extension Sample Readfile1029376 -Node: Extension Sample API Tests1030476 -Node: Extension Sample Time1031001 -Node: gawkextlib1032316 -Node: Extension summary1035129 -Node: Extension Exercises1038822 -Node: Language History1039544 -Node: V7/SVR3.11041187 -Node: SVR41043507 -Node: POSIX1044949 -Node: BTL1046335 -Node: POSIX/GNU1047069 -Node: Feature History1052785 -Node: Common Extensions1065876 -Node: Ranges and Locales1067188 -Ref: Ranges and Locales-Footnote-11071805 -Ref: Ranges and Locales-Footnote-21071832 -Ref: Ranges and Locales-Footnote-31072066 -Node: Contributors1072287 -Node: History summary1077712 -Node: Installation1079081 -Node: Gawk Distribution1080032 -Node: Getting1080516 -Node: Extracting1081340 -Node: Distribution contents1082982 -Node: Unix Installation1088699 -Node: Quick Installation1089316 -Node: Additional Configuration Options1091758 -Node: Configuration Philosophy1093496 -Node: Non-Unix Installation1095847 -Node: PC Installation1096305 -Node: PC Binary Installation1097616 -Node: PC Compiling1099464 -Ref: PC Compiling-Footnote-11102463 -Node: PC Testing1102568 -Node: PC Using1103744 -Node: Cygwin1107896 -Node: MSYS1108705 -Node: VMS Installation1109219 -Node: VMS Compilation1110015 -Ref: VMS Compilation-Footnote-11111237 -Node: VMS Dynamic Extensions1111295 -Node: VMS Installation Details1112668 -Node: VMS Running1114920 -Node: VMS GNV1117754 -Node: VMS Old Gawk1118477 -Node: Bugs1118947 -Node: Other Versions1122951 -Node: Installation summary1129178 -Node: Notes1130234 -Node: Compatibility Mode1131099 -Node: Additions1131881 -Node: Accessing The Source1132806 -Node: Adding Code1134242 -Node: New Ports1140420 -Node: Derived Files1144901 -Ref: Derived Files-Footnote-11150376 -Ref: Derived Files-Footnote-21150410 -Ref: Derived Files-Footnote-31151006 -Node: Future Extensions1151120 -Node: Implementation Limitations1151726 -Node: Extension Design1152974 -Node: Old Extension Problems1154128 -Ref: Old Extension Problems-Footnote-11155645 -Node: Extension New Mechanism Goals1155702 -Ref: Extension New Mechanism Goals-Footnote-11159062 -Node: Extension Other Design Decisions1159251 -Node: Extension Future Growth1161357 -Node: Old Extension Mechanism1162193 -Node: Notes summary1163955 -Node: Basic Concepts1165141 -Node: Basic High Level1165822 -Ref: figure-general-flow1166094 -Ref: figure-process-flow1166693 -Ref: Basic High Level-Footnote-11169922 -Node: Basic Data Typing1170107 -Node: Glossary1173435 -Node: Copying1198587 -Node: GNU Free Documentation License1236143 -Node: Index1261279 +Node: Profiling789251 +Node: Advanced Features Summary796793 +Node: Internationalization798657 +Node: I18N and L10N800137 +Node: Explaining gettext800823 +Ref: Explaining gettext-Footnote-1805849 +Ref: Explaining gettext-Footnote-2806033 +Node: Programmer i18n806198 +Ref: Programmer i18n-Footnote-1810992 +Node: Translator i18n811041 +Node: String Extraction811835 +Ref: String Extraction-Footnote-1812968 +Node: Printf Ordering813054 +Ref: Printf Ordering-Footnote-1815836 +Node: I18N Portability815900 +Ref: I18N Portability-Footnote-1818349 +Node: I18N Example818412 +Ref: I18N Example-Footnote-1821118 +Node: Gawk I18N821190 +Node: I18N Summary821828 +Node: Debugger823167 +Node: Debugging824189 +Node: Debugging Concepts824630 +Node: Debugging Terms826486 +Node: Awk Debugging829083 +Node: Sample Debugging Session829975 +Node: Debugger Invocation830495 +Node: Finding The Bug831831 +Node: List of Debugger Commands838310 +Node: Breakpoint Control839642 +Node: Debugger Execution Control843306 +Node: Viewing And Changing Data846666 +Node: Execution Stack850024 +Node: Debugger Info851537 +Node: Miscellaneous Debugger Commands855531 +Node: Readline Support860715 +Node: Limitations861607 +Node: Debugging Summary863880 +Node: Arbitrary Precision Arithmetic865048 +Node: Computer Arithmetic866535 +Ref: Computer Arithmetic-Footnote-1870922 +Node: Math Definitions870979 +Ref: table-ieee-formats874268 +Ref: Math Definitions-Footnote-1874808 +Node: MPFR features874911 +Node: FP Math Caution876528 +Ref: FP Math Caution-Footnote-1877578 +Node: Inexactness of computations877947 +Node: Inexact representation878895 +Node: Comparing FP Values880250 +Node: Errors accumulate881214 +Node: Getting Accuracy882647 +Node: Try To Round885306 +Node: Setting precision886205 +Ref: table-predefined-precision-strings886887 +Node: Setting the rounding mode888680 +Ref: table-gawk-rounding-modes889044 +Ref: Setting the rounding mode-Footnote-1892498 +Node: Arbitrary Precision Integers892677 +Ref: Arbitrary Precision Integers-Footnote-1895658 +Node: POSIX Floating Point Problems895807 +Ref: POSIX Floating Point Problems-Footnote-1899683 +Node: Floating point summary899721 +Node: Dynamic Extensions901925 +Node: Extension Intro903477 +Node: Plugin License904742 +Node: Extension Mechanism Outline905427 +Ref: figure-load-extension905851 +Ref: figure-load-new-function907336 +Ref: figure-call-new-function908338 +Node: Extension API Description910322 +Node: Extension API Functions Introduction911772 +Node: General Data Types916639 +Ref: General Data Types-Footnote-1922332 +Node: Requesting Values922631 +Ref: table-value-types-returned923368 +Node: Memory Allocation Functions924326 +Ref: Memory Allocation Functions-Footnote-1927073 +Node: Constructor Functions927169 +Node: Registration Functions928927 +Node: Extension Functions929612 +Node: Exit Callback Functions931914 +Node: Extension Version String933162 +Node: Input Parsers933812 +Node: Output Wrappers943626 +Node: Two-way processors948142 +Node: Printing Messages950346 +Ref: Printing Messages-Footnote-1951423 +Node: Updating `ERRNO'951575 +Node: Accessing Parameters952314 +Node: Symbol Table Access953544 +Node: Symbol table by name954058 +Node: Symbol table by cookie956034 +Ref: Symbol table by cookie-Footnote-1960167 +Node: Cached values960230 +Ref: Cached values-Footnote-1963734 +Node: Array Manipulation963825 +Ref: Array Manipulation-Footnote-1964923 +Node: Array Data Types964962 +Ref: Array Data Types-Footnote-1967665 +Node: Array Functions967757 +Node: Flattening Arrays971631 +Node: Creating Arrays978483 +Node: Extension API Variables983214 +Node: Extension Versioning983850 +Node: Extension API Informational Variables985751 +Node: Extension API Boilerplate986837 +Node: Finding Extensions990641 +Node: Extension Example991201 +Node: Internal File Description991931 +Node: Internal File Ops996022 +Ref: Internal File Ops-Footnote-11007454 +Node: Using Internal File Ops1007594 +Ref: Using Internal File Ops-Footnote-11009941 +Node: Extension Samples1010209 +Node: Extension Sample File Functions1011733 +Node: Extension Sample Fnmatch1019301 +Node: Extension Sample Fork1020783 +Node: Extension Sample Inplace1021996 +Node: Extension Sample Ord1023671 +Node: Extension Sample Readdir1024507 +Ref: table-readdir-file-types1025363 +Node: Extension Sample Revout1026162 +Node: Extension Sample Rev2way1026753 +Node: Extension Sample Read write array1027494 +Node: Extension Sample Readfile1029373 +Node: Extension Sample API Tests1030473 +Node: Extension Sample Time1030998 +Node: gawkextlib1032313 +Node: Extension summary1035126 +Node: Extension Exercises1038819 +Node: Language History1039541 +Node: V7/SVR3.11041184 +Node: SVR41043504 +Node: POSIX1044946 +Node: BTL1046332 +Node: POSIX/GNU1047066 +Node: Feature History1052782 +Node: Common Extensions1065873 +Node: Ranges and Locales1067185 +Ref: Ranges and Locales-Footnote-11071802 +Ref: Ranges and Locales-Footnote-21071829 +Ref: Ranges and Locales-Footnote-31072063 +Node: Contributors1072284 +Node: History summary1077709 +Node: Installation1079078 +Node: Gawk Distribution1080029 +Node: Getting1080513 +Node: Extracting1081337 +Node: Distribution contents1082979 +Node: Unix Installation1088696 +Node: Quick Installation1089313 +Node: Additional Configuration Options1091755 +Node: Configuration Philosophy1093493 +Node: Non-Unix Installation1095844 +Node: PC Installation1096302 +Node: PC Binary Installation1097613 +Node: PC Compiling1099461 +Ref: PC Compiling-Footnote-11102460 +Node: PC Testing1102565 +Node: PC Using1103741 +Node: Cygwin1107893 +Node: MSYS1108702 +Node: VMS Installation1109216 +Node: VMS Compilation1110012 +Ref: VMS Compilation-Footnote-11111234 +Node: VMS Dynamic Extensions1111292 +Node: VMS Installation Details1112665 +Node: VMS Running1114917 +Node: VMS GNV1117751 +Node: VMS Old Gawk1118474 +Node: Bugs1118944 +Node: Other Versions1122948 +Node: Installation summary1129172 +Node: Notes1130228 +Node: Compatibility Mode1131093 +Node: Additions1131875 +Node: Accessing The Source1132800 +Node: Adding Code1134236 +Node: New Ports1140414 +Node: Derived Files1144895 +Ref: Derived Files-Footnote-11150370 +Ref: Derived Files-Footnote-21150404 +Ref: Derived Files-Footnote-31151000 +Node: Future Extensions1151114 +Node: Implementation Limitations1151720 +Node: Extension Design1152968 +Node: Old Extension Problems1154122 +Ref: Old Extension Problems-Footnote-11155639 +Node: Extension New Mechanism Goals1155696 +Ref: Extension New Mechanism Goals-Footnote-11159056 +Node: Extension Other Design Decisions1159245 +Node: Extension Future Growth1161351 +Node: Old Extension Mechanism1162187 +Node: Notes summary1163949 +Node: Basic Concepts1165135 +Node: Basic High Level1165816 +Ref: figure-general-flow1166088 +Ref: figure-process-flow1166687 +Ref: Basic High Level-Footnote-11169916 +Node: Basic Data Typing1170101 +Node: Glossary1173429 +Node: Copying1198581 +Node: GNU Free Documentation License1236137 +Node: Index1261273 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 416d3c53..1c87978b 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -19150,8 +19150,8 @@ them, i.e., to tell @command{awk} what they should do. @subsection Function Definition Syntax @quotation -It's entirely fair to say that the @command{awk} syntax for local -variable definitions is appallingly awful. +@i{It's entirely fair to say that the @command{awk} syntax for local +variable definitions is appallingly awful.} @author Brian Kernighan @end quotation @@ -27260,6 +27260,7 @@ using regular pipes. @cindex @code{/inet6/@dots{}} special files (@command{gawk}) @cindex files, @code{/inet6/@dots{}} (@command{gawk}) @cindex @code{EMISTERED} +@ifnotdocbook @quotation @code{EMISTERED}:@* @ @ @ @ @i{A host is a host from coast to coast,@* @@ -27267,6 +27268,17 @@ using regular pipes. @ @ @ @ unless the host that isn't close@* @ @ @ @ is busy hung or dead.} @end quotation +@end ifnotdocbook + +@docbook +<blockquote> +<literallayout class="normal"><literal>EMISTERED</literal>: + <emphasis>A host is a host from coast to coast,</emphasis> + <emphasis>and no-one can talk to host that's close,</emphasis> + <emphasis>unless the host that isn't close</emphasis> + <emphasis>is busy hung or dead.</emphasis></literallayout> +</blockquote> +@end docbook In addition to being able to open a two-way pipeline to a coprocess on the same system @@ -30198,7 +30210,7 @@ to follow. @section Floating Point Arithmetic: Caveat Emptor! @quotation -Math class is tough! +@i{Math class is tough!} @author Teen Talk Barbie, July 1992 @end quotation @@ -37955,11 +37967,24 @@ Date: Wed, 4 Sep 1996 08:11:48 -0700 (PDT) @end ignore @cindex Brennan, Michael +@ifnotdocbook @quotation @i{It's kind of fun to put comments like this in your awk code.}@* @ @ @ @ @ @ @code{// Do C++ comments work? answer: yes! of course} @author Michael Brennan @end quotation +@end ifnotdocbook + +@docbook +<blockquote><attribution>Michael Brennan</attribution> +<literallayout> +<emphasis>It's kind of fun to put comments like this in your awk code.</emphasis> + <literal>// Do C++ comments work? answer: yes! of course</literal> +</literallayout> +</blockquote> +@end docbook + + There are a number of other freely available @command{awk} implementations. This @value{SECTION} briefly describes where to get them: diff --git a/doc/gawktexi.in b/doc/gawktexi.in index fac712e8..2f6eb42c 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -18277,8 +18277,8 @@ them, i.e., to tell @command{awk} what they should do. @subsection Function Definition Syntax @quotation -It's entirely fair to say that the @command{awk} syntax for local -variable definitions is appallingly awful. +@i{It's entirely fair to say that the @command{awk} syntax for local +variable definitions is appallingly awful.} @author Brian Kernighan @end quotation @@ -26358,6 +26358,7 @@ using regular pipes. @cindex @code{/inet6/@dots{}} special files (@command{gawk}) @cindex files, @code{/inet6/@dots{}} (@command{gawk}) @cindex @code{EMISTERED} +@ifnotdocbook @quotation @code{EMISTERED}:@* @ @ @ @ @i{A host is a host from coast to coast,@* @@ -26365,6 +26366,17 @@ using regular pipes. @ @ @ @ unless the host that isn't close@* @ @ @ @ is busy hung or dead.} @end quotation +@end ifnotdocbook + +@docbook +<blockquote> +<literallayout class="normal"><literal>EMISTERED</literal>: + <emphasis>A host is a host from coast to coast,</emphasis> + <emphasis>and no-one can talk to host that's close,</emphasis> + <emphasis>unless the host that isn't close</emphasis> + <emphasis>is busy hung or dead.</emphasis></literallayout> +</blockquote> +@end docbook In addition to being able to open a two-way pipeline to a coprocess on the same system @@ -29296,7 +29308,7 @@ to follow. @section Floating Point Arithmetic: Caveat Emptor! @quotation -Math class is tough! +@i{Math class is tough!} @author Teen Talk Barbie, July 1992 @end quotation @@ -37053,11 +37065,24 @@ Date: Wed, 4 Sep 1996 08:11:48 -0700 (PDT) @end ignore @cindex Brennan, Michael +@ifnotdocbook @quotation @i{It's kind of fun to put comments like this in your awk code.}@* @ @ @ @ @ @ @code{// Do C++ comments work? answer: yes! of course} @author Michael Brennan @end quotation +@end ifnotdocbook + +@docbook +<blockquote><attribution>Michael Brennan</attribution> +<literallayout> +<emphasis>It's kind of fun to put comments like this in your awk code.</emphasis> + <literal>// Do C++ comments work? answer: yes! of course</literal> +</literallayout> +</blockquote> +@end docbook + + There are a number of other freely available @command{awk} implementations. This @value{SECTION} briefly describes where to get them: |