From 295bee08215e33ec82e34978cecc593b698c9ad9 Mon Sep 17 00:00:00 2001 From: "Arnold D. Robbins" Date: Mon, 10 Mar 2014 22:32:14 +0200 Subject: Indexing improvements. --- doc/ChangeLog | 4 ++ doc/gawk.info | 148 +++++++++++++++++++++++++++++++------------------------- doc/gawk.texi | 27 +++++++++-- doc/gawktexi.in | 27 +++++++++-- 4 files changed, 130 insertions(+), 76 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index 99b81306..6bb4e9c0 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2014-03-10 Arnold D. Robbins + + * gawktexi.in: Finish indexing improvements. (For now, anyway.) + 2014-03-08 Arnold D. Robbins * gawktexi.in: Minor edits to the discussion of the memory allocation diff --git a/doc/gawk.info b/doc/gawk.info index 9a569829..a275d9c2 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -25928,6 +25928,9 @@ Info file, in approximate chronological order: * Anders Wallin helped keep the VMS port going for several years. + * Assaf Gordon contributed the code to implement the `--sandbox' + option. + * John Haque made the following contributions: - The modifications to convert `gawk' into a byte-code @@ -31292,12 +31295,12 @@ Index * for statement, looping over arrays: Scanning an Array. (line 20) * fork() extension function: Extension Sample Fork. (line 11) +* format specifiers: Basic Printf. (line 15) * format specifiers, mixing regular with positional specifiers: Printf Ordering. (line 57) * format specifiers, printf statement: Control Letters. (line 6) * format specifiers, strftime() function (gawk): Time Functions. (line 88) -* format strings: Basic Printf. (line 15) * formats, numeric output: OFMT. (line 6) * formatting output: Printf. (line 6) * forward slash (/): Regexp. (line 10) @@ -31522,6 +31525,12 @@ Index * gettext() function (C library): Explaining gettext. (line 62) * gettimeofday() extension function: Extension Sample Time. (line 13) +* git utility <1>: Adding Code. (line 111) +* git utility <2>: Accessing The Source. + (line 10) +* git utility <3>: Other Versions. (line 29) +* git utility: gawkextlib. (line 29) +* git, use of for gawk source code: Derived Files. (line 6) * GMP: Arbitrary Precision Arithmetic. (line 6) * GNITS mailing list: Acknowledgments. (line 52) @@ -31538,6 +31547,7 @@ Index * GNU/Linux <1>: Glossary. (line 624) * GNU/Linux <2>: I18N Example. (line 55) * GNU/Linux: Manual History. (line 28) +* Gordon, Assaf: Contributors. (line 105) * GPL (General Public License) <1>: Glossary. (line 314) * GPL (General Public License): Manual History. (line 11) * GPL (General Public License), printing: Options. (line 88) @@ -31555,7 +31565,7 @@ Index (line 66) * Hankerson, Darrel <1>: Contributors. (line 60) * Hankerson, Darrel: Acknowledgments. (line 60) -* Haque, John: Contributors. (line 105) +* Haque, John: Contributors. (line 108) * Hartholz, Elaine: Acknowledgments. (line 38) * Hartholz, Marshall: Acknowledgments. (line 38) * Hasegawa, Isamu: Contributors. (line 94) @@ -31643,9 +31653,9 @@ Index * installing gawk: Installation. (line 6) * INT signal (MS-Windows): Profiling. (line 214) * int() function: Numeric Functions. (line 23) -* integer, arbitrary precision: Arbitrary Precision Integers. - (line 6) * integers: General Arithmetic. (line 6) +* integers, arbitrary precision: Arbitrary Precision Integers. + (line 6) * integers, unsigned: General Arithmetic. (line 15) * interacting with other programs: I/O Functions. (line 72) * internationalization <1>: I18N and L10N. (line 6) @@ -31791,10 +31801,15 @@ Index * login information: Passwd Functions. (line 16) * long options: Command Line. (line 13) * loops: While Statement. (line 6) +* loops, break statement and: Break Statement. (line 6) * loops, continue statements and: For Statement. (line 64) * loops, count for header: Profiling. (line 131) +* loops, do-while: Do Statement. (line 6) * loops, exiting: Break Statement. (line 6) +* loops, for, array scanning: Scanning an Array. (line 6) +* loops, for, iterative: For Statement. (line 6) * loops, See Also while statement: While Statement. (line 6) +* loops, while: While Statement. (line 6) * ls utility: More Complex. (line 15) * lshift() function (gawk): Bitwise Functions. (line 46) * lvalues/rvalues: Assignment Ops. (line 32) @@ -32191,10 +32206,10 @@ Index * programming conventions, private variable names: Library Names. (line 23) * programming language, recipe for: History. (line 6) -* Programming languages, Ada: Glossary. (line 20) +* programming languages, Ada: Glossary. (line 20) * programming languages, data-driven vs. procedural: Getting Started. (line 12) -* Programming languages, Java: Glossary. (line 388) +* programming languages, Java: Glossary. (line 388) * programming, basic steps: Basic High Level. (line 20) * programming, concepts: Basic Concepts. (line 6) * pwcat program: Passwd Functions. (line 23) @@ -32331,7 +32346,7 @@ Index * RLENGTH variable, match() function and: String Functions. (line 220) * Robbins, Arnold <1>: Future Extensions. (line 6) * Robbins, Arnold <2>: Bugs. (line 32) -* Robbins, Arnold <3>: Contributors. (line 132) +* Robbins, Arnold <3>: Contributors. (line 135) * Robbins, Arnold <4>: General Data Types. (line 6) * Robbins, Arnold <5>: Alarm Program. (line 6) * Robbins, Arnold <6>: Passwd Functions. (line 90) @@ -32372,7 +32387,7 @@ Index (line 68) * sandbox mode: Options. (line 279) * scalar values: Basic Data Typing. (line 13) -* Schorr, Andrew <1>: Contributors. (line 128) +* Schorr, Andrew <1>: Contributors. (line 131) * Schorr, Andrew: Acknowledgments. (line 60) * Schreiber, Bert: Acknowledgments. (line 38) * Schreiber, Rita: Acknowledgments. (line 38) @@ -32507,6 +32522,7 @@ Index * source code, mawk: Other Versions. (line 44) * source code, mixing: Options. (line 117) * source code, pawk: Other Versions. (line 78) +* source code, pawk (Python version): Other Versions. (line 124) * source code, QSE Awk: Other Versions. (line 130) * source code, QuikTrim Awk: Other Versions. (line 134) * source code, Solaris awk: Other Versions. (line 96) @@ -32807,7 +32823,7 @@ Index * xgettext utility: String Extraction. (line 13) * XOR bitwise operation: Bitwise Functions. (line 6) * xor() function (gawk): Bitwise Functions. (line 55) -* Yawitz, Efraim: Contributors. (line 126) +* Yawitz, Efraim: Contributors. (line 129) * Zaretskii, Eli <1>: Bugs. (line 70) * Zaretskii, Eli <2>: Contributors. (line 55) * Zaretskii, Eli: Acknowledgments. (line 60) @@ -33308,62 +33324,62 @@ Ref: Ranges and Locales-Footnote-11034539 Ref: Ranges and Locales-Footnote-21034566 Ref: Ranges and Locales-Footnote-31034800 Node: Contributors1035021 -Node: Installation1040166 -Node: Gawk Distribution1041060 -Node: Getting1041544 -Node: Extracting1042370 -Node: Distribution contents1044062 -Node: Unix Installation1049767 -Node: Quick Installation1050384 -Node: Additional Configuration Options1052830 -Node: Configuration Philosophy1054566 -Node: Non-Unix Installation1056920 -Node: PC Installation1057378 -Node: PC Binary Installation1058677 -Node: PC Compiling1060525 -Node: PC Testing1063469 -Node: PC Using1064645 -Node: Cygwin1068813 -Node: MSYS1069622 -Node: VMS Installation1070136 -Node: VMS Compilation1070900 -Ref: VMS Compilation-Footnote-11072152 -Node: VMS Dynamic Extensions1072210 -Node: VMS Installation Details1073583 -Node: VMS Running1075834 -Node: VMS GNV1078668 -Node: VMS Old Gawk1079391 -Node: Bugs1079861 -Node: Other Versions1083779 -Node: Notes1089863 -Node: Compatibility Mode1090663 -Node: Additions1091446 -Node: Accessing The Source1092373 -Node: Adding Code1093813 -Node: New Ports1099858 -Node: Derived Files1103993 -Ref: Derived Files-Footnote-11109314 -Ref: Derived Files-Footnote-21109348 -Ref: Derived Files-Footnote-31109948 -Node: Future Extensions1110046 -Node: Implementation Limitations1110629 -Node: Extension Design1111881 -Node: Old Extension Problems1113035 -Ref: Old Extension Problems-Footnote-11114543 -Node: Extension New Mechanism Goals1114600 -Ref: Extension New Mechanism Goals-Footnote-11117965 -Node: Extension Other Design Decisions1118151 -Node: Extension Future Growth1120257 -Node: Old Extension Mechanism1121093 -Node: Basic Concepts1122833 -Node: Basic High Level1123514 -Ref: figure-general-flow1123785 -Ref: figure-process-flow1124384 -Ref: Basic High Level-Footnote-11127613 -Node: Basic Data Typing1127798 -Node: Glossary1131153 -Node: Copying1156615 -Node: GNU Free Documentation License1194172 -Node: Index1219309 +Node: Installation1040248 +Node: Gawk Distribution1041142 +Node: Getting1041626 +Node: Extracting1042452 +Node: Distribution contents1044144 +Node: Unix Installation1049849 +Node: Quick Installation1050466 +Node: Additional Configuration Options1052912 +Node: Configuration Philosophy1054648 +Node: Non-Unix Installation1057002 +Node: PC Installation1057460 +Node: PC Binary Installation1058759 +Node: PC Compiling1060607 +Node: PC Testing1063551 +Node: PC Using1064727 +Node: Cygwin1068895 +Node: MSYS1069704 +Node: VMS Installation1070218 +Node: VMS Compilation1070982 +Ref: VMS Compilation-Footnote-11072234 +Node: VMS Dynamic Extensions1072292 +Node: VMS Installation Details1073665 +Node: VMS Running1075916 +Node: VMS GNV1078750 +Node: VMS Old Gawk1079473 +Node: Bugs1079943 +Node: Other Versions1083861 +Node: Notes1089945 +Node: Compatibility Mode1090745 +Node: Additions1091528 +Node: Accessing The Source1092455 +Node: Adding Code1093895 +Node: New Ports1099940 +Node: Derived Files1104075 +Ref: Derived Files-Footnote-11109396 +Ref: Derived Files-Footnote-21109430 +Ref: Derived Files-Footnote-31110030 +Node: Future Extensions1110128 +Node: Implementation Limitations1110711 +Node: Extension Design1111963 +Node: Old Extension Problems1113117 +Ref: Old Extension Problems-Footnote-11114625 +Node: Extension New Mechanism Goals1114682 +Ref: Extension New Mechanism Goals-Footnote-11118047 +Node: Extension Other Design Decisions1118233 +Node: Extension Future Growth1120339 +Node: Old Extension Mechanism1121175 +Node: Basic Concepts1122915 +Node: Basic High Level1123596 +Ref: figure-general-flow1123867 +Ref: figure-process-flow1124466 +Ref: Basic High Level-Footnote-11127695 +Node: Basic Data Typing1127880 +Node: Glossary1131235 +Node: Copying1156697 +Node: GNU Free Documentation License1194254 +Node: Index1219391  End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 09beef82..d6844144 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -8359,7 +8359,7 @@ parentheses are necessary if any of the item expressions use the @samp{>} relational operator; otherwise, it can be confused with an output redirection (@pxref{Redirection}). -@cindex format strings +@cindex format specifiers The difference between @code{printf} and @code{print} is the @var{format} argument. This is an expression whose value is taken as a string; it specifies how to output each of the other arguments. It is called the @@ -12706,6 +12706,7 @@ the first thing on its line. @subsection The @code{while} Statement @cindex @code{while} statement @cindex loops +@cindex loops, @code{while} @cindex loops, See Also @code{while} statement In programming, a @dfn{loop} is a part of a program that can @@ -12766,6 +12767,7 @@ program is harder to read without it. @node Do Statement @subsection The @code{do}-@code{while} Statement @cindex @code{do}-@code{while} statement +@cindex loops, @code{do}-@code{while} The @code{do} loop is a variation of the @code{while} looping statement. The @code{do} loop executes the @var{body} once and then repeats the @@ -12811,6 +12813,7 @@ occasionally is there a real use for a @code{do} statement. @node For Statement @subsection The @code{for} Statement @cindex @code{for} statement +@cindex loops, @code{for}, iterative The @code{for} statement makes it more convenient to count iterations of a loop. The general form of the @code{for} statement looks like this: @@ -12983,6 +12986,7 @@ it is not available. @subsection The @code{break} Statement @cindex @code{break} statement @cindex loops, exiting +@cindex loops, @code{break} statement and The @code{break} statement jumps out of the innermost @code{for}, @code{while}, or @code{do} loop that encloses it. The following example @@ -14620,6 +14624,7 @@ END @{ @subsection Scanning All Elements of an Array @cindex elements in arrays, scanning @cindex arrays, scanning +@cindex loops, @code{for}, array scanning In programs that use arrays, it is often necessary to use a loop that executes once for each element of an array. In other languages, where @@ -29310,7 +29315,7 @@ the problem at hand is often the correct approach in such situations. @node Arbitrary Precision Integers @section Arbitrary Precision Integer Arithmetic with @command{gawk} -@cindex integer, arbitrary precision +@cindex integers, arbitrary precision If one of the options @option{--bignum} or @option{-M} is specified, @command{gawk} performs all @@ -33060,6 +33065,7 @@ The @code{time} extension described earlier (@pxref{Extension Sample Time}) was originally from this project but has been moved in to the main @command{gawk} distribution. +@cindex @command{git} utility You can check out the code for the @code{gawkextlib} project using the @uref{http://git-scm.com, GIT} distributed source code control system. The command is as follows: @@ -34689,6 +34695,11 @@ environments. @cindex Wallin, Anders Anders Wallin helped keep the VMS port going for several years. +@item +@cindex Gordon, Assaf +Assaf Gordon contributed the code to implement the +@option{--sandbox} option. + @item @cindex Haque, John John Haque made the following contributions: @@ -36100,6 +36111,7 @@ It is available in several archive formats: @uref{http://www.cs.princeton.edu/~bwk/btl.mirror/awk.zip} @end table +@cindex @command{git} utility You can also retrieve it from Git Hub: @example @@ -36228,6 +36240,7 @@ This is an embeddable @command{awk} interpreter derived from @uref{http://repo.hu/projects/libmawk/}. @item @code{pawk} +@cindex source code, @command{pawk} (Python version) @cindex @code{pawk}, @command{awk}-like facilities for Python This is a Python module that claims to bring @command{awk}-like features to Python. See @uref{https://github.com/alecthomas/pawk} @@ -36333,6 +36346,7 @@ As @command{gawk} is Free Software, the source code is always available. @ref{Gawk Distribution}, describes how to get and build the formal, released versions of @command{gawk}. +@cindex @command{git} utility However, if you want to modify @command{gawk} and contribute back your changes, you will probably wish to work with the development version. To do so, you will need to access the @command{gawk} source code @@ -36508,6 +36522,7 @@ If possible, please update the @command{man} page as well. You will also have to sign paperwork for your documentation changes. +@cindex @command{git} utility @item Submit changes as unified diffs. Use @samp{diff -u -r -N} to compare @@ -36641,6 +36656,8 @@ coding style and brace layout that suits your taste. @node Derived Files @appendixsubsec Why Generated Files Are Kept In @command{git} +@c STARTOFRANGE gawkgit +@cindex @command{git}, use of for @command{gawk} source code @c From emails written March 22, 2012, to the gawk developers list. If you look at the @command{gawk} source in the @command{git} @@ -36820,7 +36837,7 @@ wget http://git.savannah.gnu.org/cgit/gawk.git/snapshot/gawk-@var{branchname}.ta @noindent to retrieve a snapshot of the given branch. - +@c ENDOFRANGE gawkgit @node Future Extensions @appendixsec Probable Future Extensions @@ -37399,7 +37416,7 @@ better written in another language. You can get it from @uref{http://awk.info/?awk100/aaa}. @cindex Ada programming language -@cindex Programming languages, Ada +@cindex programming languages, Ada @item Ada A programming language originally defined by the U.S.@: Department of Defense for embedded programming. It was designed to enforce good @@ -37882,7 +37899,7 @@ information about the name of the organization and its language-independent three-letter acronym. @cindex Java programming language -@cindex Programming languages, Java +@cindex programming languages, Java @item Java A modern programming language originally developed by Sun Microsystems (now Oracle) supporting Object-Oriented programming. Although usually diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 6d7c5055..1fe75843 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -7977,7 +7977,7 @@ parentheses are necessary if any of the item expressions use the @samp{>} relational operator; otherwise, it can be confused with an output redirection (@pxref{Redirection}). -@cindex format strings +@cindex format specifiers The difference between @code{printf} and @code{print} is the @var{format} argument. This is an expression whose value is taken as a string; it specifies how to output each of the other arguments. It is called the @@ -12083,6 +12083,7 @@ the first thing on its line. @subsection The @code{while} Statement @cindex @code{while} statement @cindex loops +@cindex loops, @code{while} @cindex loops, See Also @code{while} statement In programming, a @dfn{loop} is a part of a program that can @@ -12143,6 +12144,7 @@ program is harder to read without it. @node Do Statement @subsection The @code{do}-@code{while} Statement @cindex @code{do}-@code{while} statement +@cindex loops, @code{do}-@code{while} The @code{do} loop is a variation of the @code{while} looping statement. The @code{do} loop executes the @var{body} once and then repeats the @@ -12188,6 +12190,7 @@ occasionally is there a real use for a @code{do} statement. @node For Statement @subsection The @code{for} Statement @cindex @code{for} statement +@cindex loops, @code{for}, iterative The @code{for} statement makes it more convenient to count iterations of a loop. The general form of the @code{for} statement looks like this: @@ -12360,6 +12363,7 @@ it is not available. @subsection The @code{break} Statement @cindex @code{break} statement @cindex loops, exiting +@cindex loops, @code{break} statement and The @code{break} statement jumps out of the innermost @code{for}, @code{while}, or @code{do} loop that encloses it. The following example @@ -13951,6 +13955,7 @@ END @{ @subsection Scanning All Elements of an Array @cindex elements in arrays, scanning @cindex arrays, scanning +@cindex loops, @code{for}, array scanning In programs that use arrays, it is often necessary to use a loop that executes once for each element of an array. In other languages, where @@ -28451,7 +28456,7 @@ the problem at hand is often the correct approach in such situations. @node Arbitrary Precision Integers @section Arbitrary Precision Integer Arithmetic with @command{gawk} -@cindex integer, arbitrary precision +@cindex integers, arbitrary precision If one of the options @option{--bignum} or @option{-M} is specified, @command{gawk} performs all @@ -32201,6 +32206,7 @@ The @code{time} extension described earlier (@pxref{Extension Sample Time}) was originally from this project but has been moved in to the main @command{gawk} distribution. +@cindex @command{git} utility You can check out the code for the @code{gawkextlib} project using the @uref{http://git-scm.com, GIT} distributed source code control system. The command is as follows: @@ -33830,6 +33836,11 @@ environments. @cindex Wallin, Anders Anders Wallin helped keep the VMS port going for several years. +@item +@cindex Gordon, Assaf +Assaf Gordon contributed the code to implement the +@option{--sandbox} option. + @item @cindex Haque, John John Haque made the following contributions: @@ -35241,6 +35252,7 @@ It is available in several archive formats: @uref{http://www.cs.princeton.edu/~bwk/btl.mirror/awk.zip} @end table +@cindex @command{git} utility You can also retrieve it from Git Hub: @example @@ -35369,6 +35381,7 @@ This is an embeddable @command{awk} interpreter derived from @uref{http://repo.hu/projects/libmawk/}. @item @code{pawk} +@cindex source code, @command{pawk} (Python version) @cindex @code{pawk}, @command{awk}-like facilities for Python This is a Python module that claims to bring @command{awk}-like features to Python. See @uref{https://github.com/alecthomas/pawk} @@ -35474,6 +35487,7 @@ As @command{gawk} is Free Software, the source code is always available. @ref{Gawk Distribution}, describes how to get and build the formal, released versions of @command{gawk}. +@cindex @command{git} utility However, if you want to modify @command{gawk} and contribute back your changes, you will probably wish to work with the development version. To do so, you will need to access the @command{gawk} source code @@ -35649,6 +35663,7 @@ If possible, please update the @command{man} page as well. You will also have to sign paperwork for your documentation changes. +@cindex @command{git} utility @item Submit changes as unified diffs. Use @samp{diff -u -r -N} to compare @@ -35782,6 +35797,8 @@ coding style and brace layout that suits your taste. @node Derived Files @appendixsubsec Why Generated Files Are Kept In @command{git} +@c STARTOFRANGE gawkgit +@cindex @command{git}, use of for @command{gawk} source code @c From emails written March 22, 2012, to the gawk developers list. If you look at the @command{gawk} source in the @command{git} @@ -35961,7 +35978,7 @@ wget http://git.savannah.gnu.org/cgit/gawk.git/snapshot/gawk-@var{branchname}.ta @noindent to retrieve a snapshot of the given branch. - +@c ENDOFRANGE gawkgit @node Future Extensions @appendixsec Probable Future Extensions @@ -36540,7 +36557,7 @@ better written in another language. You can get it from @uref{http://awk.info/?awk100/aaa}. @cindex Ada programming language -@cindex Programming languages, Ada +@cindex programming languages, Ada @item Ada A programming language originally defined by the U.S.@: Department of Defense for embedded programming. It was designed to enforce good @@ -37023,7 +37040,7 @@ information about the name of the organization and its language-independent three-letter acronym. @cindex Java programming language -@cindex Programming languages, Java +@cindex programming languages, Java @item Java A modern programming language originally developed by Sun Microsystems (now Oracle) supporting Object-Oriented programming. Although usually -- cgit v1.2.1