diff options
| -rw-r--r-- | doc/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/gawk.info | 496 | ||||
| -rw-r--r-- | doc/gawk.texi | 26 |
3 files changed, 245 insertions, 282 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index de47ba1b..f89f1603 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +Mon May 16 16:40:50 2011 Arnold D. Robbins <arnold@skeeve.com> + + * gawk.texi: Remove last vestiges of old PROCINFO sorting + description. + Mon May 9 15:58:33 2011 Arnold D. Robbins <arnold@skeeve.com> * gawk.texi: Finish array sorting and do a spell check. diff --git a/doc/gawk.info b/doc/gawk.info index 9d6774f7..2edfe381 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -9448,31 +9448,9 @@ with a pound sign (`#'). `PROCINFO["sorted_in"]' If this element exists in `PROCINFO', its value controls the order in which array indices will be processed by `for (index - in array) ...' loops. The value should contain one to three - words; separate pairs of words by a single space. One word - controls sort direction, `ascending' or `descending'; another - controls the sort key, `index' or `value'; and the remaining - one affects comparison mode, `string' or `number'. When two - or three words are present, they may be specified in any - order, so `ascending index string' and `string ascending - index' are equivalent. Also, each word may be truncated, so - `asc index str' and `a i s' are also equivalent. Note that a - separating space is required even when the words have been - shortened down to one letter each. - - You can omit direction and/or key type and/or comparison - mode. Provided that at least one is present, the missing - parts of a sort specification default to `ascending', - `index', and `string', respectively. An empty string, `""', - is the same as `ascending index string', and a value of - `unsorted' will cause `for (index in array) ...' to process - the indices in arbitrary order. Another thing to note is - that the array sorting takes place at the time the `for' loop - is about to start executing, so changing the value of - `PROCINFO["sorted_in"]' during loop execution does not have - any effect on the order in which any remaining array elements - get processed. *Note Scanning an Array::, for more - information. + in array) ...' loops. Since this is an advanced feature, we + defer the full description until later; see *note Scanning an + Array::. `PROCINFO["strftime"]' The default time format string for `strftime()'. Assigning a @@ -24817,7 +24795,7 @@ Index (line 67) * advanced features, data files as single record: Records. (line 175) * advanced features, fixed-width data: Constant Size. (line 9) -* advanced features, FNR/NR variables: Auto-set. (line 229) +* advanced features, FNR/NR variables: Auto-set. (line 207) * advanced features, gawk: Advanced Features. (line 6) * advanced features, gawk, network programming: TCP/IP Networking. (line 6) @@ -25321,7 +25299,7 @@ Index (line 47) * dark corner, FILENAME variable <1>: Auto-set. (line 92) * dark corner, FILENAME variable: Getline Notes. (line 19) -* dark corner, FNR/NR variables: Auto-set. (line 229) +* dark corner, FNR/NR variables: Auto-set. (line 207) * dark corner, format-control characters: Control Letters. (line 18) * dark corner, FS as null string: Single Character Fields. (line 20) @@ -25520,7 +25498,7 @@ Index * differences in awk and gawk, regular expressions: Case-sensitivity. (line 26) * differences in awk and gawk, RS/RT variables: Records. (line 167) -* differences in awk and gawk, RT variable: Auto-set. (line 218) +* differences in awk and gawk, RT variable: Auto-set. (line 196) * differences in awk and gawk, single-character fields: Single Character Fields. (line 6) * differences in awk and gawk, split() function: String Functions. @@ -25801,7 +25779,7 @@ Index * floating-point, numbers, AWKNUM internal type: Internals. (line 19) * FNR variable <1>: Auto-set. (line 102) * FNR variable: Records. (line 6) -* FNR variable, changing: Auto-set. (line 229) +* FNR variable, changing: Auto-set. (line 207) * for statement: For Statement. (line 6) * for statement, in arrays: Scanning an Array. (line 20) * force_number() internal function: Internals. (line 27) @@ -25974,7 +25952,7 @@ Index * gawk, regular expressions, operators: GNU Regexp Operators. (line 6) * gawk, regular expressions, precedence: Regexp Operators. (line 157) -* gawk, RT variable in <1>: Auto-set. (line 218) +* gawk, RT variable in <1>: Auto-set. (line 196) * gawk, RT variable in <2>: Getline/Variable/File. (line 10) * gawk, RT variable in <3>: Multiple Line. (line 129) @@ -26419,7 +26397,7 @@ Index * not Boolean-logic operator: Boolean Ops. (line 6) * NR variable <1>: Auto-set. (line 118) * NR variable: Records. (line 6) -* NR variable, changing: Auto-set. (line 229) +* NR variable, changing: Auto-set. (line 207) * null strings <1>: Basic Data Typing. (line 50) * null strings <2>: Truth Values. (line 6) * null strings <3>: Regexp Field Splitting. @@ -26852,7 +26830,7 @@ Index * right angle bracket (>), >> operator (I/O): Redirection. (line 50) * right shift, bitwise: Bitwise Functions. (line 32) * Ritchie, Dennis: Basic Data Typing. (line 74) -* RLENGTH variable: Auto-set. (line 205) +* RLENGTH variable: Auto-set. (line 183) * RLENGTH variable, match() function and: String Functions. (line 223) * Robbins, Arnold <1>: Future Extensions. (line 6) * Robbins, Arnold <2>: Bugs. (line 32) @@ -26877,9 +26855,9 @@ Index * RS variable: Records. (line 20) * RS variable, multiline records and: Multiple Line. (line 17) * rshift() function (gawk): Bitwise Functions. (line 51) -* RSTART variable: Auto-set. (line 211) +* RSTART variable: Auto-set. (line 189) * RSTART variable, match() function and: String Functions. (line 223) -* RT variable <1>: Auto-set. (line 218) +* RT variable <1>: Auto-set. (line 196) * RT variable <2>: Getline/Variable/File. (line 10) * RT variable <3>: Multiple Line. (line 129) @@ -27508,230 +27486,230 @@ Node: Built-in Variables387022 Node: User-modified388117 Ref: User-modified-Footnote-1396143 Node: Auto-set396205 -Ref: Auto-set-Footnote-1406918 -Node: ARGC and ARGV407123 -Node: Arrays410974 -Node: Array Basics412479 -Node: Array Intro413190 -Node: Reference to Elements417508 -Node: Assigning Elements419778 -Node: Array Example420269 -Node: Scanning an Array422001 -Node: Delete424667 -Ref: Delete-Footnote-1427102 -Node: Numeric Array Subscripts427159 -Node: Uninitialized Subscripts429342 -Node: Multi-dimensional430970 -Node: Multi-scanning434064 -Node: Arrays of Arrays435648 -Node: Functions440225 -Node: Built-in441047 -Node: Calling Built-in442125 -Node: Numeric Functions444113 -Ref: Numeric Functions-Footnote-1447878 -Ref: Numeric Functions-Footnote-2448235 -Ref: Numeric Functions-Footnote-3448283 -Node: String Functions448552 -Ref: String Functions-Footnote-1472049 -Ref: String Functions-Footnote-2472178 -Ref: String Functions-Footnote-3472426 -Node: Gory Details472513 -Ref: table-sub-escapes474192 -Ref: table-posix-sub475506 -Ref: table-gensub-escapes476419 -Node: I/O Functions477590 -Ref: I/O Functions-Footnote-1484245 -Node: Time Functions484392 -Ref: Time Functions-Footnote-1495284 -Ref: Time Functions-Footnote-2495352 -Ref: Time Functions-Footnote-3495510 -Ref: Time Functions-Footnote-4495621 -Ref: Time Functions-Footnote-5495733 -Ref: Time Functions-Footnote-6495960 -Node: Bitwise Functions496226 -Ref: table-bitwise-ops496784 -Ref: Bitwise Functions-Footnote-1500944 -Node: Type Functions501128 -Node: I18N Functions501598 -Node: User-defined503225 -Node: Definition Syntax504029 -Ref: Definition Syntax-Footnote-1508939 -Node: Function Example509008 -Node: Function Caveats511602 -Node: Calling A Function512023 -Node: Variable Scope513138 -Node: Pass By Value/Reference515113 -Node: Return Statement518553 -Node: Dynamic Typing521534 -Node: Indirect Calls522269 -Node: Internationalization531954 -Node: I18N and L10N533380 -Node: Explaining gettext534066 -Ref: Explaining gettext-Footnote-1539132 -Ref: Explaining gettext-Footnote-2539316 -Node: Programmer i18n539481 -Node: Translator i18n543681 -Node: String Extraction544474 -Ref: String Extraction-Footnote-1545435 -Node: Printf Ordering545521 -Ref: Printf Ordering-Footnote-1548305 -Node: I18N Portability548369 -Ref: I18N Portability-Footnote-1550818 -Node: I18N Example550881 -Ref: I18N Example-Footnote-1553516 -Node: Gawk I18N553588 -Node: Advanced Features554205 -Node: Nondecimal Data555718 -Node: Array Sorting557301 -Node: Controlling Array Traversal558001 -Node: Controlling Scanning With A Function558748 -Node: Controlling Scanning566451 -Ref: Controlling Scanning-Footnote-1570252 -Node: Array Sorting Functions570568 -Ref: Array Sorting Functions-Footnote-1574084 -Ref: Array Sorting Functions-Footnote-2574177 -Node: Two-way I/O574371 -Ref: Two-way I/O-Footnote-1579803 -Node: TCP/IP Networking579873 -Node: Profiling582717 -Node: Library Functions590191 -Ref: Library Functions-Footnote-1593198 -Node: Library Names593369 -Ref: Library Names-Footnote-1596840 -Ref: Library Names-Footnote-2597060 -Node: General Functions597146 -Node: Strtonum Function598099 -Node: Assert Function601029 -Node: Round Function604355 -Node: Cliff Random Function605898 -Node: Ordinal Functions606914 -Ref: Ordinal Functions-Footnote-1609984 -Ref: Ordinal Functions-Footnote-2610236 -Node: Join Function610445 -Ref: Join Function-Footnote-1612216 -Node: Gettimeofday Function612416 -Node: Data File Management616131 -Node: Filetrans Function616763 -Node: Rewind Function620902 -Node: File Checking622289 -Node: Empty Files623383 -Node: Ignoring Assigns625613 -Node: Getopt Function627166 -Ref: Getopt Function-Footnote-1638470 -Node: Passwd Functions638673 -Ref: Passwd Functions-Footnote-1647648 -Node: Group Functions647736 -Node: Walking Arrays655820 -Node: Sample Programs657389 -Node: Running Examples658054 -Node: Clones658782 -Node: Cut Program660006 -Node: Egrep Program669851 -Ref: Egrep Program-Footnote-1677624 -Node: Id Program677734 -Node: Split Program681350 -Ref: Split Program-Footnote-1684869 -Node: Tee Program684997 -Node: Uniq Program687800 -Node: Wc Program695229 -Ref: Wc Program-Footnote-1699495 -Ref: Wc Program-Footnote-2699695 -Node: Miscellaneous Programs699787 -Node: Dupword Program700975 -Node: Alarm Program703006 -Node: Translate Program707755 -Ref: Translate Program-Footnote-1712142 -Ref: Translate Program-Footnote-2712370 -Node: Labels Program712504 -Ref: Labels Program-Footnote-1715875 -Node: Word Sorting715959 -Node: History Sorting719843 -Node: Extract Program721682 -Ref: Extract Program-Footnote-1729165 -Node: Simple Sed729293 -Node: Igawk Program732355 -Ref: Igawk Program-Footnote-1747388 -Ref: Igawk Program-Footnote-2747589 -Node: Anagram Program747727 -Node: Signature Program750795 -Node: Debugger751895 -Node: Debugging752806 -Node: Debugging Concepts753219 -Node: Debugging Terms755075 -Node: Awk Debugging757698 -Node: Sample dgawk session758590 -Node: dgawk invocation759082 -Node: Finding The Bug760264 -Node: List of Debugger Commands766750 -Node: Breakpoint Control768061 -Node: Dgawk Execution Control771697 -Node: Viewing And Changing Data775048 -Node: Dgawk Stack778385 -Node: Dgawk Info779845 -Node: Miscellaneous Dgawk Commands783793 -Node: Readline Support789221 -Node: Dgawk Limitations790059 -Node: Language History792248 -Node: V7/SVR3.1793686 -Node: SVR4796007 -Node: POSIX797449 -Node: BTL798457 -Node: POSIX/GNU799191 -Node: Common Extensions804342 -Node: Contributors805443 -Node: Installation809619 -Node: Gawk Distribution810513 -Node: Getting810997 -Node: Extracting811823 -Node: Distribution contents813515 -Node: Unix Installation818737 -Node: Quick Installation819354 -Node: Additional Configuration Options821316 -Node: Configuration Philosophy822793 -Node: Non-Unix Installation825135 -Node: PC Installation825593 -Node: PC Binary Installation826892 -Node: PC Compiling828740 -Node: PC Testing831684 -Node: PC Using832860 -Node: Cygwin837045 -Node: MSYS838045 -Node: VMS Installation838559 -Node: VMS Compilation839162 -Ref: VMS Compilation-Footnote-1840169 -Node: VMS Installation Details840227 -Node: VMS Running841862 -Node: VMS Old Gawk843469 -Node: Bugs843943 -Node: Other Versions847853 -Node: Notes853132 -Node: Compatibility Mode853824 -Node: Additions854607 -Node: Accessing The Source855419 -Node: Adding Code856844 -Node: New Ports862811 -Node: Dynamic Extensions866924 -Node: Internals868300 -Node: Plugin License877403 -Node: Sample Library878037 -Node: Internal File Description878723 -Node: Internal File Ops882438 -Ref: Internal File Ops-Footnote-1887219 -Node: Using Internal File Ops887359 -Node: Future Extensions889736 -Node: Basic Concepts892240 -Node: Basic High Level892997 -Ref: Basic High Level-Footnote-1897032 -Node: Basic Data Typing897217 -Node: Floating Point Issues901742 -Node: String Conversion Precision902825 -Ref: String Conversion Precision-Footnote-1904525 -Node: Unexpected Results904634 -Node: POSIX Floating Point Problems906460 -Ref: POSIX Floating Point Problems-Footnote-1910165 -Node: Glossary910203 -Node: Copying935179 -Node: GNU Free Documentation License972736 -Node: Index997873 +Ref: Auto-set-Footnote-1405496 +Node: ARGC and ARGV405701 +Node: Arrays409552 +Node: Array Basics411057 +Node: Array Intro411768 +Node: Reference to Elements416086 +Node: Assigning Elements418356 +Node: Array Example418847 +Node: Scanning an Array420579 +Node: Delete423245 +Ref: Delete-Footnote-1425680 +Node: Numeric Array Subscripts425737 +Node: Uninitialized Subscripts427920 +Node: Multi-dimensional429548 +Node: Multi-scanning432642 +Node: Arrays of Arrays434226 +Node: Functions438803 +Node: Built-in439625 +Node: Calling Built-in440703 +Node: Numeric Functions442691 +Ref: Numeric Functions-Footnote-1446456 +Ref: Numeric Functions-Footnote-2446813 +Ref: Numeric Functions-Footnote-3446861 +Node: String Functions447130 +Ref: String Functions-Footnote-1470627 +Ref: String Functions-Footnote-2470756 +Ref: String Functions-Footnote-3471004 +Node: Gory Details471091 +Ref: table-sub-escapes472770 +Ref: table-posix-sub474084 +Ref: table-gensub-escapes474997 +Node: I/O Functions476168 +Ref: I/O Functions-Footnote-1482823 +Node: Time Functions482970 +Ref: Time Functions-Footnote-1493862 +Ref: Time Functions-Footnote-2493930 +Ref: Time Functions-Footnote-3494088 +Ref: Time Functions-Footnote-4494199 +Ref: Time Functions-Footnote-5494311 +Ref: Time Functions-Footnote-6494538 +Node: Bitwise Functions494804 +Ref: table-bitwise-ops495362 +Ref: Bitwise Functions-Footnote-1499522 +Node: Type Functions499706 +Node: I18N Functions500176 +Node: User-defined501803 +Node: Definition Syntax502607 +Ref: Definition Syntax-Footnote-1507517 +Node: Function Example507586 +Node: Function Caveats510180 +Node: Calling A Function510601 +Node: Variable Scope511716 +Node: Pass By Value/Reference513691 +Node: Return Statement517131 +Node: Dynamic Typing520112 +Node: Indirect Calls520847 +Node: Internationalization530532 +Node: I18N and L10N531958 +Node: Explaining gettext532644 +Ref: Explaining gettext-Footnote-1537710 +Ref: Explaining gettext-Footnote-2537894 +Node: Programmer i18n538059 +Node: Translator i18n542259 +Node: String Extraction543052 +Ref: String Extraction-Footnote-1544013 +Node: Printf Ordering544099 +Ref: Printf Ordering-Footnote-1546883 +Node: I18N Portability546947 +Ref: I18N Portability-Footnote-1549396 +Node: I18N Example549459 +Ref: I18N Example-Footnote-1552094 +Node: Gawk I18N552166 +Node: Advanced Features552783 +Node: Nondecimal Data554296 +Node: Array Sorting555879 +Node: Controlling Array Traversal556579 +Node: Controlling Scanning With A Function557326 +Node: Controlling Scanning565029 +Ref: Controlling Scanning-Footnote-1568830 +Node: Array Sorting Functions569146 +Ref: Array Sorting Functions-Footnote-1572662 +Ref: Array Sorting Functions-Footnote-2572755 +Node: Two-way I/O572949 +Ref: Two-way I/O-Footnote-1578381 +Node: TCP/IP Networking578451 +Node: Profiling581295 +Node: Library Functions588769 +Ref: Library Functions-Footnote-1591776 +Node: Library Names591947 +Ref: Library Names-Footnote-1595418 +Ref: Library Names-Footnote-2595638 +Node: General Functions595724 +Node: Strtonum Function596677 +Node: Assert Function599607 +Node: Round Function602933 +Node: Cliff Random Function604476 +Node: Ordinal Functions605492 +Ref: Ordinal Functions-Footnote-1608562 +Ref: Ordinal Functions-Footnote-2608814 +Node: Join Function609023 +Ref: Join Function-Footnote-1610794 +Node: Gettimeofday Function610994 +Node: Data File Management614709 +Node: Filetrans Function615341 +Node: Rewind Function619480 +Node: File Checking620867 +Node: Empty Files621961 +Node: Ignoring Assigns624191 +Node: Getopt Function625744 +Ref: Getopt Function-Footnote-1637048 +Node: Passwd Functions637251 +Ref: Passwd Functions-Footnote-1646226 +Node: Group Functions646314 +Node: Walking Arrays654398 +Node: Sample Programs655967 +Node: Running Examples656632 +Node: Clones657360 +Node: Cut Program658584 +Node: Egrep Program668429 +Ref: Egrep Program-Footnote-1676202 +Node: Id Program676312 +Node: Split Program679928 +Ref: Split Program-Footnote-1683447 +Node: Tee Program683575 +Node: Uniq Program686378 +Node: Wc Program693807 +Ref: Wc Program-Footnote-1698073 +Ref: Wc Program-Footnote-2698273 +Node: Miscellaneous Programs698365 +Node: Dupword Program699553 +Node: Alarm Program701584 +Node: Translate Program706333 +Ref: Translate Program-Footnote-1710720 +Ref: Translate Program-Footnote-2710948 +Node: Labels Program711082 +Ref: Labels Program-Footnote-1714453 +Node: Word Sorting714537 +Node: History Sorting718421 +Node: Extract Program720260 +Ref: Extract Program-Footnote-1727743 +Node: Simple Sed727871 +Node: Igawk Program730933 +Ref: Igawk Program-Footnote-1745966 +Ref: Igawk Program-Footnote-2746167 +Node: Anagram Program746305 +Node: Signature Program749373 +Node: Debugger750473 +Node: Debugging751384 +Node: Debugging Concepts751797 +Node: Debugging Terms753653 +Node: Awk Debugging756276 +Node: Sample dgawk session757168 +Node: dgawk invocation757660 +Node: Finding The Bug758842 +Node: List of Debugger Commands765328 +Node: Breakpoint Control766639 +Node: Dgawk Execution Control770275 +Node: Viewing And Changing Data773626 +Node: Dgawk Stack776963 +Node: Dgawk Info778423 +Node: Miscellaneous Dgawk Commands782371 +Node: Readline Support787799 +Node: Dgawk Limitations788637 +Node: Language History790826 +Node: V7/SVR3.1792264 +Node: SVR4794585 +Node: POSIX796027 +Node: BTL797035 +Node: POSIX/GNU797769 +Node: Common Extensions802920 +Node: Contributors804021 +Node: Installation808197 +Node: Gawk Distribution809091 +Node: Getting809575 +Node: Extracting810401 +Node: Distribution contents812093 +Node: Unix Installation817315 +Node: Quick Installation817932 +Node: Additional Configuration Options819894 +Node: Configuration Philosophy821371 +Node: Non-Unix Installation823713 +Node: PC Installation824171 +Node: PC Binary Installation825470 +Node: PC Compiling827318 +Node: PC Testing830262 +Node: PC Using831438 +Node: Cygwin835623 +Node: MSYS836623 +Node: VMS Installation837137 +Node: VMS Compilation837740 +Ref: VMS Compilation-Footnote-1838747 +Node: VMS Installation Details838805 +Node: VMS Running840440 +Node: VMS Old Gawk842047 +Node: Bugs842521 +Node: Other Versions846431 +Node: Notes851710 +Node: Compatibility Mode852402 +Node: Additions853185 +Node: Accessing The Source853997 +Node: Adding Code855422 +Node: New Ports861389 +Node: Dynamic Extensions865502 +Node: Internals866878 +Node: Plugin License875981 +Node: Sample Library876615 +Node: Internal File Description877301 +Node: Internal File Ops881016 +Ref: Internal File Ops-Footnote-1885797 +Node: Using Internal File Ops885937 +Node: Future Extensions888314 +Node: Basic Concepts890818 +Node: Basic High Level891575 +Ref: Basic High Level-Footnote-1895610 +Node: Basic Data Typing895795 +Node: Floating Point Issues900320 +Node: String Conversion Precision901403 +Ref: String Conversion Precision-Footnote-1903103 +Node: Unexpected Results903212 +Node: POSIX Floating Point Problems905038 +Ref: POSIX Floating Point Problems-Footnote-1908743 +Node: Glossary908781 +Node: Copying933757 +Node: GNU Free Documentation License971314 +Node: Index996451 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 7c328723..4f329afd 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -12794,29 +12794,9 @@ The parent process ID of the current process. If this element exists in @code{PROCINFO}, its value controls the order in which array indices will be processed by @samp{for (index in array) @dots{}} loops. -The value should contain one to three words; separate pairs of words -by a single space. -One word controls sort direction, @samp{ascending} or @samp{descending}; -another controls the sort key, @samp{index} or @samp{value}; and the remaining -one affects comparison mode, @samp{string} or @samp{number}. When two or three -words are present, they may be specified in any order, so @samp{ascending index string} and -@samp{string ascending index} are equivalent. Also, each word may -be truncated, so @samp{asc index str} and @samp{a i s} are also -equivalent. Note that a separating space is required even when the -words have been shortened down to one letter each. - -You can omit direction and/or key type and/or comparison mode. Provided -that at least one is present, the missing parts of a sort specification -default to @samp{ascending}, @samp{index}, and @samp{string}, respectively. -An empty string, @code{""}, is the same as @samp{ascending index string}, -and a value of @samp{unsorted} will cause @samp{for (index in array) @dots{}} -to process -the indices in arbitrary order. Another thing to note is that the array sorting -takes place at the time the @code{for} loop is about to -start executing, so changing the value of @code{PROCINFO["sorted_in"]} -during loop execution does not have any effect on the order in which any -remaining array elements get processed. -@xref{Scanning an Array}, for more information. +Since this is an advanced feature, we defer the +full description until later; see +@ref{Scanning an Array}. @item PROCINFO["strftime"] The default time format string for @code{strftime()}. |