diff options
| author | Arnold D. Robbins <arnold@skeeve.com> | 2013-11-28 21:49:56 +0200 |
|---|---|---|
| committer | Arnold D. Robbins <arnold@skeeve.com> | 2013-11-28 21:49:56 +0200 |
| commit | eac9994fe3f765848d7815bb32ece216cd3a7cac (patch) | |
| tree | 37ec5d85390312216972df1a116b153bacaecb29 | |
| parent | 7e7f5610683ea455b6d40297b0c3cd11156006da (diff) | |
| download | egawk-eac9994fe3f765848d7815bb32ece216cd3a7cac.tar.gz egawk-eac9994fe3f765848d7815bb32ece216cd3a7cac.tar.bz2 egawk-eac9994fe3f765848d7815bb32ece216cd3a7cac.zip | |
Some doc edits.
| -rw-r--r-- | doc/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/gawk.info | 1212 | ||||
| -rw-r--r-- | doc/gawk.texi | 91 | ||||
| -rw-r--r-- | doc/gawktexi.in | 87 |
4 files changed, 689 insertions, 706 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 28bd526d..854cad6d 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2013-11-28 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in: Update quotations to use @author, fix a few + placements of footnotes. + 2013-11-08 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Update the list of files included in the gawk diff --git a/doc/gawk.info b/doc/gawk.info index 0bbd7728..24f08018 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -1084,8 +1084,8 @@ Dark Corners ------------ Dark corners are basically fractal -- no matter how much you - illuminate, there's always a smaller but darker one. - Brian Kernighan + illuminate, there's always a smaller but darker one. -- Brian + Kernighan Until the POSIX standard (and `GAWK: Effective AWK Programming'), many features of `awk' were either poorly documented or not documented @@ -3065,8 +3065,7 @@ File: gawk.info, Node: Undocumented, Prev: Obsolete, Up: Invoking Gawk 2.10 Undocumented Options and Features ====================================== - Use the Source, Luke! - Obi-Wan + Use the Source, Luke! -- Obi-Wan This minor node intentionally left blank. @@ -5304,8 +5303,7 @@ File: gawk.info, Node: Getline/Pipe, Next: Getline/Variable/Pipe, Prev: Getli --------------------------------- Omniscience has much to recommend it. Failing that, attention to - details would be useful. - Brian Kernighan + details would be useful. -- Brian Kernighan The output of a command can also be piped into `getline', using `COMMAND | getline'. In this case, the string COMMAND is run as a @@ -7315,8 +7313,7 @@ File: gawk.info, Node: Concatenation, Next: Assignment Ops, Prev: Arithmetic 6.2.2 String Concatenation -------------------------- - It seemed like a good idea at the time. - Brian Kernighan + It seemed like a good idea at the time. -- Brian Kernighan There is only one string operation: concatenation. It does not have a specific operator to represent it. Instead, concatenation is @@ -7622,8 +7619,7 @@ is a summary of increment and decrement expressions: Operator Evaluation Order Doctor, doctor! It hurts when I do this! - So don't do that! - Groucho Marx + So don't do that! -- Groucho Marx What happens for something like the following? @@ -7704,8 +7700,8 @@ File: gawk.info, Node: Typing and Comparison, Next: Boolean Ops, Prev: Truth 6.3.2 Variable Typing and Comparison Expressions ------------------------------------------------ - The Guide is definitive. Reality is frequently inaccurate. - The Hitchhiker's Guide to the Galaxy + The Guide is definitive. Reality is frequently inaccurate. -- The + Hitchhiker's Guide to the Galaxy Unlike other programming languages, `awk' variables do not have a fixed type. Instead, they can be either a number or a string, depending @@ -10133,8 +10129,7 @@ File: gawk.info, Node: Array Intro, Next: Reference to Elements, Up: Array Ba ---------------------------- Doing linear scans over an associative array is like trying to - club someone to death with a loaded Uzi. - Larry Wall + club someone to death with a loaded Uzi. -- Larry Wall The `awk' language provides one-dimensional arrays for storing groups of related strings or numbers. Every `awk' array must have a @@ -12430,7 +12425,7 @@ File: gawk.info, Node: Bitwise Functions, Next: Type Functions, Prev: Time Fu 9.1.6 Bit-Manipulation Functions -------------------------------- - I can explain it for you, but I can't understand it for you. + I can explain it for you, but I can't understand it for you. -- Anonymous Many languages provide the ability to perform "bitwise" operations @@ -13500,7 +13495,7 @@ algorithms and program tasks in a single place. It simplifies programming, making program development more manageable, and making programs more readable. - In their seminal 1976 book, `Software Tools'(1), Brian Kernighan and + In their seminal 1976 book, `Software Tools',(1) Brian Kernighan and P.J. Plauger wrote: Good Programming is not learned from generalities, but by seeing @@ -16640,8 +16635,8 @@ File: gawk.info, Node: Alarm Program, Next: Translate Program, Prev: Dupword 11.3.2 An Alarm Clock Program ----------------------------- - Nothing cures insomnia like a ringing alarm clock. - Arnold Robbins + Nothing cures insomnia like a ringing alarm clock. -- Arnold + Robbins The following program is a simple "alarm clock" program. You give it a time of day and an optional message. At the specified time, it @@ -16885,10 +16880,10 @@ program. ---------- Footnotes ---------- - (1) On some older systems, `tr' may require that the lists be -written as range expressions enclosed in square brackets (`[a-z]') and -quoted, to prevent the shell from attempting a file name expansion. -This is not a feature. + (1) On some older systems, including Solaris, `tr' may require that +the lists be written as range expressions enclosed in square brackets +(`[a-z]') and quoted, to prevent the shell from attempting a file name +expansion. This is not a feature. (2) This program was written before `gawk' acquired the ability to split each character in a string into separate array elements. @@ -17954,8 +17949,8 @@ File: gawk.info, Node: Advanced Features, Next: Internationalization, Prev: S ****************************** Write documentation as if whoever reads it is a violent psychopath - who knows where you live. - Steve English, as quoted by Peter Langston + who knows where you live. -- Steve English, as quoted by Peter + Langston This major node discusses advanced features in `gawk'. It's a bit of a "grab bag" of items that are otherwise unrelated to each other. @@ -20452,8 +20447,7 @@ File: gawk.info, Node: Arbitrary Precision Arithmetic, Next: Dynamic Extension authority; they tend to believe that all digits of a printed answer are significant. Disillusioned computer users have just the opposite approach; they are constantly afraid that their answers - are almost meaningless. - Donald Knuth(1) + are almost meaningless.(1) -- Donald Knuth This major node discusses issues that you may encounter when performing arithmetic. It begins by discussing some of the general @@ -21334,9 +21328,7 @@ File: gawk.info, Node: Changing Precision, Next: Exact Arithmetic, Prev: Floa them to full membership of the high-precision club, or do we treat them and all their associates as second-class citizens? Sometimes the first course is proper, sometimes the second, and it takes - careful analysis to tell which. - - Dirk Laurie(1) + careful analysis to tell which.(1) -- Dirk Laurie `gawk' does not implicitly modify the precision of any previously computed results when the working precision is changed with an @@ -21844,12 +21836,9 @@ File: gawk.info, Node: General Data Types, Next: Requesting Values, Prev: Ext 16.4.2 General Purpose Data Types --------------------------------- - I have a true love/hate relationship with unions. - Arnold Robbins - - That's the thing about unions: the compiler will arrange things so - they can accommodate both love and hate. - Chet Ramey + I have a true love/hate relationship with unions. -- Arnold + Robbins That's the thing about unions: the compiler will arrange + things so they can accommodate both love and hate. -- Chet Ramey The extension API defines a number of simple types and structures for general purpose use. Additional, more specialized, data structures @@ -23632,8 +23621,7 @@ File: gawk.info, Node: Extension Example, Next: Extension Samples, Prev: Find 16.6 Example: Some File Functions ================================= - No matter where you go, there you are. - Buckaroo Bonzai + No matter where you go, there you are. -- Buckaroo Bonzai Two useful functions that are not in `awk' are `chdir()' (so that an `awk' program can change its directory) and `stat()' (so that an `awk' @@ -25364,8 +25352,7 @@ File: gawk.info, Node: Contributors, Prev: Ranges and Locales, Up: Language H A.8 Major Contributors to `gawk' ================================ - Always give credit where credit is due. - Anonymous + Always give credit where credit is due. -- Anonymous This minor node names the major contributors to `gawk' and/or this Info file, in approximate chronological order: @@ -26376,8 +26363,8 @@ File: gawk.info, Node: Bugs, Next: Other Versions, Prev: Non-Unix Installatio B.4 Reporting Problems and Bugs =============================== - There is nothing more dangerous than a bored archeologist. - The Hitchhiker's Guide to the Galaxy + There is nothing more dangerous than a bored archeologist. -- The + Hitchhiker's Guide to the Galaxy If you have problems with `gawk' or think that you have found a bug, please report it to the developers; we cannot promise to do anything @@ -26456,8 +26443,8 @@ B.5 Other Freely Available `awk' Implementations ================================================ It's kind of fun to put comments like this in your awk code. - `// Do C++ comments work? answer: yes! of course' - Michael Brennan + `// Do C++ comments work? answer: yes! of course' -- Michael + Brennan There are a number of other freely available `awk' implementations. This minor node briefly describes where to get them: @@ -27060,10 +27047,7 @@ C.3 Probable Future Extensions ============================== AWK is a language similar to PERL, only considerably more elegant. - Arnold Robbins - - Hey! - Larry Wall + -- Arnold Robbins Hey! -- Larry Wall The `TODO' file in the `gawk' Git repository lists possible future enhancements. Some of these relate to the source code, and others to @@ -29681,7 +29665,7 @@ Index (line 23) * advanced features, specifying field content: Splitting By Content. (line 9) -* Aho, Alfred <1>: Contributors. (line 12) +* Aho, Alfred <1>: Contributors. (line 11) * Aho, Alfred: History. (line 17) * alarm clock example program: Alarm Program. (line 9) * alarm.awk program: Alarm Program. (line 29) @@ -29720,7 +29704,7 @@ Index * arrays: Arrays. (line 6) * arrays, as parameters to functions: Pass By Value/Reference. (line 47) -* arrays, associative: Array Intro. (line 50) +* arrays, associative: Array Intro. (line 49) * arrays, associative, library functions and: Library Names. (line 57) * arrays, deleting entire contents: Delete. (line 39) * arrays, elements, assigning: Assigning Elements. (line 6) @@ -29730,8 +29714,8 @@ Index (line 6) * arrays, elements, retrieving number of: String Functions. (line 29) * arrays, for statement and: Scanning an Array. (line 20) -* arrays, IGNORECASE variable and: Array Intro. (line 92) -* arrays, indexing: Array Intro. (line 50) +* arrays, IGNORECASE variable and: Array Intro. (line 91) +* arrays, indexing: Array Intro. (line 49) * arrays, merging into strings: Join Function. (line 6) * arrays, multidimensional: Multidimensional. (line 10) * arrays, multidimensional, scanning: Multiscanning. (line 11) @@ -29741,7 +29725,7 @@ Index (line 6) * arrays, sorting, IGNORECASE variable and: Array Sorting Functions. (line 81) -* arrays, sparse: Array Intro. (line 71) +* arrays, sparse: Array Intro. (line 70) * arrays, subscripts: Numeric Array Subscripts. (line 6) * arrays, subscripts, uninitialized variables as: Uninitialized Subscripts. @@ -29763,7 +29747,7 @@ Index * assignment operators, evaluation order: Assignment Ops. (line 111) * assignment operators, lvalues/rvalues: Assignment Ops. (line 32) * assignments as filenames: Ignoring Assigns. (line 6) -* associative arrays: Array Intro. (line 50) +* associative arrays: Array Intro. (line 49) * asterisk (*), * operator, as multiplication operator: Precedence. (line 55) * asterisk (*), * operator, as regexp operator: Regexp Operators. @@ -29917,7 +29901,7 @@ Index * BEGINFILE pattern, Boolean patterns and: Expression Patterns. (line 73) * beginfile() user-defined function: Filetrans Function. (line 62) -* Benzinger, Michael: Contributors. (line 98) +* Benzinger, Michael: Contributors. (line 97) * Berry, Karl: Acknowledgments. (line 33) * binary input/output: User-modified. (line 10) * bindtextdomain() function (C library): Explaining gettext. (line 49) @@ -29962,12 +29946,12 @@ Index * Brennan, Michael: Delete. (line 56) * Brian Kernighan's awk: Other Versions. (line 13) * Brian Kernighan's awk, extensions: BTL. (line 6) -* Broder, Alan J.: Contributors. (line 89) -* Brown, Martin: Contributors. (line 83) +* Broder, Alan J.: Contributors. (line 88) +* Brown, Martin: Contributors. (line 82) * BSD-based operating systems: Glossary. (line 624) * bt debugger command (alias for backtrace): Execution Stack. (line 13) * Buening, Andreas <1>: Bugs. (line 71) -* Buening, Andreas <2>: Contributors. (line 93) +* Buening, Andreas <2>: Contributors. (line 92) * Buening, Andreas: Acknowledgments. (line 60) * buffering, input/output <1>: Two-way I/O. (line 70) * buffering, input/output: I/O Functions. (line 137) @@ -29996,7 +29980,7 @@ Index * caret (^), in bracket expressions: Bracket Expressions. (line 17) * caret (^), regexp operator: Regexp Operators. (line 22) * case keyword: Switch Statement. (line 6) -* case sensitivity, array indices and: Array Intro. (line 92) +* case sensitivity, array indices and: Array Intro. (line 91) * case sensitivity, converting case: String Functions. (line 524) * case sensitivity, example programs: Library Functions. (line 53) * case sensitivity, gawk: Case-sensitivity. (line 26) @@ -30028,13 +30012,13 @@ Index * close() function <1>: I/O Functions. (line 10) * close() function <2>: Close Files And Pipes. (line 18) -* close() function <3>: Getline/Pipe. (line 28) +* close() function <3>: Getline/Pipe. (line 27) * close() function: Getline/Variable/File. (line 30) * close() function, return value: Close Files And Pipes. (line 130) * close() function, two-way pipes and: Two-way I/O. (line 77) -* Close, Diane <1>: Contributors. (line 21) +* Close, Diane <1>: Contributors. (line 20) * Close, Diane: Manual History. (line 41) * Collado, Manuel: Acknowledgments. (line 60) * collating elements: Bracket Expressions. (line 69) @@ -30100,7 +30084,7 @@ Index * compl() function (gawk): Bitwise Functions. (line 43) * complement, bitwise: Bitwise Functions. (line 25) * compound statements, control statements and: Statements. (line 10) -* concatenating: Concatenation. (line 9) +* concatenating: Concatenation. (line 8) * condition debugger command: Breakpoint Control. (line 54) * conditional expressions: Conditional Exp. (line 6) * configuration option, --disable-lint: Additional Configuration Options. @@ -30202,7 +30186,7 @@ Index * dates, converting to timestamps: Time Functions. (line 75) * dates, information related to, localization: Explaining gettext. (line 115) -* Davies, Stephen <1>: Contributors. (line 75) +* Davies, Stephen <1>: Contributors. (line 74) * Davies, Stephen: Acknowledgments. (line 60) * dcgettext() function (gawk) <1>: Programmer i18n. (line 19) * dcgettext() function (gawk): I18N Functions. (line 22) @@ -30315,7 +30299,7 @@ Index * decrement operators: Increment Ops. (line 35) * default keyword: Switch Statement. (line 6) * Deifik, Scott <1>: Bugs. (line 70) -* Deifik, Scott <2>: Contributors. (line 54) +* Deifik, Scott <2>: Contributors. (line 53) * Deifik, Scott: Acknowledgments. (line 60) * delete debugger command: Breakpoint Control. (line 64) * delete statement: Delete. (line 6) @@ -30481,7 +30465,7 @@ Index * eval debugger command: Viewing And Changing Data. (line 23) * evaluation order: Increment Ops. (line 60) -* evaluation order, concatenation: Concatenation. (line 42) +* evaluation order, concatenation: Concatenation. (line 41) * evaluation order, functions: Calling Built-in. (line 30) * examining fields: Fields. (line 6) * exclamation point (!), ! operator <1>: Egrep Program. (line 170) @@ -30544,7 +30528,7 @@ Index * features, advanced, See advanced features: Obsolete. (line 6) * features, deprecated: Obsolete. (line 6) * features, undocumented: Undocumented. (line 6) -* Fenlason, Jay <1>: Contributors. (line 19) +* Fenlason, Jay <1>: Contributors. (line 18) * Fenlason, Jay: History. (line 30) * fflush() function: I/O Functions. (line 25) * field numbers: Nonconstant Fields. (line 6) @@ -30642,7 +30626,7 @@ Index * files, Texinfo, extracting programs from: Extract Program. (line 6) * finish debugger command: Debugger Execution Control. (line 39) -* Fish, Fred: Contributors. (line 51) +* Fish, Fred: Contributors. (line 50) * fixed-width data: Constant Size. (line 9) * flag variables <1>: Tee Program. (line 20) * flag variables: Boolean Ops. (line 67) @@ -30748,7 +30732,7 @@ Index * functions, user-defined, next/nextfile statements and: Next Statement. (line 45) * G-d: Acknowledgments. (line 78) -* Garfinkle, Scott: Contributors. (line 35) +* Garfinkle, Scott: Contributors. (line 34) * gawk program, dynamic profiling: Profiling. (line 172) * gawk, ARGIND variable in: Other Arguments. (line 12) * gawk, awk and <1>: This Manual. (line 14) @@ -30793,7 +30777,7 @@ Index * gawk, IGNORECASE variable in <1>: Array Sorting Functions. (line 81) * gawk, IGNORECASE variable in <2>: String Functions. (line 29) -* gawk, IGNORECASE variable in <3>: Array Intro. (line 92) +* gawk, IGNORECASE variable in <3>: Array Intro. (line 91) * gawk, IGNORECASE variable in <4>: User-modified. (line 82) * gawk, IGNORECASE variable in: Case-sensitivity. (line 26) * gawk, implementation issues: Notes. (line 6) @@ -30909,7 +30893,7 @@ Index * GPL (General Public License): Manual History. (line 11) * GPL (General Public License), printing: Options. (line 102) * grcat program: Group Functions. (line 16) -* Grigera, Juan: Contributors. (line 58) +* Grigera, Juan: Contributors. (line 57) * group database, reading: Group Functions. (line 6) * group file: Group Functions. (line 6) * groups, information about: Group Functions. (line 6) @@ -30920,12 +30904,12 @@ Index * gsub() function, escape processing: Gory Details. (line 6) * h debugger command (alias for help): Miscellaneous Debugger Commands. (line 66) -* Hankerson, Darrel <1>: Contributors. (line 61) +* Hankerson, Darrel <1>: Contributors. (line 60) * Hankerson, Darrel: Acknowledgments. (line 60) -* Haque, John: Contributors. (line 104) +* Haque, John: Contributors. (line 103) * Hartholz, Elaine: Acknowledgments. (line 38) * Hartholz, Marshall: Acknowledgments. (line 38) -* Hasegawa, Isamu: Contributors. (line 95) +* Hasegawa, Isamu: Contributors. (line 94) * help debugger command: Miscellaneous Debugger Commands. (line 66) * hexadecimal numbers: Nondecimal-numbers. (line 6) @@ -30953,12 +30937,12 @@ Index * IGNORECASE variable <1>: Array Sorting Functions. (line 81) * IGNORECASE variable <2>: String Functions. (line 29) -* IGNORECASE variable <3>: Array Intro. (line 92) +* IGNORECASE variable <3>: Array Intro. (line 91) * IGNORECASE variable <4>: User-modified. (line 82) * IGNORECASE variable: Case-sensitivity. (line 26) * IGNORECASE variable, array sorting and: Array Sorting Functions. (line 81) -* IGNORECASE variable, array subscripts and: Array Intro. (line 92) +* IGNORECASE variable, array subscripts and: Array Intro. (line 91) * IGNORECASE variable, in example programs: Library Functions. (line 53) * Illumos: Other Versions. (line 104) @@ -30977,7 +30961,7 @@ Index (line 11) * increment operators: Increment Ops. (line 6) * index() function: String Functions. (line 155) -* indexing arrays: Array Intro. (line 50) +* indexing arrays: Array Intro. (line 49) * indirect function calls: Indirect Calls. (line 6) * infinite precision: Arbitrary Precision Arithmetic. (line 6) @@ -30993,7 +30977,7 @@ Index * input files, reading: Reading Files. (line 6) * input files, running awk without: Read Terminal. (line 6) * input files, variable assignments and: Other Arguments. (line 19) -* input pipeline: Getline/Pipe. (line 10) +* input pipeline: Getline/Pipe. (line 9) * input redirection: Getline/File. (line 6) * input, data, nondecimal: Nondecimal Data. (line 6) * input, explicit: Getline. (line 6) @@ -31040,20 +31024,20 @@ Index * ISO 8859-1: Glossary. (line 141) * ISO Latin-1: Glossary. (line 141) * Jacobs, Andrew: Passwd Functions. (line 90) -* Jaegermann, Michal <1>: Contributors. (line 46) +* Jaegermann, Michal <1>: Contributors. (line 45) * Jaegermann, Michal: Acknowledgments. (line 60) * Java implementation of awk: Other Versions. (line 112) * Java programming language: Glossary. (line 388) * jawk: Other Versions. (line 112) * Jedi knights: Undocumented. (line 6) * join() user-defined function: Join Function. (line 18) -* Kahrs, Ju"rgen <1>: Contributors. (line 71) +* Kahrs, Ju"rgen <1>: Contributors. (line 70) * Kahrs, Ju"rgen: Acknowledgments. (line 60) * Kasal, Stepan: Acknowledgments. (line 60) * Kenobi, Obi-Wan: Undocumented. (line 6) * Kernighan, Brian <1>: Basic Data Typing. (line 55) * Kernighan, Brian <2>: Other Versions. (line 13) -* Kernighan, Brian <3>: Contributors. (line 12) +* Kernighan, Brian <3>: Contributors. (line 11) * Kernighan, Brian <4>: BTL. (line 6) * Kernighan, Brian <5>: Concatenation. (line 6) * Kernighan, Brian <6>: Acknowledgments. (line 72) @@ -31063,7 +31047,7 @@ Index * Knights, jedi: Undocumented. (line 6) * Knuth, Donald: Arbitrary Precision Arithmetic. (line 6) -* Kwok, Conrad: Contributors. (line 35) +* Kwok, Conrad: Contributors. (line 34) * l debugger command (alias for list): Miscellaneous Debugger Commands. (line 72) * labels.awk program: Labels Program. (line 51) @@ -31178,7 +31162,7 @@ Index * matching, leftmost longest: Multiple Line. (line 26) * matching, null strings: Gory Details. (line 164) * mawk program: Other Versions. (line 44) -* McPhee, Patrick: Contributors. (line 101) +* McPhee, Patrick: Contributors. (line 100) * message object files: Explaining gettext. (line 41) * message object files, converting from portable object files: I18N Example. (line 62) @@ -31310,7 +31294,7 @@ Index * operators, input/output <1>: Precedence. (line 65) * operators, input/output <2>: Redirection. (line 22) * operators, input/output <3>: Getline/Coprocess. (line 6) -* operators, input/output <4>: Getline/Pipe. (line 10) +* operators, input/output <4>: Getline/Pipe. (line 9) * operators, input/output: Getline/File. (line 6) * operators, logical, See Boolean expressions: Boolean Ops. (line 6) * operators, precedence <1>: Precedence. (line 6) @@ -31318,7 +31302,7 @@ Index * operators, relational, See operators, comparison: Typing and Comparison. (line 9) * operators, short-circuit: Boolean Ops. (line 57) -* operators, string: Concatenation. (line 9) +* operators, string: Concatenation. (line 8) * operators, string-matching: Regexp Usage. (line 19) * operators, string-matching, for buffers: GNU Regexp Operators. (line 48) @@ -31342,7 +31326,7 @@ Index * ord extension function: Extension Sample Ord. (line 12) * ord() user-defined function: Ordinal Functions. (line 16) -* order of evaluation, concatenation: Concatenation. (line 42) +* order of evaluation, concatenation: Concatenation. (line 41) * ORS variable <1>: User-modified. (line 129) * ORS variable: Output Separators. (line 20) * output field separator, See OFS variable: Changing Fields. (line 64) @@ -31386,11 +31370,11 @@ Index * percent sign (%), %= operator: Assignment Ops. (line 129) * period (.): Regexp Operators. (line 43) * Perl: Future Extensions. (line 6) -* Peters, Arno: Contributors. (line 86) -* Peterson, Hal: Contributors. (line 40) +* Peters, Arno: Contributors. (line 85) +* Peterson, Hal: Contributors. (line 39) * pipes, closing: Close Files And Pipes. (line 6) -* pipes, input: Getline/Pipe. (line 10) +* pipes, input: Getline/Pipe. (line 9) * pipes, output: Redirection. (line 57) * Pitts, Dave <1>: Bugs. (line 73) * Pitts, Dave: Acknowledgments. (line 60) @@ -31474,7 +31458,7 @@ Index * POSIX awk, printf format strings and: Format Modifiers. (line 159) * POSIX awk, regular expressions and: Regexp Operators. (line 161) * POSIX awk, timestamps and: Time Functions. (line 6) -* POSIX awk, | I/O operator and: Getline/Pipe. (line 56) +* POSIX awk, | I/O operator and: Getline/Pipe. (line 55) * POSIX mode: Options. (line 247) * POSIX, awk and: Preface. (line 23) * POSIX, gawk extensions not included in: POSIX/GNU. (line 6) @@ -31584,7 +31568,7 @@ Index * range expressions (regexps): Bracket Expressions. (line 6) * range patterns: Ranges. (line 6) * Rankin, Pat <1>: Bugs. (line 72) -* Rankin, Pat <2>: Contributors. (line 38) +* Rankin, Pat <2>: Contributors. (line 37) * Rankin, Pat <3>: Assignment Ops. (line 100) * Rankin, Pat: Acknowledgments. (line 60) * reada extension function: Extension Sample Read write array. @@ -31685,19 +31669,19 @@ Index * RLENGTH variable, match() function and: String Functions. (line 225) * Robbins, Arnold <1>: Future Extensions. (line 6) * Robbins, Arnold <2>: Bugs. (line 32) -* Robbins, Arnold <3>: Contributors. (line 131) +* Robbins, Arnold <3>: Contributors. (line 130) * Robbins, Arnold <4>: Alarm Program. (line 6) * Robbins, Arnold <5>: Passwd Functions. (line 90) -* Robbins, Arnold <6>: Getline/Pipe. (line 40) +* Robbins, Arnold <6>: Getline/Pipe. (line 39) * Robbins, Arnold: Command Line Field Separator. (line 80) -* Robbins, Bill: Getline/Pipe. (line 40) +* Robbins, Bill: Getline/Pipe. (line 39) * Robbins, Harry: Acknowledgments. (line 78) * Robbins, Jean: Acknowledgments. (line 78) * Robbins, Miriam <1>: Passwd Functions. (line 90) -* Robbins, Miriam <2>: Getline/Pipe. (line 40) +* Robbins, Miriam <2>: Getline/Pipe. (line 39) * Robbins, Miriam: Acknowledgments. (line 78) -* Rommel, Kai Uwe: Contributors. (line 43) +* Rommel, Kai Uwe: Contributors. (line 42) * round() user-defined function: Round Function. (line 16) * rounding mode, floating-point: Rounding Mode. (line 6) * rounding numbers: Round Function. (line 6) @@ -31715,7 +31699,7 @@ Index (line 10) * RT variable <3>: Multiple Line. (line 129) * RT variable: Records. (line 117) -* Rubin, Paul <1>: Contributors. (line 16) +* Rubin, Paul <1>: Contributors. (line 15) * Rubin, Paul: History. (line 30) * rule, definition of: Getting Started. (line 21) * run debugger command: Debugger Execution Control. @@ -31725,7 +31709,7 @@ Index (line 68) * sandbox mode: Options. (line 279) * scalar values: Basic Data Typing. (line 13) -* Schorr, Andrew <1>: Contributors. (line 127) +* Schorr, Andrew <1>: Contributors. (line 126) * Schorr, Andrew: Acknowledgments. (line 60) * Schreiber, Bert: Acknowledgments. (line 38) * Schreiber, Rita: Acknowledgments. (line 38) @@ -31775,7 +31759,7 @@ Index * si debugger command (alias for stepi): Debugger Execution Control. (line 76) * side effects <1>: Increment Ops. (line 11) -* side effects: Concatenation. (line 42) +* side effects: Concatenation. (line 41) * side effects, array indexing: Reference to Elements. (line 42) * side effects, asort() function: Array Sorting Functions. @@ -31861,7 +31845,7 @@ Index * source code, QuikTrim Awk: Other Versions. (line 134) * source code, Solaris awk: Other Versions. (line 96) * source files, search path for: Igawk Program. (line 368) -* sparse arrays: Array Intro. (line 71) +* sparse arrays: Array Intro. (line 70) * Spencer, Henry: Glossary. (line 12) * split utility: Split Program. (line 6) * split() function: String Functions. (line 317) @@ -31876,7 +31860,7 @@ Index * square brackets ([]): Regexp Operators. (line 55) * srand() function: Numeric Functions. (line 82) * Stallman, Richard <1>: Glossary. (line 305) -* Stallman, Richard <2>: Contributors. (line 24) +* Stallman, Richard <2>: Contributors. (line 23) * Stallman, Richard <3>: Acknowledgments. (line 18) * Stallman, Richard: Manual History. (line 6) * standard error: Special FD. (line 6) @@ -31900,7 +31884,7 @@ Index * string constants, vs. regexp constants: Computed Regexps. (line 38) * string extraction (internationalization): String Extraction. (line 6) -* string operators: Concatenation. (line 9) +* string operators: Concatenation. (line 8) * string-matching operators: Regexp Usage. (line 19) * strings, converting <1>: Bitwise Functions. (line 109) * strings, converting: Conversion. (line 6) @@ -32021,13 +32005,13 @@ Index * troubleshooting, readable data files: File Checking. (line 6) * troubleshooting, regexp constants vs. string constants: Computed Regexps. (line 38) -* troubleshooting, string concatenation: Concatenation. (line 27) +* troubleshooting, string concatenation: Concatenation. (line 26) * troubleshooting, substr() function: String Functions. (line 501) * troubleshooting, system() function: I/O Functions. (line 94) * troubleshooting, typographical errors, global variables: Options. (line 112) * true, logical: Truth Values. (line 6) -* Trueman, David <1>: Contributors. (line 31) +* Trueman, David <1>: Contributors. (line 30) * Trueman, David <2>: Acknowledgments. (line 47) * Trueman, David: History. (line 30) * trunc-mod operation: Arithmetic Ops. (line 66) @@ -32107,7 +32091,7 @@ Index * variables, user-defined: Variables. (line 6) * vertical bar (|): Regexp Operators. (line 69) * vertical bar (|), | operator (I/O) <1>: Precedence. (line 65) -* vertical bar (|), | operator (I/O): Getline/Pipe. (line 10) +* vertical bar (|), | operator (I/O): Getline/Pipe. (line 9) * vertical bar (|), |& operator (I/O) <1>: Two-way I/O. (line 44) * vertical bar (|), |& operator (I/O) <2>: Precedence. (line 65) * vertical bar (|), |& operator (I/O): Getline/Coprocess. (line 6) @@ -32130,7 +32114,7 @@ Index (line 67) * wc utility: Wc Program. (line 6) * wc.awk program: Wc Program. (line 46) -* Weinberger, Peter <1>: Contributors. (line 12) +* Weinberger, Peter <1>: Contributors. (line 11) * Weinberger, Peter: History. (line 17) * while statement <1>: While Statement. (line 6) * while statement: Regexp Usage. (line 19) @@ -32138,9 +32122,9 @@ Index (line 6) * whitespace, functions, calling: Calling Built-in. (line 10) * whitespace, newlines as: Options. (line 253) -* Williams, Kent: Contributors. (line 35) -* Woehlke, Matthew: Contributors. (line 80) -* Woods, John: Contributors. (line 28) +* Williams, Kent: Contributors. (line 34) +* Woehlke, Matthew: Contributors. (line 79) +* Woods, John: Contributors. (line 27) * word boundaries, matching: GNU Regexp Operators. (line 38) * word, regexp definition of: GNU Regexp Operators. @@ -32156,20 +32140,20 @@ 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 125) +* Yawitz, Efraim: Contributors. (line 124) * Zaretskii, Eli <1>: Bugs. (line 70) -* Zaretskii, Eli <2>: Contributors. (line 56) +* Zaretskii, Eli <2>: Contributors. (line 55) * Zaretskii, Eli: Acknowledgments. (line 60) * zero, negative vs. positive: Unexpected Results. (line 34) * zerofile.awk program: Empty Files. (line 21) -* Zoulas, Christos: Contributors. (line 67) +* Zoulas, Christos: Contributors. (line 66) * {} (braces): Profiling. (line 134) * {} (braces), actions and: Action Overview. (line 19) * {} (braces), statements, grouping: Statements. (line 10) * | (vertical bar): Regexp Operators. (line 69) * | (vertical bar), | operator (I/O) <1>: Precedence. (line 65) * | (vertical bar), | operator (I/O) <2>: Redirection. (line 57) -* | (vertical bar), | operator (I/O): Getline/Pipe. (line 10) +* | (vertical bar), | operator (I/O): Getline/Pipe. (line 9) * | (vertical bar), |& operator (I/O) <1>: Two-way I/O. (line 44) * | (vertical bar), |& operator (I/O) <2>: Precedence. (line 65) * | (vertical bar), |& operator (I/O) <3>: Redirection. (line 102) @@ -32201,511 +32185,511 @@ Ref: Names-Footnote-152037 Node: This Manual52109 Ref: This Manual-Footnote-157883 Node: Conventions57983 -Node: Manual History60135 -Ref: Manual History-Footnote-163583 -Ref: Manual History-Footnote-263624 -Node: How To Contribute63698 -Node: Acknowledgments64842 -Node: Getting Started69051 -Node: Running gawk71430 -Node: One-shot72616 -Node: Read Terminal73841 -Ref: Read Terminal-Footnote-175491 -Ref: Read Terminal-Footnote-275767 -Node: Long75938 -Node: Executable Scripts77314 -Ref: Executable Scripts-Footnote-179147 -Ref: Executable Scripts-Footnote-279249 -Node: Comments79796 -Node: Quoting82263 -Node: DOS Quoting86886 -Node: Sample Data Files87561 -Node: Very Simple90605 -Node: Two Rules95204 -Node: More Complex97351 -Ref: More Complex-Footnote-1100281 -Node: Statements/Lines100366 -Ref: Statements/Lines-Footnote-1104828 -Node: Other Features105093 -Node: When106021 -Node: Invoking Gawk108168 -Node: Command Line109629 -Node: Options110412 -Ref: Options-Footnote-1125804 -Node: Other Arguments125829 -Node: Naming Standard Input128487 -Node: Environment Variables129581 -Node: AWKPATH Variable130139 -Ref: AWKPATH Variable-Footnote-1132897 -Node: AWKLIBPATH Variable133157 -Node: Other Environment Variables133875 -Node: Exit Status136838 -Node: Include Files137513 -Node: Loading Shared Libraries141082 -Node: Obsolete142446 -Node: Undocumented143143 -Node: Regexp143386 -Node: Regexp Usage144775 -Node: Escape Sequences146801 -Node: Regexp Operators152470 -Ref: Regexp Operators-Footnote-1159850 -Ref: Regexp Operators-Footnote-2159997 -Node: Bracket Expressions160095 -Ref: table-char-classes161985 -Node: GNU Regexp Operators164508 -Node: Case-sensitivity168231 -Ref: Case-sensitivity-Footnote-1171199 -Ref: Case-sensitivity-Footnote-2171434 -Node: Leftmost Longest171542 -Node: Computed Regexps172743 -Node: Reading Files176080 -Node: Records178082 -Ref: Records-Footnote-1186971 -Node: Fields187008 -Ref: Fields-Footnote-1190041 -Node: Nonconstant Fields190127 -Node: Changing Fields192329 -Node: Field Separators198288 -Node: Default Field Splitting200917 -Node: Regexp Field Splitting202034 -Node: Single Character Fields205376 -Node: Command Line Field Separator206435 -Node: Field Splitting Summary209876 -Ref: Field Splitting Summary-Footnote-1212987 -Node: Constant Size213088 -Node: Splitting By Content217672 -Ref: Splitting By Content-Footnote-1221398 -Node: Multiple Line221438 -Ref: Multiple Line-Footnote-1227285 -Node: Getline227464 -Node: Plain Getline229680 -Node: Getline/Variable231775 -Node: Getline/File232922 -Node: Getline/Variable/File234263 -Ref: Getline/Variable/File-Footnote-1235862 -Node: Getline/Pipe235949 -Node: Getline/Variable/Pipe238649 -Node: Getline/Coprocess239756 -Node: Getline/Variable/Coprocess241008 -Node: Getline Notes241745 -Node: Getline Summary244532 -Ref: table-getline-variants244940 -Node: Read Timeout245852 -Ref: Read Timeout-Footnote-1249593 -Node: Command line directories249650 -Node: Printing250280 -Node: Print251911 -Node: Print Examples253248 -Node: Output Separators256032 -Node: OFMT257792 -Node: Printf259150 -Node: Basic Printf260056 -Node: Control Letters261595 -Node: Format Modifiers265407 -Node: Printf Examples271416 -Node: Redirection274131 -Node: Special Files281096 -Node: Special FD281629 -Ref: Special FD-Footnote-1285254 -Node: Special Network285328 -Node: Special Caveats286178 -Node: Close Files And Pipes286974 -Ref: Close Files And Pipes-Footnote-1293957 -Ref: Close Files And Pipes-Footnote-2294105 -Node: Expressions294255 -Node: Values295387 -Node: Constants296063 -Node: Scalar Constants296743 -Ref: Scalar Constants-Footnote-1297602 -Node: Nondecimal-numbers297784 -Node: Regexp Constants300784 -Node: Using Constant Regexps301259 -Node: Variables304314 -Node: Using Variables304969 -Node: Assignment Options306693 -Node: Conversion308565 -Ref: table-locale-affects314066 -Ref: Conversion-Footnote-1314690 -Node: All Operators314799 -Node: Arithmetic Ops315429 -Node: Concatenation317934 -Ref: Concatenation-Footnote-1320727 -Node: Assignment Ops320847 -Ref: table-assign-ops325835 -Node: Increment Ops327166 +Node: Manual History60139 +Ref: Manual History-Footnote-163587 +Ref: Manual History-Footnote-263628 +Node: How To Contribute63702 +Node: Acknowledgments64846 +Node: Getting Started69055 +Node: Running gawk71434 +Node: One-shot72620 +Node: Read Terminal73845 +Ref: Read Terminal-Footnote-175495 +Ref: Read Terminal-Footnote-275771 +Node: Long75942 +Node: Executable Scripts77318 +Ref: Executable Scripts-Footnote-179151 +Ref: Executable Scripts-Footnote-279253 +Node: Comments79800 +Node: Quoting82267 +Node: DOS Quoting86890 +Node: Sample Data Files87565 +Node: Very Simple90609 +Node: Two Rules95208 +Node: More Complex97355 +Ref: More Complex-Footnote-1100285 +Node: Statements/Lines100370 +Ref: Statements/Lines-Footnote-1104832 +Node: Other Features105097 +Node: When106025 +Node: Invoking Gawk108172 +Node: Command Line109633 +Node: Options110416 +Ref: Options-Footnote-1125808 +Node: Other Arguments125833 +Node: Naming Standard Input128491 +Node: Environment Variables129585 +Node: AWKPATH Variable130143 +Ref: AWKPATH Variable-Footnote-1132901 +Node: AWKLIBPATH Variable133161 +Node: Other Environment Variables133879 +Node: Exit Status136842 +Node: Include Files137517 +Node: Loading Shared Libraries141086 +Node: Obsolete142450 +Node: Undocumented143147 +Node: Regexp143389 +Node: Regexp Usage144778 +Node: Escape Sequences146804 +Node: Regexp Operators152473 +Ref: Regexp Operators-Footnote-1159853 +Ref: Regexp Operators-Footnote-2160000 +Node: Bracket Expressions160098 +Ref: table-char-classes161988 +Node: GNU Regexp Operators164511 +Node: Case-sensitivity168234 +Ref: Case-sensitivity-Footnote-1171202 +Ref: Case-sensitivity-Footnote-2171437 +Node: Leftmost Longest171545 +Node: Computed Regexps172746 +Node: Reading Files176083 +Node: Records178085 +Ref: Records-Footnote-1186974 +Node: Fields187011 +Ref: Fields-Footnote-1190044 +Node: Nonconstant Fields190130 +Node: Changing Fields192332 +Node: Field Separators198291 +Node: Default Field Splitting200920 +Node: Regexp Field Splitting202037 +Node: Single Character Fields205379 +Node: Command Line Field Separator206438 +Node: Field Splitting Summary209879 +Ref: Field Splitting Summary-Footnote-1212990 +Node: Constant Size213091 +Node: Splitting By Content217675 +Ref: Splitting By Content-Footnote-1221401 +Node: Multiple Line221441 +Ref: Multiple Line-Footnote-1227288 +Node: Getline227467 +Node: Plain Getline229683 +Node: Getline/Variable231778 +Node: Getline/File232925 +Node: Getline/Variable/File234266 +Ref: Getline/Variable/File-Footnote-1235865 +Node: Getline/Pipe235952 +Node: Getline/Variable/Pipe238651 +Node: Getline/Coprocess239758 +Node: Getline/Variable/Coprocess241010 +Node: Getline Notes241747 +Node: Getline Summary244534 +Ref: table-getline-variants244942 +Node: Read Timeout245854 +Ref: Read Timeout-Footnote-1249595 +Node: Command line directories249652 +Node: Printing250282 +Node: Print251913 +Node: Print Examples253250 +Node: Output Separators256034 +Node: OFMT257794 +Node: Printf259152 +Node: Basic Printf260058 +Node: Control Letters261597 +Node: Format Modifiers265409 +Node: Printf Examples271418 +Node: Redirection274133 +Node: Special Files281098 +Node: Special FD281631 +Ref: Special FD-Footnote-1285256 +Node: Special Network285330 +Node: Special Caveats286180 +Node: Close Files And Pipes286976 +Ref: Close Files And Pipes-Footnote-1293959 +Ref: Close Files And Pipes-Footnote-2294107 +Node: Expressions294257 +Node: Values295389 +Node: Constants296065 +Node: Scalar Constants296745 +Ref: Scalar Constants-Footnote-1297604 +Node: Nondecimal-numbers297786 +Node: Regexp Constants300786 +Node: Using Constant Regexps301261 +Node: Variables304316 +Node: Using Variables304971 +Node: Assignment Options306695 +Node: Conversion308567 +Ref: table-locale-affects314068 +Ref: Conversion-Footnote-1314692 +Node: All Operators314801 +Node: Arithmetic Ops315431 +Node: Concatenation317936 +Ref: Concatenation-Footnote-1320728 +Node: Assignment Ops320848 +Ref: table-assign-ops325836 +Node: Increment Ops327167 Node: Truth Values and Conditions330601 Node: Truth Values331684 Node: Typing and Comparison332733 -Node: Variable Typing333522 -Ref: Variable Typing-Footnote-1337419 -Node: Comparison Operators337541 -Ref: table-relational-ops337951 -Node: POSIX String Comparison341500 -Ref: POSIX String Comparison-Footnote-1342456 -Node: Boolean Ops342594 -Ref: Boolean Ops-Footnote-1346672 -Node: Conditional Exp346763 -Node: Function Calls348495 -Node: Precedence352089 -Node: Locales355758 -Node: Patterns and Actions356847 -Node: Pattern Overview357901 -Node: Regexp Patterns359570 -Node: Expression Patterns360113 -Node: Ranges363798 -Node: BEGIN/END366764 -Node: Using BEGIN/END367526 -Ref: Using BEGIN/END-Footnote-1370257 -Node: I/O And BEGIN/END370363 -Node: BEGINFILE/ENDFILE372645 -Node: Empty375559 -Node: Using Shell Variables375875 -Node: Action Overview378160 -Node: Statements380517 -Node: If Statement382371 -Node: While Statement383870 -Node: Do Statement385914 -Node: For Statement387070 -Node: Switch Statement390222 -Node: Break Statement392319 -Node: Continue Statement394309 -Node: Next Statement396102 -Node: Nextfile Statement398492 -Node: Exit Statement401135 -Node: Built-in Variables403551 -Node: User-modified404646 -Ref: User-modified-Footnote-1413004 -Node: Auto-set413066 -Ref: Auto-set-Footnote-1426144 -Ref: Auto-set-Footnote-2426349 -Node: ARGC and ARGV426405 -Node: Arrays430256 -Node: Array Basics431761 -Node: Array Intro432587 -Node: Reference to Elements436905 -Node: Assigning Elements439175 -Node: Array Example439666 -Node: Scanning an Array441398 -Node: Controlling Scanning443712 -Ref: Controlling Scanning-Footnote-1448635 -Node: Delete448951 -Ref: Delete-Footnote-1451716 -Node: Numeric Array Subscripts451773 -Node: Uninitialized Subscripts453956 -Node: Multidimensional455583 -Node: Multiscanning458675 -Node: Arrays of Arrays460264 -Node: Functions464904 -Node: Built-in465723 -Node: Calling Built-in466801 -Node: Numeric Functions468789 -Ref: Numeric Functions-Footnote-1472621 -Ref: Numeric Functions-Footnote-2472978 -Ref: Numeric Functions-Footnote-3473026 -Node: String Functions473295 -Ref: String Functions-Footnote-1496853 -Ref: String Functions-Footnote-2496982 -Ref: String Functions-Footnote-3497230 -Node: Gory Details497317 -Ref: table-sub-escapes498996 -Ref: table-sub-posix-92500350 -Ref: table-sub-proposed501701 -Ref: table-posix-sub503055 -Ref: table-gensub-escapes504600 -Ref: Gory Details-Footnote-1505776 -Ref: Gory Details-Footnote-2505827 -Node: I/O Functions505978 -Ref: I/O Functions-Footnote-1512963 -Node: Time Functions513110 -Ref: Time Functions-Footnote-1524043 -Ref: Time Functions-Footnote-2524111 -Ref: Time Functions-Footnote-3524269 -Ref: Time Functions-Footnote-4524380 -Ref: Time Functions-Footnote-5524492 -Ref: Time Functions-Footnote-6524719 -Node: Bitwise Functions524985 -Ref: table-bitwise-ops525543 -Ref: Bitwise Functions-Footnote-1529764 -Node: Type Functions529948 -Node: I18N Functions531099 -Node: User-defined532726 -Node: Definition Syntax533530 -Ref: Definition Syntax-Footnote-1538440 -Node: Function Example538509 -Node: Function Caveats541103 -Node: Calling A Function541524 -Node: Variable Scope542639 -Node: Pass By Value/Reference545602 -Node: Return Statement549110 -Node: Dynamic Typing552091 -Node: Indirect Calls553022 -Node: Library Functions562707 -Ref: Library Functions-Footnote-1566220 -Ref: Library Functions-Footnote-2566363 -Node: Library Names566534 -Ref: Library Names-Footnote-1570005 -Ref: Library Names-Footnote-2570225 -Node: General Functions570311 -Node: Strtonum Function571339 -Node: Assert Function574269 -Node: Round Function577595 -Node: Cliff Random Function579138 -Node: Ordinal Functions580154 -Ref: Ordinal Functions-Footnote-1583224 -Ref: Ordinal Functions-Footnote-2583476 -Node: Join Function583685 -Ref: Join Function-Footnote-1585456 -Node: Getlocaltime Function585656 -Node: Readfile Function589397 -Node: Data File Management591236 -Node: Filetrans Function591868 -Node: Rewind Function595937 -Node: File Checking597324 -Node: Empty Files598418 -Node: Ignoring Assigns600648 -Node: Getopt Function602201 -Ref: Getopt Function-Footnote-1613504 -Node: Passwd Functions613707 -Ref: Passwd Functions-Footnote-1622682 -Node: Group Functions622770 -Node: Walking Arrays630854 -Node: Sample Programs632991 -Node: Running Examples633665 -Node: Clones634393 -Node: Cut Program635617 -Node: Egrep Program645462 -Ref: Egrep Program-Footnote-1653235 -Node: Id Program653345 -Node: Split Program656961 -Ref: Split Program-Footnote-1660480 -Node: Tee Program660608 -Node: Uniq Program663411 -Node: Wc Program670840 -Ref: Wc Program-Footnote-1675106 -Ref: Wc Program-Footnote-2675306 -Node: Miscellaneous Programs675398 -Node: Dupword Program676586 -Node: Alarm Program678617 -Node: Translate Program683366 -Ref: Translate Program-Footnote-1687753 -Ref: Translate Program-Footnote-2687981 -Node: Labels Program688115 -Ref: Labels Program-Footnote-1691486 -Node: Word Sorting691570 -Node: History Sorting695454 -Node: Extract Program697293 -Ref: Extract Program-Footnote-1704796 -Node: Simple Sed704924 -Node: Igawk Program707986 -Ref: Igawk Program-Footnote-1723143 -Ref: Igawk Program-Footnote-2723344 -Node: Anagram Program723482 -Node: Signature Program726550 -Node: Advanced Features727650 -Node: Nondecimal Data729532 -Node: Array Sorting731115 -Node: Controlling Array Traversal731812 -Node: Array Sorting Functions740050 -Ref: Array Sorting Functions-Footnote-1743724 -Ref: Array Sorting Functions-Footnote-2743817 -Node: Two-way I/O744011 -Ref: Two-way I/O-Footnote-1749443 -Node: TCP/IP Networking749513 -Node: Profiling752357 -Node: Internationalization759854 -Node: I18N and L10N761279 -Node: Explaining gettext761965 -Ref: Explaining gettext-Footnote-1767033 -Ref: Explaining gettext-Footnote-2767217 -Node: Programmer i18n767382 -Node: Translator i18n771584 -Node: String Extraction772377 -Ref: String Extraction-Footnote-1773338 -Node: Printf Ordering773424 -Ref: Printf Ordering-Footnote-1776208 -Node: I18N Portability776272 -Ref: I18N Portability-Footnote-1778721 -Node: I18N Example778784 -Ref: I18N Example-Footnote-1781422 -Node: Gawk I18N781494 -Node: Debugger782115 -Node: Debugging783086 -Node: Debugging Concepts783519 -Node: Debugging Terms785375 -Node: Awk Debugging787972 -Node: Sample Debugging Session788864 -Node: Debugger Invocation789384 -Node: Finding The Bug790716 -Node: List of Debugger Commands797204 -Node: Breakpoint Control798538 -Node: Debugger Execution Control802202 -Node: Viewing And Changing Data805562 -Node: Execution Stack808918 -Node: Debugger Info810385 -Node: Miscellaneous Debugger Commands814367 -Node: Readline Support819543 -Node: Limitations820374 -Node: Arbitrary Precision Arithmetic822626 -Ref: Arbitrary Precision Arithmetic-Footnote-1824277 -Node: General Arithmetic824425 -Node: Floating Point Issues826145 -Node: String Conversion Precision827026 -Ref: String Conversion Precision-Footnote-1828731 -Node: Unexpected Results828840 -Node: POSIX Floating Point Problems830993 -Ref: POSIX Floating Point Problems-Footnote-1834818 -Node: Integer Programming834856 -Node: Floating-point Programming836595 -Ref: Floating-point Programming-Footnote-1842926 -Ref: Floating-point Programming-Footnote-2843196 -Node: Floating-point Representation843460 -Node: Floating-point Context844625 -Ref: table-ieee-formats845464 -Node: Rounding Mode846848 -Ref: table-rounding-modes847327 -Ref: Rounding Mode-Footnote-1850342 -Node: Gawk and MPFR850521 -Node: Arbitrary Precision Floats851776 -Ref: Arbitrary Precision Floats-Footnote-1854219 -Node: Setting Precision854535 -Ref: table-predefined-precision-strings855221 -Node: Setting Rounding Mode857366 -Ref: table-gawk-rounding-modes857770 -Node: Floating-point Constants858957 -Node: Changing Precision860386 -Ref: Changing Precision-Footnote-1861786 -Node: Exact Arithmetic861960 -Node: Arbitrary Precision Integers865098 -Ref: Arbitrary Precision Integers-Footnote-1868116 -Node: Dynamic Extensions868263 -Node: Extension Intro869721 -Node: Plugin License870986 -Node: Extension Mechanism Outline871671 -Ref: load-extension872088 -Ref: load-new-function873566 -Ref: call-new-function874561 -Node: Extension API Description876576 -Node: Extension API Functions Introduction877789 -Node: General Data Types882655 -Ref: General Data Types-Footnote-1888257 -Node: Requesting Values888556 -Ref: table-value-types-returned889287 -Node: Constructor Functions890241 -Node: Registration Functions893261 -Node: Extension Functions893946 -Node: Exit Callback Functions896171 -Node: Extension Version String897420 -Node: Input Parsers898070 -Node: Output Wrappers907827 -Node: Two-way processors912337 -Node: Printing Messages914545 -Ref: Printing Messages-Footnote-1915622 -Node: Updating `ERRNO'915774 -Node: Accessing Parameters916513 -Node: Symbol Table Access917743 -Node: Symbol table by name918255 -Node: Symbol table by cookie920002 -Ref: Symbol table by cookie-Footnote-1924132 -Node: Cached values924195 -Ref: Cached values-Footnote-1927644 -Node: Array Manipulation927735 -Ref: Array Manipulation-Footnote-1928833 -Node: Array Data Types928872 -Ref: Array Data Types-Footnote-1931575 -Node: Array Functions931667 -Node: Flattening Arrays935433 -Node: Creating Arrays942285 -Node: Extension API Variables947010 -Node: Extension Versioning947646 -Node: Extension API Informational Variables949547 -Node: Extension API Boilerplate950633 -Node: Finding Extensions954437 -Node: Extension Example954997 -Node: Internal File Description955728 -Node: Internal File Ops959819 -Ref: Internal File Ops-Footnote-1971327 -Node: Using Internal File Ops971467 -Ref: Using Internal File Ops-Footnote-1973820 -Node: Extension Samples974086 -Node: Extension Sample File Functions975610 -Node: Extension Sample Fnmatch984095 -Node: Extension Sample Fork985821 -Node: Extension Sample Inplace987039 -Node: Extension Sample Ord988817 -Node: Extension Sample Readdir989653 -Node: Extension Sample Revout991185 -Node: Extension Sample Rev2way991778 -Node: Extension Sample Read write array992468 -Node: Extension Sample Readfile994351 -Node: Extension Sample API Tests995169 -Node: Extension Sample Time995694 -Node: gawkextlib997058 -Node: Language History999818 -Node: V7/SVR3.11001340 -Node: SVR41003660 -Node: POSIX1005102 -Node: BTL1006488 -Node: POSIX/GNU1007222 -Node: Common Extensions1012757 -Node: Ranges and Locales1014063 -Ref: Ranges and Locales-Footnote-11018681 -Ref: Ranges and Locales-Footnote-21018708 -Ref: Ranges and Locales-Footnote-31018968 -Node: Contributors1019189 -Node: Installation1024265 -Node: Gawk Distribution1025159 -Node: Getting1025643 -Node: Extracting1026469 -Node: Distribution contents1028161 -Node: Unix Installation1033681 -Node: Quick Installation1034298 -Node: Additional Configuration Options1036742 -Node: Configuration Philosophy1038219 -Node: Non-Unix Installation1040573 -Node: PC Installation1041031 -Node: PC Binary Installation1042330 -Node: PC Compiling1044178 -Node: PC Testing1047122 -Node: PC Using1048298 -Node: Cygwin1052483 -Node: MSYS1053483 -Node: VMS Installation1053997 -Node: VMS Compilation1054600 -Ref: VMS Compilation-Footnote-11055607 -Node: VMS Installation Details1055665 -Node: VMS Running1057300 -Node: VMS Old Gawk1058907 -Node: Bugs1059381 -Node: Other Versions1063233 -Node: Notes1069314 -Node: Compatibility Mode1070114 -Node: Additions1070897 -Node: Accessing The Source1071824 -Node: Adding Code1073264 -Node: New Ports1079309 -Node: Derived Files1083444 -Ref: Derived Files-Footnote-11088765 -Ref: Derived Files-Footnote-21088799 -Ref: Derived Files-Footnote-31089399 -Node: Future Extensions1089497 -Node: Implementation Limitations1090078 -Node: Extension Design1091330 -Node: Old Extension Problems1092484 -Ref: Old Extension Problems-Footnote-11093992 -Node: Extension New Mechanism Goals1094049 -Ref: Extension New Mechanism Goals-Footnote-11097414 -Node: Extension Other Design Decisions1097600 -Node: Extension Future Growth1099706 -Node: Old Extension Mechanism1100542 -Node: Basic Concepts1102282 -Node: Basic High Level1102963 -Ref: figure-general-flow1103234 -Ref: figure-process-flow1103833 -Ref: Basic High Level-Footnote-11107062 -Node: Basic Data Typing1107247 -Node: Glossary1110602 -Node: Copying1136064 -Node: GNU Free Documentation License1173621 -Node: Index1198758 +Node: Variable Typing333526 +Ref: Variable Typing-Footnote-1337423 +Node: Comparison Operators337545 +Ref: table-relational-ops337955 +Node: POSIX String Comparison341504 +Ref: POSIX String Comparison-Footnote-1342460 +Node: Boolean Ops342598 +Ref: Boolean Ops-Footnote-1346676 +Node: Conditional Exp346767 +Node: Function Calls348499 +Node: Precedence352093 +Node: Locales355762 +Node: Patterns and Actions356851 +Node: Pattern Overview357905 +Node: Regexp Patterns359574 +Node: Expression Patterns360117 +Node: Ranges363802 +Node: BEGIN/END366768 +Node: Using BEGIN/END367530 +Ref: Using BEGIN/END-Footnote-1370261 +Node: I/O And BEGIN/END370367 +Node: BEGINFILE/ENDFILE372649 +Node: Empty375563 +Node: Using Shell Variables375879 +Node: Action Overview378164 +Node: Statements380521 +Node: If Statement382375 +Node: While Statement383874 +Node: Do Statement385918 +Node: For Statement387074 +Node: Switch Statement390226 +Node: Break Statement392323 +Node: Continue Statement394313 +Node: Next Statement396106 +Node: Nextfile Statement398496 +Node: Exit Statement401139 +Node: Built-in Variables403555 +Node: User-modified404650 +Ref: User-modified-Footnote-1413008 +Node: Auto-set413070 +Ref: Auto-set-Footnote-1426148 +Ref: Auto-set-Footnote-2426353 +Node: ARGC and ARGV426409 +Node: Arrays430260 +Node: Array Basics431765 +Node: Array Intro432591 +Node: Reference to Elements436908 +Node: Assigning Elements439178 +Node: Array Example439669 +Node: Scanning an Array441401 +Node: Controlling Scanning443715 +Ref: Controlling Scanning-Footnote-1448638 +Node: Delete448954 +Ref: Delete-Footnote-1451719 +Node: Numeric Array Subscripts451776 +Node: Uninitialized Subscripts453959 +Node: Multidimensional455586 +Node: Multiscanning458678 +Node: Arrays of Arrays460267 +Node: Functions464907 +Node: Built-in465726 +Node: Calling Built-in466804 +Node: Numeric Functions468792 +Ref: Numeric Functions-Footnote-1472624 +Ref: Numeric Functions-Footnote-2472981 +Ref: Numeric Functions-Footnote-3473029 +Node: String Functions473298 +Ref: String Functions-Footnote-1496856 +Ref: String Functions-Footnote-2496985 +Ref: String Functions-Footnote-3497233 +Node: Gory Details497320 +Ref: table-sub-escapes498999 +Ref: table-sub-posix-92500353 +Ref: table-sub-proposed501704 +Ref: table-posix-sub503058 +Ref: table-gensub-escapes504603 +Ref: Gory Details-Footnote-1505779 +Ref: Gory Details-Footnote-2505830 +Node: I/O Functions505981 +Ref: I/O Functions-Footnote-1512966 +Node: Time Functions513113 +Ref: Time Functions-Footnote-1524046 +Ref: Time Functions-Footnote-2524114 +Ref: Time Functions-Footnote-3524272 +Ref: Time Functions-Footnote-4524383 +Ref: Time Functions-Footnote-5524495 +Ref: Time Functions-Footnote-6524722 +Node: Bitwise Functions524988 +Ref: table-bitwise-ops525550 +Ref: Bitwise Functions-Footnote-1529771 +Node: Type Functions529955 +Node: I18N Functions531106 +Node: User-defined532733 +Node: Definition Syntax533537 +Ref: Definition Syntax-Footnote-1538447 +Node: Function Example538516 +Node: Function Caveats541110 +Node: Calling A Function541531 +Node: Variable Scope542646 +Node: Pass By Value/Reference545609 +Node: Return Statement549117 +Node: Dynamic Typing552098 +Node: Indirect Calls553029 +Node: Library Functions562714 +Ref: Library Functions-Footnote-1566227 +Ref: Library Functions-Footnote-2566370 +Node: Library Names566541 +Ref: Library Names-Footnote-1570012 +Ref: Library Names-Footnote-2570232 +Node: General Functions570318 +Node: Strtonum Function571346 +Node: Assert Function574276 +Node: Round Function577602 +Node: Cliff Random Function579145 +Node: Ordinal Functions580161 +Ref: Ordinal Functions-Footnote-1583231 +Ref: Ordinal Functions-Footnote-2583483 +Node: Join Function583692 +Ref: Join Function-Footnote-1585463 +Node: Getlocaltime Function585663 +Node: Readfile Function589404 +Node: Data File Management591243 +Node: Filetrans Function591875 +Node: Rewind Function595944 +Node: File Checking597331 +Node: Empty Files598425 +Node: Ignoring Assigns600655 +Node: Getopt Function602208 +Ref: Getopt Function-Footnote-1613511 +Node: Passwd Functions613714 +Ref: Passwd Functions-Footnote-1622689 +Node: Group Functions622777 +Node: Walking Arrays630861 +Node: Sample Programs632998 +Node: Running Examples633672 +Node: Clones634400 +Node: Cut Program635624 +Node: Egrep Program645469 +Ref: Egrep Program-Footnote-1653242 +Node: Id Program653352 +Node: Split Program656968 +Ref: Split Program-Footnote-1660487 +Node: Tee Program660615 +Node: Uniq Program663418 +Node: Wc Program670847 +Ref: Wc Program-Footnote-1675113 +Ref: Wc Program-Footnote-2675313 +Node: Miscellaneous Programs675405 +Node: Dupword Program676593 +Node: Alarm Program678624 +Node: Translate Program683377 +Ref: Translate Program-Footnote-1687764 +Ref: Translate Program-Footnote-2688012 +Node: Labels Program688146 +Ref: Labels Program-Footnote-1691517 +Node: Word Sorting691601 +Node: History Sorting695485 +Node: Extract Program697324 +Ref: Extract Program-Footnote-1704827 +Node: Simple Sed704955 +Node: Igawk Program708017 +Ref: Igawk Program-Footnote-1723174 +Ref: Igawk Program-Footnote-2723375 +Node: Anagram Program723513 +Node: Signature Program726581 +Node: Advanced Features727681 +Node: Nondecimal Data729567 +Node: Array Sorting731150 +Node: Controlling Array Traversal731847 +Node: Array Sorting Functions740085 +Ref: Array Sorting Functions-Footnote-1743759 +Ref: Array Sorting Functions-Footnote-2743852 +Node: Two-way I/O744046 +Ref: Two-way I/O-Footnote-1749478 +Node: TCP/IP Networking749548 +Node: Profiling752392 +Node: Internationalization759889 +Node: I18N and L10N761314 +Node: Explaining gettext762000 +Ref: Explaining gettext-Footnote-1767068 +Ref: Explaining gettext-Footnote-2767252 +Node: Programmer i18n767417 +Node: Translator i18n771619 +Node: String Extraction772412 +Ref: String Extraction-Footnote-1773373 +Node: Printf Ordering773459 +Ref: Printf Ordering-Footnote-1776243 +Node: I18N Portability776307 +Ref: I18N Portability-Footnote-1778756 +Node: I18N Example778819 +Ref: I18N Example-Footnote-1781457 +Node: Gawk I18N781529 +Node: Debugger782150 +Node: Debugging783121 +Node: Debugging Concepts783554 +Node: Debugging Terms785410 +Node: Awk Debugging788007 +Node: Sample Debugging Session788899 +Node: Debugger Invocation789419 +Node: Finding The Bug790751 +Node: List of Debugger Commands797239 +Node: Breakpoint Control798573 +Node: Debugger Execution Control802237 +Node: Viewing And Changing Data805597 +Node: Execution Stack808953 +Node: Debugger Info810420 +Node: Miscellaneous Debugger Commands814402 +Node: Readline Support819578 +Node: Limitations820409 +Node: Arbitrary Precision Arithmetic822661 +Ref: Arbitrary Precision Arithmetic-Footnote-1824310 +Node: General Arithmetic824458 +Node: Floating Point Issues826178 +Node: String Conversion Precision827059 +Ref: String Conversion Precision-Footnote-1828764 +Node: Unexpected Results828873 +Node: POSIX Floating Point Problems831026 +Ref: POSIX Floating Point Problems-Footnote-1834851 +Node: Integer Programming834889 +Node: Floating-point Programming836628 +Ref: Floating-point Programming-Footnote-1842959 +Ref: Floating-point Programming-Footnote-2843229 +Node: Floating-point Representation843493 +Node: Floating-point Context844658 +Ref: table-ieee-formats845497 +Node: Rounding Mode846881 +Ref: table-rounding-modes847360 +Ref: Rounding Mode-Footnote-1850375 +Node: Gawk and MPFR850554 +Node: Arbitrary Precision Floats851809 +Ref: Arbitrary Precision Floats-Footnote-1854252 +Node: Setting Precision854568 +Ref: table-predefined-precision-strings855254 +Node: Setting Rounding Mode857399 +Ref: table-gawk-rounding-modes857803 +Node: Floating-point Constants858990 +Node: Changing Precision860419 +Ref: Changing Precision-Footnote-1861816 +Node: Exact Arithmetic861990 +Node: Arbitrary Precision Integers865128 +Ref: Arbitrary Precision Integers-Footnote-1868146 +Node: Dynamic Extensions868293 +Node: Extension Intro869751 +Node: Plugin License871016 +Node: Extension Mechanism Outline871701 +Ref: load-extension872118 +Ref: load-new-function873596 +Ref: call-new-function874591 +Node: Extension API Description876606 +Node: Extension API Functions Introduction877819 +Node: General Data Types882685 +Ref: General Data Types-Footnote-1888284 +Node: Requesting Values888583 +Ref: table-value-types-returned889314 +Node: Constructor Functions890268 +Node: Registration Functions893288 +Node: Extension Functions893973 +Node: Exit Callback Functions896198 +Node: Extension Version String897447 +Node: Input Parsers898097 +Node: Output Wrappers907854 +Node: Two-way processors912364 +Node: Printing Messages914572 +Ref: Printing Messages-Footnote-1915649 +Node: Updating `ERRNO'915801 +Node: Accessing Parameters916540 +Node: Symbol Table Access917770 +Node: Symbol table by name918282 +Node: Symbol table by cookie920029 +Ref: Symbol table by cookie-Footnote-1924159 +Node: Cached values924222 +Ref: Cached values-Footnote-1927671 +Node: Array Manipulation927762 +Ref: Array Manipulation-Footnote-1928860 +Node: Array Data Types928899 +Ref: Array Data Types-Footnote-1931602 +Node: Array Functions931694 +Node: Flattening Arrays935460 +Node: Creating Arrays942312 +Node: Extension API Variables947037 +Node: Extension Versioning947673 +Node: Extension API Informational Variables949574 +Node: Extension API Boilerplate950660 +Node: Finding Extensions954464 +Node: Extension Example955024 +Node: Internal File Description955754 +Node: Internal File Ops959845 +Ref: Internal File Ops-Footnote-1971353 +Node: Using Internal File Ops971493 +Ref: Using Internal File Ops-Footnote-1973846 +Node: Extension Samples974112 +Node: Extension Sample File Functions975636 +Node: Extension Sample Fnmatch984121 +Node: Extension Sample Fork985847 +Node: Extension Sample Inplace987065 +Node: Extension Sample Ord988843 +Node: Extension Sample Readdir989679 +Node: Extension Sample Revout991211 +Node: Extension Sample Rev2way991804 +Node: Extension Sample Read write array992494 +Node: Extension Sample Readfile994377 +Node: Extension Sample API Tests995195 +Node: Extension Sample Time995720 +Node: gawkextlib997084 +Node: Language History999844 +Node: V7/SVR3.11001366 +Node: SVR41003686 +Node: POSIX1005128 +Node: BTL1006514 +Node: POSIX/GNU1007248 +Node: Common Extensions1012783 +Node: Ranges and Locales1014089 +Ref: Ranges and Locales-Footnote-11018707 +Ref: Ranges and Locales-Footnote-21018734 +Ref: Ranges and Locales-Footnote-31018994 +Node: Contributors1019215 +Node: Installation1024290 +Node: Gawk Distribution1025184 +Node: Getting1025668 +Node: Extracting1026494 +Node: Distribution contents1028186 +Node: Unix Installation1033706 +Node: Quick Installation1034323 +Node: Additional Configuration Options1036767 +Node: Configuration Philosophy1038244 +Node: Non-Unix Installation1040598 +Node: PC Installation1041056 +Node: PC Binary Installation1042355 +Node: PC Compiling1044203 +Node: PC Testing1047147 +Node: PC Using1048323 +Node: Cygwin1052508 +Node: MSYS1053508 +Node: VMS Installation1054022 +Node: VMS Compilation1054625 +Ref: VMS Compilation-Footnote-11055632 +Node: VMS Installation Details1055690 +Node: VMS Running1057325 +Node: VMS Old Gawk1058932 +Node: Bugs1059406 +Node: Other Versions1063262 +Node: Notes1069346 +Node: Compatibility Mode1070146 +Node: Additions1070929 +Node: Accessing The Source1071856 +Node: Adding Code1073296 +Node: New Ports1079341 +Node: Derived Files1083476 +Ref: Derived Files-Footnote-11088797 +Ref: Derived Files-Footnote-21088831 +Ref: Derived Files-Footnote-31089431 +Node: Future Extensions1089529 +Node: Implementation Limitations1090106 +Node: Extension Design1091358 +Node: Old Extension Problems1092512 +Ref: Old Extension Problems-Footnote-11094020 +Node: Extension New Mechanism Goals1094077 +Ref: Extension New Mechanism Goals-Footnote-11097442 +Node: Extension Other Design Decisions1097628 +Node: Extension Future Growth1099734 +Node: Old Extension Mechanism1100570 +Node: Basic Concepts1102310 +Node: Basic High Level1102991 +Ref: figure-general-flow1103262 +Ref: figure-process-flow1103861 +Ref: Basic High Level-Footnote-11107090 +Node: Basic Data Typing1107275 +Node: Glossary1110630 +Node: Copying1136092 +Node: GNU Free Documentation License1173649 +Node: Index1198786 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 3b48e2bb..10486cea 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -1457,8 +1457,8 @@ pressing the @kbd{d} key and finally releasing both keys. @cindex Kernighan, Brian @quotation @i{Dark corners are basically fractal --- no matter how much -you illuminate, there's always a smaller but darker one.}@* -Brian Kernighan +you illuminate, there's always a smaller but darker one.} +@author Brian Kernighan @end quotation @cindex d.c., See dark corner @@ -4216,8 +4216,8 @@ in case some option becomes obsolete in a future version of @command{gawk}. @cindex Jedi knights @cindex Knights, jedi @quotation -@i{Use the Source, Luke!}@* -Obi-Wan +@i{Use the Source, Luke!} +@author Obi-Wan @end quotation This @value{SECTION} intentionally left @@ -7583,8 +7583,8 @@ that does handle nested @samp{@@include} statements. @c From private email, dated October 2, 1988. Used by permission, March 2013. @quotation @i{Omniscience has much to recommend it. -Failing that, attention to details would be useful.}@* -Brian Kernighan +Failing that, attention to details would be useful.} +@author Brian Kernighan @end quotation @cindex @code{|} (vertical bar), @code{|} operator (I/O) @@ -10286,8 +10286,8 @@ For maximum portability, do not use the @samp{**} operator. @subsection String Concatenation @cindex Kernighan, Brian @quotation -@i{It seemed like a good idea at the time.}@* -Brian Kernighan +@i{It seemed like a good idea at the time.} +@author Brian Kernighan @end quotation @cindex string operators @@ -10817,8 +10817,8 @@ like @samp{@var{lvalue}++}, but instead of adding, it subtracts.) @cindex Marx, Groucho @quotation @i{Doctor, doctor! It hurts when I do this!@* -So don't do that!}@* -Groucho Marx +So don't do that!} +@author Groucho Marx @end quotation @noindent @@ -10869,8 +10869,8 @@ You should avoid such things in your own programs. @cindex Marx, Groucho @quotation @i{Doctor, doctor! It hurts when I do this!@* -So don't do that!}@* -Groucho Marx +So don't do that!} +@author Groucho Marx @end quotation @noindent @@ -10968,8 +10968,8 @@ the string constant @code{"0"} is actually true, because it is non-null. @node Typing and Comparison @subsection Variable Typing and Comparison Expressions @quotation -@i{The Guide is definitive. Reality is frequently inaccurate.}@* -The Hitchhiker's Guide to the Galaxy +@i{The Guide is definitive. Reality is frequently inaccurate.} +@author The Hitchhiker's Guide to the Galaxy @end quotation @c STARTOFRANGE comex @@ -14263,8 +14263,8 @@ an array. @cindex Wall, Larry @quotation @i{Doing linear scans over an associative array is like trying to club someone -to death with a loaded Uzi.}@* -Larry Wall +to death with a loaded Uzi.} +@author Larry Wall @end quotation The @command{awk} language provides one-dimensional arrays @@ -17447,8 +17447,8 @@ gawk 'BEGIN @{ @c STARTOFRANGE opbit @cindex operations, bitwise @quotation -@i{I can explain it for you, but I can't understand it for you.}@* -Anonymous +@i{I can explain it for you, but I can't understand it for you.} +@author Anonymous @end quotation Many languages provide the ability to perform @dfn{bitwise} operations @@ -18887,9 +18887,9 @@ it allows you to encapsulate algorithms and program tasks in a single place. It simplifies programming, making program development more manageable, and making programs more readable. -In their seminal 1976 book, @cite{Software Tools}@footnote{Sadly, over 35 +In their seminal 1976 book, @cite{Software Tools},@footnote{Sadly, over 35 years later, many of the lessons taught by this book have yet to be -learned by a vast number of practicing programmers.}, Brian Kernighan +learned by a vast number of practicing programmers.} Brian Kernighan and P.J.@: Plauger wrote: @quotation @@ -23105,8 +23105,8 @@ word, comparing it to the previous one: @cindex insomnia, cure for @cindex Robbins, Arnold @quotation -@i{Nothing cures insomnia like a ringing alarm clock.}@* -Arnold Robbins +@i{Nothing cures insomnia like a ringing alarm clock.} +@author Arnold Robbins @end quotation @c STARTOFRANGE tialarm @@ -23282,9 +23282,7 @@ often used to map uppercase letters into lowercase for further processing: @command{tr} requires two lists of characters.@footnote{On some older systems, -@ifset ORA including Solaris, -@end ifset @command{tr} may require that the lists be written as range expressions enclosed in square brackets (@samp{[a-z]}) and quoted, to prevent the shell from attempting a file name expansion. This is @@ -24925,8 +24923,8 @@ who knows where you live." @end ignore @quotation @i{Write documentation as if whoever reads it is -a violent psychopath who knows where you live.}@* -Steve English, as quoted by Peter Langston +a violent psychopath who knows where you live.} +@author Steve English, as quoted by Peter Langston @end quotation This @value{CHAPTER} discusses advanced features in @command{gawk}. @@ -28073,11 +28071,11 @@ to believe. Novice computer users solve this problem by implicitly trusting in the computer as an infallible authority; they tend to believe that all digits of a printed answer are significant. Disillusioned computer users have just the opposite approach; they are constantly afraid that their answers -are almost meaningless.}@* -Donald Knuth@footnote{Donald E.@: Knuth. +are almost meaningless.}@footnote{Donald E.@: Knuth. @cite{The Art of Computer Programming}. Volume 2, @cite{Seminumerical Algorithms}, third edition, 1998, ISBN 0-201-89683-4, p.@: 229.} +@author Donald Knuth @end quotation This @value{CHAPTER} discusses issues that you may encounter @@ -29084,11 +29082,10 @@ floating-point format to a precision lower than working precision. Do we promote them to full membership of the high-precision club, or do we treat them and all their associates as second-class citizens? Sometimes the first course is proper, sometimes the second, and it takes -careful analysis to tell which.} - -Dirk Laurie@footnote{Dirk Laurie. +careful analysis to tell which.}@footnote{Dirk Laurie. @cite{Variable-precision Arithmetic Considered Perilous --- A Detective Story}. Electronic Transactions on Numerical Analysis. Volume 28, pp. 168-173, 2008.} +@author Dirk Laurie @end quotation @command{gawk} does not implicitly modify the precision of any previously @@ -29626,12 +29623,12 @@ the macros as if they were functions. @subsection General Purpose Data Types @quotation -@i{I have a true love/hate relationship with unions.}@* -Arnold Robbins +@i{I have a true love/hate relationship with unions.} +@author Arnold Robbins @i{That's the thing about unions: the compiler will arrange things so they -can accommodate both love and hate.}@* -Chet Ramey +can accommodate both love and hate.} +@author Chet Ramey @end quotation The extension API defines a number of simple types and structures for general @@ -31564,8 +31561,8 @@ path with a list of directories to search for compiled extensions. @section Example: Some File Functions @quotation -@i{No matter where you go, there you are.} @* -Buckaroo Bonzai +@i{No matter where you go, there you are.} +@author Buckaroo Bonzai @end quotation @c It's enough to show chdir and stat, no need for fts @@ -33721,8 +33718,8 @@ cases: the default regexp matching; with @option{--traditional}, and with @appendixsec Major Contributors to @command{gawk} @cindex @command{gawk}, list of contributors to @quotation -@i{Always give credit where credit is due.}@* -Anonymous +@i{Always give credit where credit is due.} +@author Anonymous @end quotation This @value{SECTION} names the major contributors to @command{gawk} @@ -35026,8 +35023,8 @@ recommend compiling and using the current version. @appendixsec Reporting Problems and Bugs @cindex archeologists @quotation -@i{There is nothing more dangerous than a bored archeologist.}@* -The Hitchhiker's Guide to the Galaxy +@i{There is nothing more dangerous than a bored archeologist.} +@author The Hitchhiker's Guide to the Galaxy @end quotation @c the radio show, not the book. :-) @@ -35143,8 +35140,8 @@ Date: Wed, 4 Sep 1996 08:11:48 -0700 (PDT) @cindex Brennan, Michael @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}@* -Michael Brennan +@ @ @ @ @ @ @code{// Do C++ comments work? answer: yes! of course} +@author Michael Brennan @end quotation There are a number of other freely available @command{awk} implementations. @@ -35938,11 +35935,11 @@ Larry @cindex Wall, Larry @cindex Robbins, Arnold @quotation -@i{AWK is a language similar to PERL, only considerably more elegant.}@* -Arnold Robbins +@i{AWK is a language similar to PERL, only considerably more elegant.} +@author Arnold Robbins -@i{Hey!}@* -Larry Wall +@i{Hey!} +@author Larry Wall @end quotation The @file{TODO} file in the @command{gawk} Git repository lists possible diff --git a/doc/gawktexi.in b/doc/gawktexi.in index bcffebf0..771ef1c4 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -1424,8 +1424,8 @@ pressing the @kbd{d} key and finally releasing both keys. @cindex Kernighan, Brian @quotation @i{Dark corners are basically fractal --- no matter how much -you illuminate, there's always a smaller but darker one.}@* -Brian Kernighan +you illuminate, there's always a smaller but darker one.} +@author Brian Kernighan @end quotation @cindex d.c., See dark corner @@ -4144,8 +4144,8 @@ in case some option becomes obsolete in a future version of @command{gawk}. @cindex Jedi knights @cindex Knights, jedi @quotation -@i{Use the Source, Luke!}@* -Obi-Wan +@i{Use the Source, Luke!} +@author Obi-Wan @end quotation This @value{SECTION} intentionally left @@ -7209,8 +7209,8 @@ that does handle nested @samp{@@include} statements. @c From private email, dated October 2, 1988. Used by permission, March 2013. @quotation @i{Omniscience has much to recommend it. -Failing that, attention to details would be useful.}@* -Brian Kernighan +Failing that, attention to details would be useful.} +@author Brian Kernighan @end quotation @cindex @code{|} (vertical bar), @code{|} operator (I/O) @@ -9783,8 +9783,8 @@ For maximum portability, do not use the @samp{**} operator. @subsection String Concatenation @cindex Kernighan, Brian @quotation -@i{It seemed like a good idea at the time.}@* -Brian Kernighan +@i{It seemed like a good idea at the time.} +@author Brian Kernighan @end quotation @cindex string operators @@ -10255,8 +10255,8 @@ like @samp{@var{lvalue}++}, but instead of adding, it subtracts.) @cindex Marx, Groucho @quotation @i{Doctor, doctor! It hurts when I do this!@* -So don't do that!}@* -Groucho Marx +So don't do that!} +@author Groucho Marx @end quotation @noindent @@ -10353,8 +10353,8 @@ the string constant @code{"0"} is actually true, because it is non-null. @node Typing and Comparison @subsection Variable Typing and Comparison Expressions @quotation -@i{The Guide is definitive. Reality is frequently inaccurate.}@* -The Hitchhiker's Guide to the Galaxy +@i{The Guide is definitive. Reality is frequently inaccurate.} +@author The Hitchhiker's Guide to the Galaxy @end quotation @c STARTOFRANGE comex @@ -13602,8 +13602,8 @@ an array. @cindex Wall, Larry @quotation @i{Doing linear scans over an associative array is like trying to club someone -to death with a loaded Uzi.}@* -Larry Wall +to death with a loaded Uzi.} +@author Larry Wall @end quotation The @command{awk} language provides one-dimensional arrays @@ -16625,8 +16625,8 @@ gawk 'BEGIN @{ @c STARTOFRANGE opbit @cindex operations, bitwise @quotation -@i{I can explain it for you, but I can't understand it for you.}@* -Anonymous +@i{I can explain it for you, but I can't understand it for you.} +@author Anonymous @end quotation Many languages provide the ability to perform @dfn{bitwise} operations @@ -18065,9 +18065,9 @@ it allows you to encapsulate algorithms and program tasks in a single place. It simplifies programming, making program development more manageable, and making programs more readable. -In their seminal 1976 book, @cite{Software Tools}@footnote{Sadly, over 35 +In their seminal 1976 book, @cite{Software Tools},@footnote{Sadly, over 35 years later, many of the lessons taught by this book have yet to be -learned by a vast number of practicing programmers.}, Brian Kernighan +learned by a vast number of practicing programmers.} Brian Kernighan and P.J.@: Plauger wrote: @quotation @@ -22254,8 +22254,8 @@ word, comparing it to the previous one: @cindex insomnia, cure for @cindex Robbins, Arnold @quotation -@i{Nothing cures insomnia like a ringing alarm clock.}@* -Arnold Robbins +@i{Nothing cures insomnia like a ringing alarm clock.} +@author Arnold Robbins @end quotation @c STARTOFRANGE tialarm @@ -22431,9 +22431,7 @@ often used to map uppercase letters into lowercase for further processing: @command{tr} requires two lists of characters.@footnote{On some older systems, -@ifset ORA including Solaris, -@end ifset @command{tr} may require that the lists be written as range expressions enclosed in square brackets (@samp{[a-z]}) and quoted, to prevent the shell from attempting a file name expansion. This is @@ -24074,8 +24072,8 @@ who knows where you live." @end ignore @quotation @i{Write documentation as if whoever reads it is -a violent psychopath who knows where you live.}@* -Steve English, as quoted by Peter Langston +a violent psychopath who knows where you live.} +@author Steve English, as quoted by Peter Langston @end quotation This @value{CHAPTER} discusses advanced features in @command{gawk}. @@ -27222,11 +27220,11 @@ to believe. Novice computer users solve this problem by implicitly trusting in the computer as an infallible authority; they tend to believe that all digits of a printed answer are significant. Disillusioned computer users have just the opposite approach; they are constantly afraid that their answers -are almost meaningless.}@* -Donald Knuth@footnote{Donald E.@: Knuth. +are almost meaningless.}@footnote{Donald E.@: Knuth. @cite{The Art of Computer Programming}. Volume 2, @cite{Seminumerical Algorithms}, third edition, 1998, ISBN 0-201-89683-4, p.@: 229.} +@author Donald Knuth @end quotation This @value{CHAPTER} discusses issues that you may encounter @@ -28233,11 +28231,10 @@ floating-point format to a precision lower than working precision. Do we promote them to full membership of the high-precision club, or do we treat them and all their associates as second-class citizens? Sometimes the first course is proper, sometimes the second, and it takes -careful analysis to tell which.} - -Dirk Laurie@footnote{Dirk Laurie. +careful analysis to tell which.}@footnote{Dirk Laurie. @cite{Variable-precision Arithmetic Considered Perilous --- A Detective Story}. Electronic Transactions on Numerical Analysis. Volume 28, pp. 168-173, 2008.} +@author Dirk Laurie @end quotation @command{gawk} does not implicitly modify the precision of any previously @@ -28775,12 +28772,12 @@ the macros as if they were functions. @subsection General Purpose Data Types @quotation -@i{I have a true love/hate relationship with unions.}@* -Arnold Robbins +@i{I have a true love/hate relationship with unions.} +@author Arnold Robbins @i{That's the thing about unions: the compiler will arrange things so they -can accommodate both love and hate.}@* -Chet Ramey +can accommodate both love and hate.} +@author Chet Ramey @end quotation The extension API defines a number of simple types and structures for general @@ -30713,8 +30710,8 @@ path with a list of directories to search for compiled extensions. @section Example: Some File Functions @quotation -@i{No matter where you go, there you are.} @* -Buckaroo Bonzai +@i{No matter where you go, there you are.} +@author Buckaroo Bonzai @end quotation @c It's enough to show chdir and stat, no need for fts @@ -32870,8 +32867,8 @@ cases: the default regexp matching; with @option{--traditional}, and with @appendixsec Major Contributors to @command{gawk} @cindex @command{gawk}, list of contributors to @quotation -@i{Always give credit where credit is due.}@* -Anonymous +@i{Always give credit where credit is due.} +@author Anonymous @end quotation This @value{SECTION} names the major contributors to @command{gawk} @@ -34175,8 +34172,8 @@ recommend compiling and using the current version. @appendixsec Reporting Problems and Bugs @cindex archeologists @quotation -@i{There is nothing more dangerous than a bored archeologist.}@* -The Hitchhiker's Guide to the Galaxy +@i{There is nothing more dangerous than a bored archeologist.} +@author The Hitchhiker's Guide to the Galaxy @end quotation @c the radio show, not the book. :-) @@ -34292,8 +34289,8 @@ Date: Wed, 4 Sep 1996 08:11:48 -0700 (PDT) @cindex Brennan, Michael @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}@* -Michael Brennan +@ @ @ @ @ @ @code{// Do C++ comments work? answer: yes! of course} +@author Michael Brennan @end quotation There are a number of other freely available @command{awk} implementations. @@ -35087,11 +35084,11 @@ Larry @cindex Wall, Larry @cindex Robbins, Arnold @quotation -@i{AWK is a language similar to PERL, only considerably more elegant.}@* -Arnold Robbins +@i{AWK is a language similar to PERL, only considerably more elegant.} +@author Arnold Robbins -@i{Hey!}@* -Larry Wall +@i{Hey!} +@author Larry Wall @end quotation The @file{TODO} file in the @command{gawk} Git repository lists possible |