diff options
| -rw-r--r-- | doc/gawk.info | 1040 | ||||
| -rw-r--r-- | doc/gawk.texi | 8 | ||||
| -rw-r--r-- | doc/gawktexi.in | 8 |
3 files changed, 537 insertions, 519 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index f77d742e..3e2ae355 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -2538,8 +2538,8 @@ The following list describes options mandated by the POSIX standard: applications that pass arguments through the URL; using this option prevents a malicious (or other) user from passing in options, assignments, or `awk' source code (via `-e') to the CGI - application. This option should be used with `#!' scripts (*note - Executable Scripts::), like so: + application.(1) This option should be used with `#!' scripts + (*note Executable Scripts::), like so: #! /usr/local/bin/gawk -E @@ -2756,7 +2756,7 @@ you would add these lines to the `.profile' file in your home directory: POSIXLY_CORRECT=true export POSIXLY_CORRECT - For a C shell-compatible shell,(1) you would add this line to the + For a C shell-compatible shell,(2) you would add this line to the `.login' file in your home directory: setenv POSIXLY_CORRECT true @@ -2767,7 +2767,12 @@ environments. ---------- Footnotes ---------- - (1) Not recommended. + (1) For more detail, please see Section 4.4 of RFC 3875 +(http://www.ietf.org/rfc/rfc3875). Also see the explanatory note sent +to the `gawk' bug mailing list +(http://lists.gnu.org/archive/html/bug-gawk/2014-11/msg00022.html). + + (2) Not recommended. File: gawk.info, Node: Other Arguments, Next: Naming Standard Input, Prev: Options, Up: Invoking Gawk @@ -34332,518 +34337,519 @@ Node: Intro Summary112624 Node: Invoking Gawk113507 Node: Command Line115021 Node: Options115819 -Ref: Options-Footnote-1131750 -Node: Other Arguments131775 -Node: Naming Standard Input134723 -Node: Environment Variables135816 -Node: AWKPATH Variable136374 -Ref: AWKPATH Variable-Footnote-1139677 -Ref: AWKPATH Variable-Footnote-2139722 -Node: AWKLIBPATH Variable139982 -Node: Other Environment Variables141125 -Node: Exit Status144853 -Node: Include Files145529 -Node: Loading Shared Libraries149126 -Node: Obsolete150553 -Node: Undocumented151250 -Node: Invoking Summary151517 -Node: Regexp153181 -Node: Regexp Usage154635 -Node: Escape Sequences156672 -Node: Regexp Operators162683 -Ref: Regexp Operators-Footnote-1170109 -Ref: Regexp Operators-Footnote-2170256 -Node: Bracket Expressions170354 -Ref: table-char-classes172369 -Node: Leftmost Longest175293 -Node: Computed Regexps176595 -Node: GNU Regexp Operators179992 -Node: Case-sensitivity183665 -Ref: Case-sensitivity-Footnote-1186550 -Ref: Case-sensitivity-Footnote-2186785 -Node: Regexp Summary186893 -Node: Reading Files188360 -Node: Records190454 -Node: awk split records191187 -Node: gawk split records196102 -Ref: gawk split records-Footnote-1200642 -Node: Fields200679 -Ref: Fields-Footnote-1203455 -Node: Nonconstant Fields203541 -Ref: Nonconstant Fields-Footnote-1205784 -Node: Changing Fields205988 -Node: Field Separators211917 -Node: Default Field Splitting214622 -Node: Regexp Field Splitting215739 -Node: Single Character Fields219089 -Node: Command Line Field Separator220148 -Node: Full Line Fields223360 -Ref: Full Line Fields-Footnote-1224877 -Ref: Full Line Fields-Footnote-2224923 -Node: Field Splitting Summary225024 -Node: Constant Size227098 -Node: Splitting By Content231687 -Ref: Splitting By Content-Footnote-1235681 -Node: Multiple Line235844 -Ref: Multiple Line-Footnote-1241730 -Node: Getline241909 -Node: Plain Getline244121 -Node: Getline/Variable246761 -Node: Getline/File247909 -Node: Getline/Variable/File249293 -Ref: Getline/Variable/File-Footnote-1250896 -Node: Getline/Pipe250983 -Node: Getline/Variable/Pipe253666 -Node: Getline/Coprocess254797 -Node: Getline/Variable/Coprocess256049 -Node: Getline Notes256788 -Node: Getline Summary259580 -Ref: table-getline-variants259992 -Node: Read Timeout260821 -Ref: Read Timeout-Footnote-1264646 -Node: Command-line directories264704 -Node: Input Summary265609 -Node: Input Exercises268862 -Node: Printing269590 -Node: Print271367 -Node: Print Examples272824 -Node: Output Separators275603 -Node: OFMT277621 -Node: Printf278975 -Node: Basic Printf279760 -Node: Control Letters281329 -Node: Format Modifiers285313 -Node: Printf Examples291314 -Node: Redirection293800 -Node: Special FD300641 -Ref: Special FD-Footnote-1303801 -Node: Special Files303875 -Node: Other Inherited Files304492 -Node: Special Network305492 -Node: Special Caveats306354 -Node: Close Files And Pipes307305 -Ref: Close Files And Pipes-Footnote-1314487 -Ref: Close Files And Pipes-Footnote-2314635 -Node: Output Summary314785 -Node: Output Exercises315783 -Node: Expressions316463 -Node: Values317648 -Node: Constants318326 -Node: Scalar Constants319017 -Ref: Scalar Constants-Footnote-1319876 -Node: Nondecimal-numbers320126 -Node: Regexp Constants323144 -Node: Using Constant Regexps323669 -Node: Variables326812 -Node: Using Variables327467 -Node: Assignment Options329378 -Node: Conversion331253 -Node: Strings And Numbers331777 -Ref: Strings And Numbers-Footnote-1334842 -Node: Locale influences conversions334951 -Ref: table-locale-affects337698 -Node: All Operators338286 -Node: Arithmetic Ops338916 -Node: Concatenation341421 -Ref: Concatenation-Footnote-1344240 -Node: Assignment Ops344346 -Ref: table-assign-ops349325 -Node: Increment Ops350597 -Node: Truth Values and Conditions354035 -Node: Truth Values355120 -Node: Typing and Comparison356169 -Node: Variable Typing356979 -Node: Comparison Operators360632 -Ref: table-relational-ops361042 -Node: POSIX String Comparison364537 -Ref: POSIX String Comparison-Footnote-1365609 -Node: Boolean Ops365747 -Ref: Boolean Ops-Footnote-1370226 -Node: Conditional Exp370317 -Node: Function Calls372044 -Node: Precedence375924 -Node: Locales379585 -Node: Expressions Summary381217 -Node: Patterns and Actions383777 -Node: Pattern Overview384897 -Node: Regexp Patterns386576 -Node: Expression Patterns387119 -Node: Ranges390900 -Node: BEGIN/END394006 -Node: Using BEGIN/END394767 -Ref: Using BEGIN/END-Footnote-1397501 -Node: I/O And BEGIN/END397607 -Node: BEGINFILE/ENDFILE399921 -Node: Empty402822 -Node: Using Shell Variables403139 -Node: Action Overview405412 -Node: Statements407738 -Node: If Statement409586 -Node: While Statement411081 -Node: Do Statement413110 -Node: For Statement414254 -Node: Switch Statement417411 -Node: Break Statement419793 -Node: Continue Statement421834 -Node: Next Statement423661 -Node: Nextfile Statement426042 -Node: Exit Statement428672 -Node: Built-in Variables431075 -Node: User-modified432208 -Ref: User-modified-Footnote-1439889 -Node: Auto-set439951 -Ref: Auto-set-Footnote-1452986 -Ref: Auto-set-Footnote-2453191 -Node: ARGC and ARGV453247 -Node: Pattern Action Summary457465 -Node: Arrays459892 -Node: Array Basics461221 -Node: Array Intro462065 -Ref: figure-array-elements464029 -Ref: Array Intro-Footnote-1466555 -Node: Reference to Elements466683 -Node: Assigning Elements469135 -Node: Array Example469626 -Node: Scanning an Array471384 -Node: Controlling Scanning474400 -Ref: Controlling Scanning-Footnote-1479596 -Node: Numeric Array Subscripts479912 -Node: Uninitialized Subscripts482097 -Node: Delete483714 -Ref: Delete-Footnote-1486457 -Node: Multidimensional486514 -Node: Multiscanning489611 -Node: Arrays of Arrays491200 -Node: Arrays Summary495959 -Node: Functions498051 -Node: Built-in498924 -Node: Calling Built-in500002 -Node: Numeric Functions501993 -Ref: Numeric Functions-Footnote-1506010 -Ref: Numeric Functions-Footnote-2506367 -Ref: Numeric Functions-Footnote-3506415 -Node: String Functions506687 -Ref: String Functions-Footnote-1530162 -Ref: String Functions-Footnote-2530291 -Ref: String Functions-Footnote-3530539 -Node: Gory Details530626 -Ref: table-sub-escapes532407 -Ref: table-sub-proposed533927 -Ref: table-posix-sub535291 -Ref: table-gensub-escapes536827 -Ref: Gory Details-Footnote-1537659 -Node: I/O Functions537810 -Ref: I/O Functions-Footnote-1545028 -Node: Time Functions545175 -Ref: Time Functions-Footnote-1555663 -Ref: Time Functions-Footnote-2555731 -Ref: Time Functions-Footnote-3555889 -Ref: Time Functions-Footnote-4556000 -Ref: Time Functions-Footnote-5556112 -Ref: Time Functions-Footnote-6556339 -Node: Bitwise Functions556605 -Ref: table-bitwise-ops557167 -Ref: Bitwise Functions-Footnote-1561476 -Node: Type Functions561645 -Node: I18N Functions562796 -Node: User-defined564441 -Node: Definition Syntax565246 -Ref: Definition Syntax-Footnote-1570653 -Node: Function Example570724 -Ref: Function Example-Footnote-1573643 -Node: Function Caveats573665 -Node: Calling A Function574183 -Node: Variable Scope575141 -Node: Pass By Value/Reference578129 -Node: Return Statement581624 -Node: Dynamic Typing584605 -Node: Indirect Calls585534 -Ref: Indirect Calls-Footnote-1596836 -Node: Functions Summary596964 -Node: Library Functions599666 -Ref: Library Functions-Footnote-1603275 -Ref: Library Functions-Footnote-2603418 -Node: Library Names603589 -Ref: Library Names-Footnote-1607043 -Ref: Library Names-Footnote-2607266 -Node: General Functions607352 -Node: Strtonum Function608455 -Node: Assert Function611477 -Node: Round Function614801 -Node: Cliff Random Function616342 -Node: Ordinal Functions617358 -Ref: Ordinal Functions-Footnote-1620421 -Ref: Ordinal Functions-Footnote-2620673 -Node: Join Function620884 -Ref: Join Function-Footnote-1622653 -Node: Getlocaltime Function622853 -Node: Readfile Function626597 -Node: Shell Quoting628567 -Node: Data File Management629968 -Node: Filetrans Function630600 -Node: Rewind Function634656 -Node: File Checking636043 -Ref: File Checking-Footnote-1637375 -Node: Empty Files637576 -Node: Ignoring Assigns639555 -Node: Getopt Function641106 -Ref: Getopt Function-Footnote-1652568 -Node: Passwd Functions652768 -Ref: Passwd Functions-Footnote-1661605 -Node: Group Functions661693 -Ref: Group Functions-Footnote-1669587 -Node: Walking Arrays669800 -Node: Library Functions Summary671403 -Node: Library Exercises672804 -Node: Sample Programs674084 -Node: Running Examples674854 -Node: Clones675582 -Node: Cut Program676806 -Node: Egrep Program686525 -Ref: Egrep Program-Footnote-1694023 -Node: Id Program694133 -Node: Split Program697778 -Ref: Split Program-Footnote-1701226 -Node: Tee Program701354 -Node: Uniq Program704143 -Node: Wc Program711562 -Ref: Wc Program-Footnote-1715812 -Node: Miscellaneous Programs715906 -Node: Dupword Program717119 -Node: Alarm Program719150 -Node: Translate Program723954 -Ref: Translate Program-Footnote-1728519 -Node: Labels Program728789 -Ref: Labels Program-Footnote-1732140 -Node: Word Sorting732224 -Node: History Sorting736295 -Node: Extract Program738131 -Node: Simple Sed745656 -Node: Igawk Program748724 -Ref: Igawk Program-Footnote-1763048 -Ref: Igawk Program-Footnote-2763249 -Ref: Igawk Program-Footnote-3763371 -Node: Anagram Program763486 -Node: Signature Program766543 -Node: Programs Summary767790 -Node: Programs Exercises768983 -Ref: Programs Exercises-Footnote-1773114 -Node: Advanced Features773205 -Node: Nondecimal Data775153 -Node: Array Sorting776743 -Node: Controlling Array Traversal777440 -Ref: Controlling Array Traversal-Footnote-1785773 -Node: Array Sorting Functions785891 -Ref: Array Sorting Functions-Footnote-1789780 -Node: Two-way I/O789976 -Ref: Two-way I/O-Footnote-1794917 -Ref: Two-way I/O-Footnote-2795103 -Node: TCP/IP Networking795185 -Node: Profiling798058 -Node: Advanced Features Summary805605 -Node: Internationalization807538 -Node: I18N and L10N809018 -Node: Explaining gettext809704 -Ref: Explaining gettext-Footnote-1814729 -Ref: Explaining gettext-Footnote-2814913 -Node: Programmer i18n815078 -Ref: Programmer i18n-Footnote-1819944 -Node: Translator i18n819993 -Node: String Extraction820787 -Ref: String Extraction-Footnote-1821918 -Node: Printf Ordering822004 -Ref: Printf Ordering-Footnote-1824790 -Node: I18N Portability824854 -Ref: I18N Portability-Footnote-1827309 -Node: I18N Example827372 -Ref: I18N Example-Footnote-1830175 -Node: Gawk I18N830247 -Node: I18N Summary830885 -Node: Debugger832224 -Node: Debugging833246 -Node: Debugging Concepts833687 -Node: Debugging Terms835540 -Node: Awk Debugging838112 -Node: Sample Debugging Session839006 -Node: Debugger Invocation839526 -Node: Finding The Bug840910 -Node: List of Debugger Commands847385 -Node: Breakpoint Control848718 -Node: Debugger Execution Control852414 -Node: Viewing And Changing Data855778 -Node: Execution Stack859156 -Node: Debugger Info860793 -Node: Miscellaneous Debugger Commands864810 -Node: Readline Support869839 -Node: Limitations870731 -Node: Debugging Summary872845 -Node: Arbitrary Precision Arithmetic874013 -Node: Computer Arithmetic875429 -Ref: table-numeric-ranges879027 -Ref: Computer Arithmetic-Footnote-1879886 -Node: Math Definitions879943 -Ref: table-ieee-formats883231 -Ref: Math Definitions-Footnote-1883835 -Node: MPFR features883940 -Node: FP Math Caution885611 -Ref: FP Math Caution-Footnote-1886661 -Node: Inexactness of computations887030 -Node: Inexact representation887989 -Node: Comparing FP Values889346 -Node: Errors accumulate890428 -Node: Getting Accuracy891861 -Node: Try To Round894523 -Node: Setting precision895422 -Ref: table-predefined-precision-strings896106 -Node: Setting the rounding mode897895 -Ref: table-gawk-rounding-modes898259 -Ref: Setting the rounding mode-Footnote-1901714 -Node: Arbitrary Precision Integers901893 -Ref: Arbitrary Precision Integers-Footnote-1904879 -Node: POSIX Floating Point Problems905028 -Ref: POSIX Floating Point Problems-Footnote-1908901 -Node: Floating point summary908939 -Node: Dynamic Extensions911133 -Node: Extension Intro912685 -Node: Plugin License913951 -Node: Extension Mechanism Outline914748 -Ref: figure-load-extension915176 -Ref: figure-register-new-function916656 -Ref: figure-call-new-function917660 -Node: Extension API Description919646 -Node: Extension API Functions Introduction921096 -Node: General Data Types925920 -Ref: General Data Types-Footnote-1931659 -Node: Memory Allocation Functions931958 -Ref: Memory Allocation Functions-Footnote-1934797 -Node: Constructor Functions934893 -Node: Registration Functions936627 -Node: Extension Functions937312 -Node: Exit Callback Functions939609 -Node: Extension Version String940857 -Node: Input Parsers941522 -Node: Output Wrappers951399 -Node: Two-way processors955914 -Node: Printing Messages958118 -Ref: Printing Messages-Footnote-1959194 -Node: Updating `ERRNO'959346 -Node: Requesting Values960086 -Ref: table-value-types-returned960814 -Node: Accessing Parameters961771 -Node: Symbol Table Access963002 -Node: Symbol table by name963516 -Node: Symbol table by cookie965497 -Ref: Symbol table by cookie-Footnote-1969641 -Node: Cached values969704 -Ref: Cached values-Footnote-1973203 -Node: Array Manipulation973294 -Ref: Array Manipulation-Footnote-1974392 -Node: Array Data Types974429 -Ref: Array Data Types-Footnote-1977084 -Node: Array Functions977176 -Node: Flattening Arrays981030 -Node: Creating Arrays987922 -Node: Extension API Variables992691 -Node: Extension Versioning993327 -Node: Extension API Informational Variables995228 -Node: Extension API Boilerplate996316 -Node: Finding Extensions1000125 -Node: Extension Example1000685 -Node: Internal File Description1001457 -Node: Internal File Ops1005524 -Ref: Internal File Ops-Footnote-11017194 -Node: Using Internal File Ops1017334 -Ref: Using Internal File Ops-Footnote-11019717 -Node: Extension Samples1019990 -Node: Extension Sample File Functions1021516 -Node: Extension Sample Fnmatch1029154 -Node: Extension Sample Fork1030645 -Node: Extension Sample Inplace1031860 -Node: Extension Sample Ord1033535 -Node: Extension Sample Readdir1034371 -Ref: table-readdir-file-types1035247 -Node: Extension Sample Revout1036058 -Node: Extension Sample Rev2way1036648 -Node: Extension Sample Read write array1037388 -Node: Extension Sample Readfile1039328 -Node: Extension Sample Time1040423 -Node: Extension Sample API Tests1041772 -Node: gawkextlib1042263 -Node: Extension summary1044921 -Node: Extension Exercises1048598 -Node: Language History1049320 -Node: V7/SVR3.11050976 -Node: SVR41053157 -Node: POSIX1054602 -Node: BTL1055991 -Node: POSIX/GNU1056725 -Node: Feature History1062289 -Node: Common Extensions1075387 -Node: Ranges and Locales1076711 -Ref: Ranges and Locales-Footnote-11081329 -Ref: Ranges and Locales-Footnote-21081356 -Ref: Ranges and Locales-Footnote-31081590 -Node: Contributors1081811 -Node: History summary1087352 -Node: Installation1088722 -Node: Gawk Distribution1089668 -Node: Getting1090152 -Node: Extracting1090975 -Node: Distribution contents1092610 -Node: Unix Installation1098327 -Node: Quick Installation1098944 -Node: Additional Configuration Options1101368 -Node: Configuration Philosophy1103106 -Node: Non-Unix Installation1105475 -Node: PC Installation1105933 -Node: PC Binary Installation1107252 -Node: PC Compiling1109100 -Ref: PC Compiling-Footnote-11112121 -Node: PC Testing1112230 -Node: PC Using1113406 -Node: Cygwin1117521 -Node: MSYS1118344 -Node: VMS Installation1118844 -Node: VMS Compilation1119636 -Ref: VMS Compilation-Footnote-11120858 -Node: VMS Dynamic Extensions1120916 -Node: VMS Installation Details1122600 -Node: VMS Running1124852 -Node: VMS GNV1127688 -Node: VMS Old Gawk1128422 -Node: Bugs1128892 -Node: Other Versions1132775 -Node: Installation summary1139197 -Node: Notes1140253 -Node: Compatibility Mode1141118 -Node: Additions1141900 -Node: Accessing The Source1142825 -Node: Adding Code1144261 -Node: New Ports1150426 -Node: Derived Files1154908 -Ref: Derived Files-Footnote-11160383 -Ref: Derived Files-Footnote-21160417 -Ref: Derived Files-Footnote-31161013 -Node: Future Extensions1161127 -Node: Implementation Limitations1161733 -Node: Extension Design1162981 -Node: Old Extension Problems1164135 -Ref: Old Extension Problems-Footnote-11165652 -Node: Extension New Mechanism Goals1165709 -Ref: Extension New Mechanism Goals-Footnote-11169069 -Node: Extension Other Design Decisions1169258 -Node: Extension Future Growth1171366 -Node: Old Extension Mechanism1172202 -Node: Notes summary1173964 -Node: Basic Concepts1175150 -Node: Basic High Level1175831 -Ref: figure-general-flow1176103 -Ref: figure-process-flow1176702 -Ref: Basic High Level-Footnote-11179931 -Node: Basic Data Typing1180116 -Node: Glossary1183444 -Node: Copying1208602 -Node: GNU Free Documentation License1246158 -Node: Index1271294 +Ref: Options-Footnote-1131752 +Ref: Options-Footnote-2131981 +Node: Other Arguments132006 +Node: Naming Standard Input134954 +Node: Environment Variables136047 +Node: AWKPATH Variable136605 +Ref: AWKPATH Variable-Footnote-1139908 +Ref: AWKPATH Variable-Footnote-2139953 +Node: AWKLIBPATH Variable140213 +Node: Other Environment Variables141356 +Node: Exit Status145084 +Node: Include Files145760 +Node: Loading Shared Libraries149357 +Node: Obsolete150784 +Node: Undocumented151481 +Node: Invoking Summary151748 +Node: Regexp153412 +Node: Regexp Usage154866 +Node: Escape Sequences156903 +Node: Regexp Operators162914 +Ref: Regexp Operators-Footnote-1170340 +Ref: Regexp Operators-Footnote-2170487 +Node: Bracket Expressions170585 +Ref: table-char-classes172600 +Node: Leftmost Longest175524 +Node: Computed Regexps176826 +Node: GNU Regexp Operators180223 +Node: Case-sensitivity183896 +Ref: Case-sensitivity-Footnote-1186781 +Ref: Case-sensitivity-Footnote-2187016 +Node: Regexp Summary187124 +Node: Reading Files188591 +Node: Records190685 +Node: awk split records191418 +Node: gawk split records196333 +Ref: gawk split records-Footnote-1200873 +Node: Fields200910 +Ref: Fields-Footnote-1203686 +Node: Nonconstant Fields203772 +Ref: Nonconstant Fields-Footnote-1206015 +Node: Changing Fields206219 +Node: Field Separators212148 +Node: Default Field Splitting214853 +Node: Regexp Field Splitting215970 +Node: Single Character Fields219320 +Node: Command Line Field Separator220379 +Node: Full Line Fields223591 +Ref: Full Line Fields-Footnote-1225108 +Ref: Full Line Fields-Footnote-2225154 +Node: Field Splitting Summary225255 +Node: Constant Size227329 +Node: Splitting By Content231918 +Ref: Splitting By Content-Footnote-1235912 +Node: Multiple Line236075 +Ref: Multiple Line-Footnote-1241961 +Node: Getline242140 +Node: Plain Getline244352 +Node: Getline/Variable246992 +Node: Getline/File248140 +Node: Getline/Variable/File249524 +Ref: Getline/Variable/File-Footnote-1251127 +Node: Getline/Pipe251214 +Node: Getline/Variable/Pipe253897 +Node: Getline/Coprocess255028 +Node: Getline/Variable/Coprocess256280 +Node: Getline Notes257019 +Node: Getline Summary259811 +Ref: table-getline-variants260223 +Node: Read Timeout261052 +Ref: Read Timeout-Footnote-1264877 +Node: Command-line directories264935 +Node: Input Summary265840 +Node: Input Exercises269093 +Node: Printing269821 +Node: Print271598 +Node: Print Examples273055 +Node: Output Separators275834 +Node: OFMT277852 +Node: Printf279206 +Node: Basic Printf279991 +Node: Control Letters281560 +Node: Format Modifiers285544 +Node: Printf Examples291545 +Node: Redirection294031 +Node: Special FD300872 +Ref: Special FD-Footnote-1304032 +Node: Special Files304106 +Node: Other Inherited Files304723 +Node: Special Network305723 +Node: Special Caveats306585 +Node: Close Files And Pipes307536 +Ref: Close Files And Pipes-Footnote-1314718 +Ref: Close Files And Pipes-Footnote-2314866 +Node: Output Summary315016 +Node: Output Exercises316014 +Node: Expressions316694 +Node: Values317879 +Node: Constants318557 +Node: Scalar Constants319248 +Ref: Scalar Constants-Footnote-1320107 +Node: Nondecimal-numbers320357 +Node: Regexp Constants323375 +Node: Using Constant Regexps323900 +Node: Variables327043 +Node: Using Variables327698 +Node: Assignment Options329609 +Node: Conversion331484 +Node: Strings And Numbers332008 +Ref: Strings And Numbers-Footnote-1335073 +Node: Locale influences conversions335182 +Ref: table-locale-affects337929 +Node: All Operators338517 +Node: Arithmetic Ops339147 +Node: Concatenation341652 +Ref: Concatenation-Footnote-1344471 +Node: Assignment Ops344577 +Ref: table-assign-ops349556 +Node: Increment Ops350828 +Node: Truth Values and Conditions354266 +Node: Truth Values355351 +Node: Typing and Comparison356400 +Node: Variable Typing357210 +Node: Comparison Operators360863 +Ref: table-relational-ops361273 +Node: POSIX String Comparison364768 +Ref: POSIX String Comparison-Footnote-1365840 +Node: Boolean Ops365978 +Ref: Boolean Ops-Footnote-1370457 +Node: Conditional Exp370548 +Node: Function Calls372275 +Node: Precedence376155 +Node: Locales379816 +Node: Expressions Summary381448 +Node: Patterns and Actions384008 +Node: Pattern Overview385128 +Node: Regexp Patterns386807 +Node: Expression Patterns387350 +Node: Ranges391131 +Node: BEGIN/END394237 +Node: Using BEGIN/END394998 +Ref: Using BEGIN/END-Footnote-1397732 +Node: I/O And BEGIN/END397838 +Node: BEGINFILE/ENDFILE400152 +Node: Empty403053 +Node: Using Shell Variables403370 +Node: Action Overview405643 +Node: Statements407969 +Node: If Statement409817 +Node: While Statement411312 +Node: Do Statement413341 +Node: For Statement414485 +Node: Switch Statement417642 +Node: Break Statement420024 +Node: Continue Statement422065 +Node: Next Statement423892 +Node: Nextfile Statement426273 +Node: Exit Statement428903 +Node: Built-in Variables431306 +Node: User-modified432439 +Ref: User-modified-Footnote-1440120 +Node: Auto-set440182 +Ref: Auto-set-Footnote-1453217 +Ref: Auto-set-Footnote-2453422 +Node: ARGC and ARGV453478 +Node: Pattern Action Summary457696 +Node: Arrays460123 +Node: Array Basics461452 +Node: Array Intro462296 +Ref: figure-array-elements464260 +Ref: Array Intro-Footnote-1466786 +Node: Reference to Elements466914 +Node: Assigning Elements469366 +Node: Array Example469857 +Node: Scanning an Array471615 +Node: Controlling Scanning474631 +Ref: Controlling Scanning-Footnote-1479827 +Node: Numeric Array Subscripts480143 +Node: Uninitialized Subscripts482328 +Node: Delete483945 +Ref: Delete-Footnote-1486688 +Node: Multidimensional486745 +Node: Multiscanning489842 +Node: Arrays of Arrays491431 +Node: Arrays Summary496190 +Node: Functions498282 +Node: Built-in499155 +Node: Calling Built-in500233 +Node: Numeric Functions502224 +Ref: Numeric Functions-Footnote-1506241 +Ref: Numeric Functions-Footnote-2506598 +Ref: Numeric Functions-Footnote-3506646 +Node: String Functions506918 +Ref: String Functions-Footnote-1530393 +Ref: String Functions-Footnote-2530522 +Ref: String Functions-Footnote-3530770 +Node: Gory Details530857 +Ref: table-sub-escapes532638 +Ref: table-sub-proposed534158 +Ref: table-posix-sub535522 +Ref: table-gensub-escapes537058 +Ref: Gory Details-Footnote-1537890 +Node: I/O Functions538041 +Ref: I/O Functions-Footnote-1545259 +Node: Time Functions545406 +Ref: Time Functions-Footnote-1555894 +Ref: Time Functions-Footnote-2555962 +Ref: Time Functions-Footnote-3556120 +Ref: Time Functions-Footnote-4556231 +Ref: Time Functions-Footnote-5556343 +Ref: Time Functions-Footnote-6556570 +Node: Bitwise Functions556836 +Ref: table-bitwise-ops557398 +Ref: Bitwise Functions-Footnote-1561707 +Node: Type Functions561876 +Node: I18N Functions563027 +Node: User-defined564672 +Node: Definition Syntax565477 +Ref: Definition Syntax-Footnote-1570884 +Node: Function Example570955 +Ref: Function Example-Footnote-1573874 +Node: Function Caveats573896 +Node: Calling A Function574414 +Node: Variable Scope575372 +Node: Pass By Value/Reference578360 +Node: Return Statement581855 +Node: Dynamic Typing584836 +Node: Indirect Calls585765 +Ref: Indirect Calls-Footnote-1597067 +Node: Functions Summary597195 +Node: Library Functions599897 +Ref: Library Functions-Footnote-1603506 +Ref: Library Functions-Footnote-2603649 +Node: Library Names603820 +Ref: Library Names-Footnote-1607274 +Ref: Library Names-Footnote-2607497 +Node: General Functions607583 +Node: Strtonum Function608686 +Node: Assert Function611708 +Node: Round Function615032 +Node: Cliff Random Function616573 +Node: Ordinal Functions617589 +Ref: Ordinal Functions-Footnote-1620652 +Ref: Ordinal Functions-Footnote-2620904 +Node: Join Function621115 +Ref: Join Function-Footnote-1622884 +Node: Getlocaltime Function623084 +Node: Readfile Function626828 +Node: Shell Quoting628798 +Node: Data File Management630199 +Node: Filetrans Function630831 +Node: Rewind Function634887 +Node: File Checking636274 +Ref: File Checking-Footnote-1637606 +Node: Empty Files637807 +Node: Ignoring Assigns639786 +Node: Getopt Function641337 +Ref: Getopt Function-Footnote-1652799 +Node: Passwd Functions652999 +Ref: Passwd Functions-Footnote-1661836 +Node: Group Functions661924 +Ref: Group Functions-Footnote-1669818 +Node: Walking Arrays670031 +Node: Library Functions Summary671634 +Node: Library Exercises673035 +Node: Sample Programs674315 +Node: Running Examples675085 +Node: Clones675813 +Node: Cut Program677037 +Node: Egrep Program686756 +Ref: Egrep Program-Footnote-1694254 +Node: Id Program694364 +Node: Split Program698009 +Ref: Split Program-Footnote-1701457 +Node: Tee Program701585 +Node: Uniq Program704374 +Node: Wc Program711793 +Ref: Wc Program-Footnote-1716043 +Node: Miscellaneous Programs716137 +Node: Dupword Program717350 +Node: Alarm Program719381 +Node: Translate Program724185 +Ref: Translate Program-Footnote-1728750 +Node: Labels Program729020 +Ref: Labels Program-Footnote-1732371 +Node: Word Sorting732455 +Node: History Sorting736526 +Node: Extract Program738362 +Node: Simple Sed745887 +Node: Igawk Program748955 +Ref: Igawk Program-Footnote-1763279 +Ref: Igawk Program-Footnote-2763480 +Ref: Igawk Program-Footnote-3763602 +Node: Anagram Program763717 +Node: Signature Program766774 +Node: Programs Summary768021 +Node: Programs Exercises769214 +Ref: Programs Exercises-Footnote-1773345 +Node: Advanced Features773436 +Node: Nondecimal Data775384 +Node: Array Sorting776974 +Node: Controlling Array Traversal777671 +Ref: Controlling Array Traversal-Footnote-1786004 +Node: Array Sorting Functions786122 +Ref: Array Sorting Functions-Footnote-1790011 +Node: Two-way I/O790207 +Ref: Two-way I/O-Footnote-1795148 +Ref: Two-way I/O-Footnote-2795334 +Node: TCP/IP Networking795416 +Node: Profiling798289 +Node: Advanced Features Summary805836 +Node: Internationalization807769 +Node: I18N and L10N809249 +Node: Explaining gettext809935 +Ref: Explaining gettext-Footnote-1814960 +Ref: Explaining gettext-Footnote-2815144 +Node: Programmer i18n815309 +Ref: Programmer i18n-Footnote-1820175 +Node: Translator i18n820224 +Node: String Extraction821018 +Ref: String Extraction-Footnote-1822149 +Node: Printf Ordering822235 +Ref: Printf Ordering-Footnote-1825021 +Node: I18N Portability825085 +Ref: I18N Portability-Footnote-1827540 +Node: I18N Example827603 +Ref: I18N Example-Footnote-1830406 +Node: Gawk I18N830478 +Node: I18N Summary831116 +Node: Debugger832455 +Node: Debugging833477 +Node: Debugging Concepts833918 +Node: Debugging Terms835771 +Node: Awk Debugging838343 +Node: Sample Debugging Session839237 +Node: Debugger Invocation839757 +Node: Finding The Bug841141 +Node: List of Debugger Commands847616 +Node: Breakpoint Control848949 +Node: Debugger Execution Control852645 +Node: Viewing And Changing Data856009 +Node: Execution Stack859387 +Node: Debugger Info861024 +Node: Miscellaneous Debugger Commands865041 +Node: Readline Support870070 +Node: Limitations870962 +Node: Debugging Summary873076 +Node: Arbitrary Precision Arithmetic874244 +Node: Computer Arithmetic875660 +Ref: table-numeric-ranges879258 +Ref: Computer Arithmetic-Footnote-1880117 +Node: Math Definitions880174 +Ref: table-ieee-formats883462 +Ref: Math Definitions-Footnote-1884066 +Node: MPFR features884171 +Node: FP Math Caution885842 +Ref: FP Math Caution-Footnote-1886892 +Node: Inexactness of computations887261 +Node: Inexact representation888220 +Node: Comparing FP Values889577 +Node: Errors accumulate890659 +Node: Getting Accuracy892092 +Node: Try To Round894754 +Node: Setting precision895653 +Ref: table-predefined-precision-strings896337 +Node: Setting the rounding mode898126 +Ref: table-gawk-rounding-modes898490 +Ref: Setting the rounding mode-Footnote-1901945 +Node: Arbitrary Precision Integers902124 +Ref: Arbitrary Precision Integers-Footnote-1905110 +Node: POSIX Floating Point Problems905259 +Ref: POSIX Floating Point Problems-Footnote-1909132 +Node: Floating point summary909170 +Node: Dynamic Extensions911364 +Node: Extension Intro912916 +Node: Plugin License914182 +Node: Extension Mechanism Outline914979 +Ref: figure-load-extension915407 +Ref: figure-register-new-function916887 +Ref: figure-call-new-function917891 +Node: Extension API Description919877 +Node: Extension API Functions Introduction921327 +Node: General Data Types926151 +Ref: General Data Types-Footnote-1931890 +Node: Memory Allocation Functions932189 +Ref: Memory Allocation Functions-Footnote-1935028 +Node: Constructor Functions935124 +Node: Registration Functions936858 +Node: Extension Functions937543 +Node: Exit Callback Functions939840 +Node: Extension Version String941088 +Node: Input Parsers941753 +Node: Output Wrappers951630 +Node: Two-way processors956145 +Node: Printing Messages958349 +Ref: Printing Messages-Footnote-1959425 +Node: Updating `ERRNO'959577 +Node: Requesting Values960317 +Ref: table-value-types-returned961045 +Node: Accessing Parameters962002 +Node: Symbol Table Access963233 +Node: Symbol table by name963747 +Node: Symbol table by cookie965728 +Ref: Symbol table by cookie-Footnote-1969872 +Node: Cached values969935 +Ref: Cached values-Footnote-1973434 +Node: Array Manipulation973525 +Ref: Array Manipulation-Footnote-1974623 +Node: Array Data Types974660 +Ref: Array Data Types-Footnote-1977315 +Node: Array Functions977407 +Node: Flattening Arrays981261 +Node: Creating Arrays988153 +Node: Extension API Variables992922 +Node: Extension Versioning993558 +Node: Extension API Informational Variables995459 +Node: Extension API Boilerplate996547 +Node: Finding Extensions1000356 +Node: Extension Example1000916 +Node: Internal File Description1001688 +Node: Internal File Ops1005755 +Ref: Internal File Ops-Footnote-11017425 +Node: Using Internal File Ops1017565 +Ref: Using Internal File Ops-Footnote-11019948 +Node: Extension Samples1020221 +Node: Extension Sample File Functions1021747 +Node: Extension Sample Fnmatch1029385 +Node: Extension Sample Fork1030876 +Node: Extension Sample Inplace1032091 +Node: Extension Sample Ord1033766 +Node: Extension Sample Readdir1034602 +Ref: table-readdir-file-types1035478 +Node: Extension Sample Revout1036289 +Node: Extension Sample Rev2way1036879 +Node: Extension Sample Read write array1037619 +Node: Extension Sample Readfile1039559 +Node: Extension Sample Time1040654 +Node: Extension Sample API Tests1042003 +Node: gawkextlib1042494 +Node: Extension summary1045152 +Node: Extension Exercises1048829 +Node: Language History1049551 +Node: V7/SVR3.11051207 +Node: SVR41053388 +Node: POSIX1054833 +Node: BTL1056222 +Node: POSIX/GNU1056956 +Node: Feature History1062520 +Node: Common Extensions1075618 +Node: Ranges and Locales1076942 +Ref: Ranges and Locales-Footnote-11081560 +Ref: Ranges and Locales-Footnote-21081587 +Ref: Ranges and Locales-Footnote-31081821 +Node: Contributors1082042 +Node: History summary1087583 +Node: Installation1088953 +Node: Gawk Distribution1089899 +Node: Getting1090383 +Node: Extracting1091206 +Node: Distribution contents1092841 +Node: Unix Installation1098558 +Node: Quick Installation1099175 +Node: Additional Configuration Options1101599 +Node: Configuration Philosophy1103337 +Node: Non-Unix Installation1105706 +Node: PC Installation1106164 +Node: PC Binary Installation1107483 +Node: PC Compiling1109331 +Ref: PC Compiling-Footnote-11112352 +Node: PC Testing1112461 +Node: PC Using1113637 +Node: Cygwin1117752 +Node: MSYS1118575 +Node: VMS Installation1119075 +Node: VMS Compilation1119867 +Ref: VMS Compilation-Footnote-11121089 +Node: VMS Dynamic Extensions1121147 +Node: VMS Installation Details1122831 +Node: VMS Running1125083 +Node: VMS GNV1127919 +Node: VMS Old Gawk1128653 +Node: Bugs1129123 +Node: Other Versions1133006 +Node: Installation summary1139428 +Node: Notes1140484 +Node: Compatibility Mode1141349 +Node: Additions1142131 +Node: Accessing The Source1143056 +Node: Adding Code1144492 +Node: New Ports1150657 +Node: Derived Files1155139 +Ref: Derived Files-Footnote-11160614 +Ref: Derived Files-Footnote-21160648 +Ref: Derived Files-Footnote-31161244 +Node: Future Extensions1161358 +Node: Implementation Limitations1161964 +Node: Extension Design1163212 +Node: Old Extension Problems1164366 +Ref: Old Extension Problems-Footnote-11165883 +Node: Extension New Mechanism Goals1165940 +Ref: Extension New Mechanism Goals-Footnote-11169300 +Node: Extension Other Design Decisions1169489 +Node: Extension Future Growth1171597 +Node: Old Extension Mechanism1172433 +Node: Notes summary1174195 +Node: Basic Concepts1175381 +Node: Basic High Level1176062 +Ref: figure-general-flow1176334 +Ref: figure-process-flow1176933 +Ref: Basic High Level-Footnote-11180162 +Node: Basic Data Typing1180347 +Node: Glossary1183675 +Node: Copying1208833 +Node: GNU Free Documentation License1246389 +Node: Index1271525 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 66174009..42196498 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -3932,7 +3932,13 @@ Command-line variable assignments of the form This option is particularly necessary for World Wide Web CGI applications that pass arguments through the URL; using this option prevents a malicious (or other) user from passing in options, assignments, or @command{awk} source -code (via @option{-e}) to the CGI application. This option should be used +code (via @option{-e}) to the CGI application.@footnote{For more detail, +please see Section 4.4 of @uref{http://www.ietf.org/rfc/rfc3875, +RFC 3875}. Also see the +@uref{http://lists.gnu.org/archive/html/bug-gawk/2014-11/msg00022.html, +explanatory note sent to the @command{gawk} bug +mailing list}.} +This option should be used with @samp{#!} scripts (@pxref{Executable Scripts}), like so: @example diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 0f07e210..61e41804 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -3843,7 +3843,13 @@ Command-line variable assignments of the form This option is particularly necessary for World Wide Web CGI applications that pass arguments through the URL; using this option prevents a malicious (or other) user from passing in options, assignments, or @command{awk} source -code (via @option{-e}) to the CGI application. This option should be used +code (via @option{-e}) to the CGI application.@footnote{For more detail, +please see Section 4.4 of @uref{http://www.ietf.org/rfc/rfc3875, +RFC 3875}. Also see the +@uref{http://lists.gnu.org/archive/html/bug-gawk/2014-11/msg00022.html, +explanatory note sent to the @command{gawk} bug +mailing list}.} +This option should be used with @samp{#!} scripts (@pxref{Executable Scripts}), like so: @example |