diff options
author | Arnold D. Robbins <arnold@skeeve.com> | 2020-10-16 14:49:09 +0300 |
---|---|---|
committer | Arnold D. Robbins <arnold@skeeve.com> | 2020-10-16 14:49:09 +0300 |
commit | 09a0ee18baaa8fa83f9f94f783a801f6f436d2fd (patch) | |
tree | c3462ec9b7e7408f8ef355b697223d05bab533d8 | |
parent | 2ef955ea81a33af366f17f63b4ce85451b1a73b9 (diff) | |
parent | 901fdb886eff28fd603c6e18e25df39d2f6a4c91 (diff) | |
download | egawk-09a0ee18baaa8fa83f9f94f783a801f6f436d2fd.tar.gz egawk-09a0ee18baaa8fa83f9f94f783a801f6f436d2fd.tar.bz2 egawk-09a0ee18baaa8fa83f9f94f783a801f6f436d2fd.zip |
Merge branch 'master' into feature/docit
-rw-r--r-- | doc/ChangeLog | 9 | ||||
-rw-r--r-- | doc/gawk.info | 1110 | ||||
-rw-r--r-- | doc/gawk.texi | 10 | ||||
-rw-r--r-- | doc/gawktexi.in | 10 |
4 files changed, 574 insertions, 565 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index ae060c00..92ba1581 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,11 +1,16 @@ +2020-10-16 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in: After review, remove/update some FIXMEs, and + and fix a markup error. + 2020-10-15 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Add an index entry. 2020-10-12 Arnold D. Robbins <arnold@skeeve.com> - * gawktexi.in: Explain `ls -l' earlier in the and small wording - improvement in explanation of options. Thanks to Yehezkel Bernat + * gawktexi.in: Explain `ls -l' earlier in the book, and small wording + improvement in explanation of options. Thanks to Yehezkel Bernat. <yehezkelshb@gmail.com> for the comments. 2020-10-11 Arnold D. Robbins <arnold@skeeve.com> diff --git a/doc/gawk.info b/doc/gawk.info index 78db2d95..fd8f2038 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -2919,8 +2919,8 @@ Any additional arguments on the command line are normally treated as input files to be processed in the order specified. However, an argument that has the form 'VAR=VALUE', assigns the value VALUE to the variable VAR--it does not specify a file at all. (See *note Assignment -Options::.) In the following example, COUNT=1 is a variable assignment, -not a file name: +Options::.) In the following example, 'count=1' is a variable +assignment, not a file name: awk -f program.awk file1 count=1 file2 @@ -37948,559 +37948,559 @@ Node: Options120292 Ref: Options-Footnote-1138206 Ref: Options-Footnote-2138437 Node: Other Arguments138462 -Node: Naming Standard Input141769 -Node: Environment Variables142979 -Node: AWKPATH Variable143537 -Ref: AWKPATH Variable-Footnote-1146949 -Ref: AWKPATH Variable-Footnote-2146983 -Node: AWKLIBPATH Variable147354 -Ref: AWKLIBPATH Variable-Footnote-1149051 -Node: Other Environment Variables149426 -Node: Exit Status153247 -Node: Include Files153924 -Node: Loading Shared Libraries157614 -Node: Obsolete159042 -Node: Undocumented159734 -Node: Invoking Summary160031 -Node: Regexp162872 -Node: Regexp Usage164326 -Node: Escape Sequences166363 -Node: Regexp Operators172604 -Node: Regexp Operator Details173089 -Ref: Regexp Operator Details-Footnote-1179521 -Node: Interval Expressions179668 -Ref: Interval Expressions-Footnote-1181089 -Node: Bracket Expressions181187 -Ref: table-char-classes183663 -Node: Leftmost Longest186989 -Node: Computed Regexps188292 -Node: GNU Regexp Operators191719 -Node: Case-sensitivity195456 -Ref: Case-sensitivity-Footnote-1198322 -Ref: Case-sensitivity-Footnote-2198557 -Node: Regexp Summary198665 -Node: Reading Files200131 -Node: Records202400 -Node: awk split records203475 -Node: gawk split records208750 -Ref: gawk split records-Footnote-1213483 -Node: Fields213520 -Node: Nonconstant Fields216261 -Ref: Nonconstant Fields-Footnote-1218497 -Node: Changing Fields218701 -Node: Field Separators224732 -Node: Default Field Splitting227430 -Node: Regexp Field Splitting228548 -Node: Single Character Fields231901 -Node: Command Line Field Separator232961 -Node: Full Line Fields236179 -Ref: Full Line Fields-Footnote-1237701 -Ref: Full Line Fields-Footnote-2237747 -Node: Field Splitting Summary237848 -Node: Constant Size239922 -Node: Fixed width data240654 -Node: Skipping intervening244121 -Node: Allowing trailing data244919 -Node: Fields with fixed data245956 -Node: Splitting By Content247474 -Ref: Splitting By Content-Footnote-1251257 -Node: More CSV251420 -Node: Testing field creation252730 -Node: Multiple Line254355 -Node: Getline260632 -Node: Plain Getline263101 -Node: Getline/Variable265674 -Node: Getline/File266825 -Node: Getline/Variable/File268213 -Ref: Getline/Variable/File-Footnote-1269818 -Node: Getline/Pipe269906 -Node: Getline/Variable/Pipe272610 -Node: Getline/Coprocess273745 -Node: Getline/Variable/Coprocess275012 -Node: Getline Notes275754 -Node: Getline Summary278551 -Ref: table-getline-variants278975 -Node: Read Timeout279723 -Ref: Read Timeout-Footnote-1283629 -Node: Retrying Input283687 -Node: Command-line directories284886 -Node: Input Summary285792 -Node: Input Exercises288964 -Node: Printing289398 -Node: Print291232 -Node: Print Examples292689 -Node: Output Separators295469 -Node: OFMT297486 -Node: Printf298842 -Node: Basic Printf299627 -Node: Control Letters301201 -Node: Format Modifiers306365 -Node: Printf Examples312380 -Node: Redirection314866 -Node: Special FD321707 -Ref: Special FD-Footnote-1324875 -Node: Special Files324949 -Node: Other Inherited Files325566 -Node: Special Network326567 -Node: Special Caveats327427 -Node: Close Files And Pipes328376 -Ref: table-close-pipe-return-values335283 -Ref: Close Files And Pipes-Footnote-1336096 -Ref: Close Files And Pipes-Footnote-2336244 -Node: Nonfatal336396 -Node: Output Summary338734 -Node: Output Exercises339956 -Node: Expressions340635 -Node: Values341823 -Node: Constants342501 -Node: Scalar Constants343192 -Ref: Scalar Constants-Footnote-1345702 -Node: Nondecimal-numbers345952 -Node: Regexp Constants348953 -Node: Using Constant Regexps349479 -Node: Standard Regexp Constants350101 -Node: Strong Regexp Constants353289 -Node: Variables356301 -Node: Using Variables356958 -Node: Assignment Options358868 -Node: Conversion361339 -Node: Strings And Numbers361863 -Ref: Strings And Numbers-Footnote-1364926 -Node: Locale influences conversions365035 -Ref: table-locale-affects367793 -Node: All Operators368411 -Node: Arithmetic Ops369040 -Node: Concatenation371756 -Ref: Concatenation-Footnote-1374603 -Node: Assignment Ops374710 -Ref: table-assign-ops379701 -Node: Increment Ops381014 -Node: Truth Values and Conditions384474 -Node: Truth Values385548 -Node: Typing and Comparison386596 -Node: Variable Typing387416 -Ref: Variable Typing-Footnote-1393879 -Ref: Variable Typing-Footnote-2393951 -Node: Comparison Operators394028 -Ref: table-relational-ops394447 -Node: POSIX String Comparison397942 -Ref: POSIX String Comparison-Footnote-1399637 -Ref: POSIX String Comparison-Footnote-2399776 -Node: Boolean Ops399860 -Ref: Boolean Ops-Footnote-1404342 -Node: Conditional Exp404434 -Node: Function Calls406170 -Node: Precedence410047 -Node: Locales413706 -Node: Expressions Summary415338 -Node: Patterns and Actions417911 -Node: Pattern Overview419031 -Node: Regexp Patterns420708 -Node: Expression Patterns421250 -Node: Ranges425031 -Node: BEGIN/END428139 -Node: Using BEGIN/END428900 -Ref: Using BEGIN/END-Footnote-1431654 -Node: I/O And BEGIN/END431760 -Node: BEGINFILE/ENDFILE434073 -Node: Empty437304 -Node: Using Shell Variables437621 -Node: Action Overview439895 -Node: Statements442220 -Node: If Statement444068 -Node: While Statement445563 -Node: Do Statement447591 -Node: For Statement448739 -Node: Switch Statement451910 -Node: Break Statement454351 -Node: Continue Statement456443 -Node: Next Statement458270 -Node: Nextfile Statement460653 -Node: Exit Statement463305 -Node: Built-in Variables465708 -Node: User-modified466841 -Node: Auto-set474608 -Ref: Auto-set-Footnote-1491415 -Ref: Auto-set-Footnote-2491621 -Node: ARGC and ARGV491677 -Node: Pattern Action Summary495890 -Node: Arrays498320 -Node: Array Basics499649 -Node: Array Intro500493 -Ref: figure-array-elements502468 -Ref: Array Intro-Footnote-1505172 -Node: Reference to Elements505300 -Node: Assigning Elements507764 -Node: Array Example508255 -Node: Scanning an Array510014 -Node: Controlling Scanning513036 -Ref: Controlling Scanning-Footnote-1519492 -Node: Numeric Array Subscripts519808 -Node: Uninitialized Subscripts521992 -Node: Delete523611 -Ref: Delete-Footnote-1526363 -Node: Multidimensional526420 -Node: Multiscanning529515 -Node: Arrays of Arrays531106 -Node: Arrays Summary535874 -Node: Functions537967 -Node: Built-in539005 -Node: Calling Built-in540086 -Node: Numeric Functions542082 -Ref: Numeric Functions-Footnote-1546110 -Ref: Numeric Functions-Footnote-2546758 -Ref: Numeric Functions-Footnote-3546806 -Node: String Functions547078 -Ref: String Functions-Footnote-1571219 -Ref: String Functions-Footnote-2571347 -Ref: String Functions-Footnote-3571595 -Node: Gory Details571682 -Ref: table-sub-escapes573473 -Ref: table-sub-proposed574992 -Ref: table-posix-sub576355 -Ref: table-gensub-escapes577896 -Ref: Gory Details-Footnote-1578719 -Node: I/O Functions578873 -Ref: table-system-return-values585327 -Ref: I/O Functions-Footnote-1587407 -Ref: I/O Functions-Footnote-2587555 -Node: Time Functions587675 -Ref: Time Functions-Footnote-1598346 -Ref: Time Functions-Footnote-2598414 -Ref: Time Functions-Footnote-3598572 -Ref: Time Functions-Footnote-4598683 -Ref: Time Functions-Footnote-5598795 -Ref: Time Functions-Footnote-6599022 -Node: Bitwise Functions599288 -Ref: table-bitwise-ops599882 -Ref: Bitwise Functions-Footnote-1605945 -Ref: Bitwise Functions-Footnote-2606118 -Node: Type Functions606309 -Node: I18N Functions609172 -Node: User-defined610823 -Node: Definition Syntax611635 -Ref: Definition Syntax-Footnote-1617329 -Node: Function Example617400 -Ref: Function Example-Footnote-1620322 -Node: Function Calling620344 -Node: Calling A Function620932 -Node: Variable Scope621890 -Node: Pass By Value/Reference624884 -Node: Function Caveats627528 -Ref: Function Caveats-Footnote-1629575 -Node: Return Statement629695 -Node: Dynamic Typing632674 -Node: Indirect Calls633604 -Ref: Indirect Calls-Footnote-1643856 -Node: Functions Summary643984 -Node: Library Functions646689 -Ref: Library Functions-Footnote-1650296 -Ref: Library Functions-Footnote-2650439 -Node: Library Names650610 -Ref: Library Names-Footnote-1654277 -Ref: Library Names-Footnote-2654500 -Node: General Functions654586 -Node: Strtonum Function655689 -Node: Assert Function658711 -Node: Round Function662037 -Node: Cliff Random Function663577 -Node: Ordinal Functions664593 -Ref: Ordinal Functions-Footnote-1667656 -Ref: Ordinal Functions-Footnote-2667908 -Node: Join Function668118 -Ref: Join Function-Footnote-1669888 -Node: Getlocaltime Function670088 -Node: Readfile Function673830 -Node: Shell Quoting675807 -Node: Data File Management677208 -Node: Filetrans Function677840 -Node: Rewind Function681936 -Node: File Checking683845 -Ref: File Checking-Footnote-1685179 -Node: Empty Files685380 -Node: Ignoring Assigns687359 -Node: Getopt Function688909 -Ref: Getopt Function-Footnote-1704120 -Node: Passwd Functions704320 -Ref: Passwd Functions-Footnote-1713159 -Node: Group Functions713247 -Ref: Group Functions-Footnote-1721145 -Node: Walking Arrays721352 -Node: Library Functions Summary724360 -Node: Library Exercises725766 -Node: Sample Programs726231 -Node: Running Examples727001 -Node: Clones727729 -Node: Cut Program728953 -Node: Egrep Program738882 -Node: Id Program747893 -Node: Split Program757840 -Ref: Split Program-Footnote-1767614 -Node: Tee Program767787 -Node: Uniq Program770577 -Node: Wc Program778141 -Node: Bytes vs. Characters778538 -Node: Using extensions780086 -Node: wc program780844 -Node: Miscellaneous Programs785709 -Node: Dupword Program786922 -Node: Alarm Program788952 -Node: Translate Program793807 -Ref: Translate Program-Footnote-1798372 -Node: Labels Program798642 -Ref: Labels Program-Footnote-1801993 -Node: Word Sorting802077 -Node: History Sorting806149 -Node: Extract Program808374 -Node: Simple Sed816428 -Node: Igawk Program819502 -Ref: Igawk Program-Footnote-1833833 -Ref: Igawk Program-Footnote-2834035 -Ref: Igawk Program-Footnote-3834157 -Node: Anagram Program834272 -Node: Signature Program837334 -Node: Programs Summary838581 -Node: Programs Exercises839795 -Ref: Programs Exercises-Footnote-1843925 -Node: Advanced Features844011 -Node: Nondecimal Data846001 -Node: Array Sorting847592 -Node: Controlling Array Traversal848292 -Ref: Controlling Array Traversal-Footnote-1856660 -Node: Array Sorting Functions856778 -Ref: Array Sorting Functions-Footnote-1861869 -Node: Two-way I/O862065 -Ref: Two-way I/O-Footnote-1869786 -Ref: Two-way I/O-Footnote-2869973 -Node: TCP/IP Networking870055 -Node: Profiling873173 -Node: Advanced Features Summary882487 -Node: Internationalization884331 -Node: I18N and L10N885811 -Node: Explaining gettext886498 -Ref: Explaining gettext-Footnote-1892390 -Ref: Explaining gettext-Footnote-2892575 -Node: Programmer i18n892740 -Ref: Programmer i18n-Footnote-1897689 -Node: Translator i18n897738 -Node: String Extraction898532 -Ref: String Extraction-Footnote-1899664 -Node: Printf Ordering899750 -Ref: Printf Ordering-Footnote-1902536 -Node: I18N Portability902600 -Ref: I18N Portability-Footnote-1905056 -Node: I18N Example905119 -Ref: I18N Example-Footnote-1908394 -Ref: I18N Example-Footnote-2908467 -Node: Gawk I18N908576 -Node: I18N Summary909225 -Node: Debugger910566 -Node: Debugging911566 -Node: Debugging Concepts912007 -Node: Debugging Terms913816 -Node: Awk Debugging916391 -Ref: Awk Debugging-Footnote-1917336 -Node: Sample Debugging Session917468 -Node: Debugger Invocation918002 -Node: Finding The Bug919388 -Node: List of Debugger Commands925862 -Node: Breakpoint Control927195 -Node: Debugger Execution Control930889 -Node: Viewing And Changing Data934251 -Node: Execution Stack937792 -Node: Debugger Info939429 -Node: Miscellaneous Debugger Commands943500 -Node: Readline Support948562 -Node: Limitations949458 -Node: Debugging Summary952012 -Node: Namespaces953291 -Node: Global Namespace954402 -Node: Qualified Names955800 -Node: Default Namespace956799 -Node: Changing The Namespace957540 -Node: Naming Rules959154 -Node: Internal Name Management961002 -Node: Namespace Example962044 -Node: Namespace And Features964606 -Node: Namespace Summary966041 -Node: Arbitrary Precision Arithmetic967518 -Node: Computer Arithmetic969005 -Ref: table-numeric-ranges972771 -Ref: table-floating-point-ranges973264 -Ref: Computer Arithmetic-Footnote-1973922 -Node: Math Definitions973979 -Ref: table-ieee-formats977295 -Ref: Math Definitions-Footnote-1977898 -Node: MPFR features978003 -Node: FP Math Caution979721 -Ref: FP Math Caution-Footnote-1980793 -Node: Inexactness of computations981162 -Node: Inexact representation982122 -Node: Comparing FP Values983482 -Node: Errors accumulate984723 -Node: Getting Accuracy986156 -Node: Try To Round988866 -Node: Setting precision989765 -Ref: table-predefined-precision-strings990462 -Node: Setting the rounding mode992292 -Ref: table-gawk-rounding-modes992666 -Ref: Setting the rounding mode-Footnote-1996597 -Node: Arbitrary Precision Integers996776 -Ref: Arbitrary Precision Integers-Footnote-1999951 -Node: Checking for MPFR1000100 -Node: POSIX Floating Point Problems1001574 -Ref: POSIX Floating Point Problems-Footnote-11005859 -Node: Floating point summary1005897 -Node: Dynamic Extensions1008087 -Node: Extension Intro1009640 -Node: Plugin License1010906 -Node: Extension Mechanism Outline1011703 -Ref: figure-load-extension1012142 -Ref: figure-register-new-function1013707 -Ref: figure-call-new-function1014799 -Node: Extension API Description1016861 -Node: Extension API Functions Introduction1018574 -Ref: table-api-std-headers1020410 -Node: General Data Types1024659 -Ref: General Data Types-Footnote-11033289 -Node: Memory Allocation Functions1033588 -Ref: Memory Allocation Functions-Footnote-11038089 -Node: Constructor Functions1038188 -Node: API Ownership of MPFR and GMP Values1041654 -Node: Registration Functions1042967 -Node: Extension Functions1043667 -Node: Exit Callback Functions1048989 -Node: Extension Version String1050239 -Node: Input Parsers1050902 -Node: Output Wrappers1063623 -Node: Two-way processors1068135 -Node: Printing Messages1070400 -Ref: Printing Messages-Footnote-11071571 -Node: Updating ERRNO1071724 -Node: Requesting Values1072463 -Ref: table-value-types-returned1073200 -Node: Accessing Parameters1074136 -Node: Symbol Table Access1075373 -Node: Symbol table by name1075885 -Ref: Symbol table by name-Footnote-11078909 -Node: Symbol table by cookie1079037 -Ref: Symbol table by cookie-Footnote-11083222 -Node: Cached values1083286 -Ref: Cached values-Footnote-11086822 -Node: Array Manipulation1086975 -Ref: Array Manipulation-Footnote-11088066 -Node: Array Data Types1088103 -Ref: Array Data Types-Footnote-11090761 -Node: Array Functions1090853 -Node: Flattening Arrays1095351 -Node: Creating Arrays1102327 -Node: Redirection API1107094 -Node: Extension API Variables1109927 -Node: Extension Versioning1110638 -Ref: gawk-api-version1111067 -Node: Extension GMP/MPFR Versioning1112798 -Node: Extension API Informational Variables1114426 -Node: Extension API Boilerplate1115499 -Node: Changes from API V11119473 -Node: Finding Extensions1121045 -Node: Extension Example1121604 -Node: Internal File Description1122402 -Node: Internal File Ops1126482 -Ref: Internal File Ops-Footnote-11137832 -Node: Using Internal File Ops1137972 -Ref: Using Internal File Ops-Footnote-11140355 -Node: Extension Samples1140629 -Node: Extension Sample File Functions1142158 -Node: Extension Sample Fnmatch1149807 -Node: Extension Sample Fork1151294 -Node: Extension Sample Inplace1152512 -Node: Extension Sample Ord1156138 -Node: Extension Sample Readdir1156974 -Ref: table-readdir-file-types1157863 -Node: Extension Sample Revout1158930 -Node: Extension Sample Rev2way1159519 -Node: Extension Sample Read write array1160259 -Node: Extension Sample Readfile1162201 -Node: Extension Sample Time1163296 -Node: Extension Sample API Tests1165048 -Node: gawkextlib1165540 -Node: Extension summary1168458 -Node: Extension Exercises1172160 -Node: Language History1173402 -Node: V7/SVR3.11175058 -Node: SVR41177210 -Node: POSIX1178644 -Node: BTL1180025 -Node: POSIX/GNU1180754 -Node: Feature History1186532 -Node: Common Extensions1202851 -Node: Ranges and Locales1204134 -Ref: Ranges and Locales-Footnote-11208750 -Ref: Ranges and Locales-Footnote-21208777 -Ref: Ranges and Locales-Footnote-31209012 -Node: Contributors1209235 -Node: History summary1215232 -Node: Installation1216612 -Node: Gawk Distribution1217556 -Node: Getting1218040 -Node: Extracting1219003 -Node: Distribution contents1220641 -Node: Unix Installation1227121 -Node: Quick Installation1227803 -Node: Shell Startup Files1230217 -Node: Additional Configuration Options1231306 -Node: Configuration Philosophy1233621 -Node: Non-Unix Installation1235990 -Node: PC Installation1236450 -Node: PC Binary Installation1237288 -Node: PC Compiling1237723 -Node: PC Using1238840 -Node: Cygwin1242393 -Node: MSYS1243617 -Node: VMS Installation1244219 -Node: VMS Compilation1245010 -Ref: VMS Compilation-Footnote-11246239 -Node: VMS Dynamic Extensions1246297 -Node: VMS Installation Details1247982 -Node: VMS Running1250235 -Node: VMS GNV1254514 -Node: VMS Old Gawk1255249 -Node: Bugs1255720 -Node: Bug address1256383 -Node: Usenet1259365 -Node: Maintainers1260369 -Node: Other Versions1261554 -Node: Installation summary1268642 -Node: Notes1269851 -Node: Compatibility Mode1270645 -Node: Additions1271427 -Node: Accessing The Source1272352 -Node: Adding Code1273789 -Node: New Ports1280008 -Node: Derived Files1284383 -Ref: Derived Files-Footnote-11290043 -Ref: Derived Files-Footnote-21290078 -Ref: Derived Files-Footnote-31290676 -Node: Future Extensions1290790 -Node: Implementation Limitations1291448 -Node: Extension Design1292658 -Node: Old Extension Problems1293802 -Ref: Old Extension Problems-Footnote-11295320 -Node: Extension New Mechanism Goals1295377 -Ref: Extension New Mechanism Goals-Footnote-11298741 -Node: Extension Other Design Decisions1298930 -Node: Extension Future Growth1301043 -Node: Notes summary1301649 -Node: Basic Concepts1302807 -Node: Basic High Level1303488 -Ref: figure-general-flow1303770 -Ref: figure-process-flow1304455 -Ref: Basic High Level-Footnote-11307756 -Node: Basic Data Typing1307941 -Node: Glossary1311269 -Node: Copying1343154 -Node: GNU Free Documentation License1380697 -Node: Index1405817 +Node: Naming Standard Input141771 +Node: Environment Variables142981 +Node: AWKPATH Variable143539 +Ref: AWKPATH Variable-Footnote-1146951 +Ref: AWKPATH Variable-Footnote-2146985 +Node: AWKLIBPATH Variable147356 +Ref: AWKLIBPATH Variable-Footnote-1149053 +Node: Other Environment Variables149428 +Node: Exit Status153249 +Node: Include Files153926 +Node: Loading Shared Libraries157616 +Node: Obsolete159044 +Node: Undocumented159736 +Node: Invoking Summary160033 +Node: Regexp162874 +Node: Regexp Usage164328 +Node: Escape Sequences166365 +Node: Regexp Operators172606 +Node: Regexp Operator Details173091 +Ref: Regexp Operator Details-Footnote-1179523 +Node: Interval Expressions179670 +Ref: Interval Expressions-Footnote-1181091 +Node: Bracket Expressions181189 +Ref: table-char-classes183665 +Node: Leftmost Longest186991 +Node: Computed Regexps188294 +Node: GNU Regexp Operators191721 +Node: Case-sensitivity195458 +Ref: Case-sensitivity-Footnote-1198324 +Ref: Case-sensitivity-Footnote-2198559 +Node: Regexp Summary198667 +Node: Reading Files200133 +Node: Records202402 +Node: awk split records203477 +Node: gawk split records208752 +Ref: gawk split records-Footnote-1213485 +Node: Fields213522 +Node: Nonconstant Fields216263 +Ref: Nonconstant Fields-Footnote-1218499 +Node: Changing Fields218703 +Node: Field Separators224734 +Node: Default Field Splitting227432 +Node: Regexp Field Splitting228550 +Node: Single Character Fields231903 +Node: Command Line Field Separator232963 +Node: Full Line Fields236181 +Ref: Full Line Fields-Footnote-1237703 +Ref: Full Line Fields-Footnote-2237749 +Node: Field Splitting Summary237850 +Node: Constant Size239924 +Node: Fixed width data240656 +Node: Skipping intervening244123 +Node: Allowing trailing data244921 +Node: Fields with fixed data245958 +Node: Splitting By Content247476 +Ref: Splitting By Content-Footnote-1251259 +Node: More CSV251422 +Node: Testing field creation252732 +Node: Multiple Line254357 +Node: Getline260634 +Node: Plain Getline263103 +Node: Getline/Variable265676 +Node: Getline/File266827 +Node: Getline/Variable/File268215 +Ref: Getline/Variable/File-Footnote-1269820 +Node: Getline/Pipe269908 +Node: Getline/Variable/Pipe272612 +Node: Getline/Coprocess273747 +Node: Getline/Variable/Coprocess275014 +Node: Getline Notes275756 +Node: Getline Summary278553 +Ref: table-getline-variants278977 +Node: Read Timeout279725 +Ref: Read Timeout-Footnote-1283631 +Node: Retrying Input283689 +Node: Command-line directories284888 +Node: Input Summary285794 +Node: Input Exercises288966 +Node: Printing289400 +Node: Print291234 +Node: Print Examples292691 +Node: Output Separators295471 +Node: OFMT297488 +Node: Printf298844 +Node: Basic Printf299629 +Node: Control Letters301203 +Node: Format Modifiers306367 +Node: Printf Examples312382 +Node: Redirection314868 +Node: Special FD321709 +Ref: Special FD-Footnote-1324877 +Node: Special Files324951 +Node: Other Inherited Files325568 +Node: Special Network326569 +Node: Special Caveats327429 +Node: Close Files And Pipes328378 +Ref: table-close-pipe-return-values335285 +Ref: Close Files And Pipes-Footnote-1336098 +Ref: Close Files And Pipes-Footnote-2336246 +Node: Nonfatal336398 +Node: Output Summary338736 +Node: Output Exercises339958 +Node: Expressions340637 +Node: Values341825 +Node: Constants342503 +Node: Scalar Constants343194 +Ref: Scalar Constants-Footnote-1345704 +Node: Nondecimal-numbers345954 +Node: Regexp Constants348955 +Node: Using Constant Regexps349481 +Node: Standard Regexp Constants350103 +Node: Strong Regexp Constants353291 +Node: Variables356303 +Node: Using Variables356960 +Node: Assignment Options358870 +Node: Conversion361341 +Node: Strings And Numbers361865 +Ref: Strings And Numbers-Footnote-1364928 +Node: Locale influences conversions365037 +Ref: table-locale-affects367795 +Node: All Operators368413 +Node: Arithmetic Ops369042 +Node: Concatenation371758 +Ref: Concatenation-Footnote-1374605 +Node: Assignment Ops374712 +Ref: table-assign-ops379703 +Node: Increment Ops381016 +Node: Truth Values and Conditions384476 +Node: Truth Values385550 +Node: Typing and Comparison386598 +Node: Variable Typing387418 +Ref: Variable Typing-Footnote-1393881 +Ref: Variable Typing-Footnote-2393953 +Node: Comparison Operators394030 +Ref: table-relational-ops394449 +Node: POSIX String Comparison397944 +Ref: POSIX String Comparison-Footnote-1399639 +Ref: POSIX String Comparison-Footnote-2399778 +Node: Boolean Ops399862 +Ref: Boolean Ops-Footnote-1404344 +Node: Conditional Exp404436 +Node: Function Calls406172 +Node: Precedence410049 +Node: Locales413708 +Node: Expressions Summary415340 +Node: Patterns and Actions417913 +Node: Pattern Overview419033 +Node: Regexp Patterns420710 +Node: Expression Patterns421252 +Node: Ranges425033 +Node: BEGIN/END428141 +Node: Using BEGIN/END428902 +Ref: Using BEGIN/END-Footnote-1431656 +Node: I/O And BEGIN/END431762 +Node: BEGINFILE/ENDFILE434075 +Node: Empty437306 +Node: Using Shell Variables437623 +Node: Action Overview439897 +Node: Statements442222 +Node: If Statement444070 +Node: While Statement445565 +Node: Do Statement447593 +Node: For Statement448741 +Node: Switch Statement451912 +Node: Break Statement454353 +Node: Continue Statement456445 +Node: Next Statement458272 +Node: Nextfile Statement460655 +Node: Exit Statement463307 +Node: Built-in Variables465710 +Node: User-modified466843 +Node: Auto-set474610 +Ref: Auto-set-Footnote-1491417 +Ref: Auto-set-Footnote-2491623 +Node: ARGC and ARGV491679 +Node: Pattern Action Summary495892 +Node: Arrays498322 +Node: Array Basics499651 +Node: Array Intro500495 +Ref: figure-array-elements502470 +Ref: Array Intro-Footnote-1505174 +Node: Reference to Elements505302 +Node: Assigning Elements507766 +Node: Array Example508257 +Node: Scanning an Array510016 +Node: Controlling Scanning513038 +Ref: Controlling Scanning-Footnote-1519494 +Node: Numeric Array Subscripts519810 +Node: Uninitialized Subscripts521994 +Node: Delete523613 +Ref: Delete-Footnote-1526365 +Node: Multidimensional526422 +Node: Multiscanning529517 +Node: Arrays of Arrays531108 +Node: Arrays Summary535876 +Node: Functions537969 +Node: Built-in539007 +Node: Calling Built-in540088 +Node: Numeric Functions542084 +Ref: Numeric Functions-Footnote-1546112 +Ref: Numeric Functions-Footnote-2546760 +Ref: Numeric Functions-Footnote-3546808 +Node: String Functions547080 +Ref: String Functions-Footnote-1571221 +Ref: String Functions-Footnote-2571349 +Ref: String Functions-Footnote-3571597 +Node: Gory Details571684 +Ref: table-sub-escapes573475 +Ref: table-sub-proposed574994 +Ref: table-posix-sub576357 +Ref: table-gensub-escapes577898 +Ref: Gory Details-Footnote-1578721 +Node: I/O Functions578875 +Ref: table-system-return-values585329 +Ref: I/O Functions-Footnote-1587409 +Ref: I/O Functions-Footnote-2587557 +Node: Time Functions587677 +Ref: Time Functions-Footnote-1598348 +Ref: Time Functions-Footnote-2598416 +Ref: Time Functions-Footnote-3598574 +Ref: Time Functions-Footnote-4598685 +Ref: Time Functions-Footnote-5598797 +Ref: Time Functions-Footnote-6599024 +Node: Bitwise Functions599290 +Ref: table-bitwise-ops599884 +Ref: Bitwise Functions-Footnote-1605947 +Ref: Bitwise Functions-Footnote-2606120 +Node: Type Functions606311 +Node: I18N Functions609174 +Node: User-defined610825 +Node: Definition Syntax611637 +Ref: Definition Syntax-Footnote-1617331 +Node: Function Example617402 +Ref: Function Example-Footnote-1620324 +Node: Function Calling620346 +Node: Calling A Function620934 +Node: Variable Scope621892 +Node: Pass By Value/Reference624886 +Node: Function Caveats627530 +Ref: Function Caveats-Footnote-1629577 +Node: Return Statement629697 +Node: Dynamic Typing632676 +Node: Indirect Calls633606 +Ref: Indirect Calls-Footnote-1643858 +Node: Functions Summary643986 +Node: Library Functions646691 +Ref: Library Functions-Footnote-1650298 +Ref: Library Functions-Footnote-2650441 +Node: Library Names650612 +Ref: Library Names-Footnote-1654279 +Ref: Library Names-Footnote-2654502 +Node: General Functions654588 +Node: Strtonum Function655691 +Node: Assert Function658713 +Node: Round Function662039 +Node: Cliff Random Function663579 +Node: Ordinal Functions664595 +Ref: Ordinal Functions-Footnote-1667658 +Ref: Ordinal Functions-Footnote-2667910 +Node: Join Function668120 +Ref: Join Function-Footnote-1669890 +Node: Getlocaltime Function670090 +Node: Readfile Function673832 +Node: Shell Quoting675809 +Node: Data File Management677210 +Node: Filetrans Function677842 +Node: Rewind Function681938 +Node: File Checking683847 +Ref: File Checking-Footnote-1685181 +Node: Empty Files685382 +Node: Ignoring Assigns687361 +Node: Getopt Function688911 +Ref: Getopt Function-Footnote-1704122 +Node: Passwd Functions704322 +Ref: Passwd Functions-Footnote-1713161 +Node: Group Functions713249 +Ref: Group Functions-Footnote-1721147 +Node: Walking Arrays721354 +Node: Library Functions Summary724362 +Node: Library Exercises725768 +Node: Sample Programs726233 +Node: Running Examples727003 +Node: Clones727731 +Node: Cut Program728955 +Node: Egrep Program738884 +Node: Id Program747895 +Node: Split Program757842 +Ref: Split Program-Footnote-1767616 +Node: Tee Program767789 +Node: Uniq Program770579 +Node: Wc Program778143 +Node: Bytes vs. Characters778540 +Node: Using extensions780088 +Node: wc program780846 +Node: Miscellaneous Programs785711 +Node: Dupword Program786924 +Node: Alarm Program788954 +Node: Translate Program793809 +Ref: Translate Program-Footnote-1798374 +Node: Labels Program798644 +Ref: Labels Program-Footnote-1801995 +Node: Word Sorting802079 +Node: History Sorting806151 +Node: Extract Program808376 +Node: Simple Sed816430 +Node: Igawk Program819504 +Ref: Igawk Program-Footnote-1833835 +Ref: Igawk Program-Footnote-2834037 +Ref: Igawk Program-Footnote-3834159 +Node: Anagram Program834274 +Node: Signature Program837336 +Node: Programs Summary838583 +Node: Programs Exercises839797 +Ref: Programs Exercises-Footnote-1843927 +Node: Advanced Features844013 +Node: Nondecimal Data846003 +Node: Array Sorting847594 +Node: Controlling Array Traversal848294 +Ref: Controlling Array Traversal-Footnote-1856662 +Node: Array Sorting Functions856780 +Ref: Array Sorting Functions-Footnote-1861871 +Node: Two-way I/O862067 +Ref: Two-way I/O-Footnote-1869788 +Ref: Two-way I/O-Footnote-2869975 +Node: TCP/IP Networking870057 +Node: Profiling873175 +Node: Advanced Features Summary882489 +Node: Internationalization884333 +Node: I18N and L10N885813 +Node: Explaining gettext886500 +Ref: Explaining gettext-Footnote-1892392 +Ref: Explaining gettext-Footnote-2892577 +Node: Programmer i18n892742 +Ref: Programmer i18n-Footnote-1897691 +Node: Translator i18n897740 +Node: String Extraction898534 +Ref: String Extraction-Footnote-1899666 +Node: Printf Ordering899752 +Ref: Printf Ordering-Footnote-1902538 +Node: I18N Portability902602 +Ref: I18N Portability-Footnote-1905058 +Node: I18N Example905121 +Ref: I18N Example-Footnote-1908396 +Ref: I18N Example-Footnote-2908469 +Node: Gawk I18N908578 +Node: I18N Summary909227 +Node: Debugger910568 +Node: Debugging911568 +Node: Debugging Concepts912009 +Node: Debugging Terms913818 +Node: Awk Debugging916393 +Ref: Awk Debugging-Footnote-1917338 +Node: Sample Debugging Session917470 +Node: Debugger Invocation918004 +Node: Finding The Bug919390 +Node: List of Debugger Commands925864 +Node: Breakpoint Control927197 +Node: Debugger Execution Control930891 +Node: Viewing And Changing Data934253 +Node: Execution Stack937794 +Node: Debugger Info939431 +Node: Miscellaneous Debugger Commands943502 +Node: Readline Support948564 +Node: Limitations949460 +Node: Debugging Summary952014 +Node: Namespaces953293 +Node: Global Namespace954404 +Node: Qualified Names955802 +Node: Default Namespace956801 +Node: Changing The Namespace957542 +Node: Naming Rules959156 +Node: Internal Name Management961004 +Node: Namespace Example962046 +Node: Namespace And Features964608 +Node: Namespace Summary966043 +Node: Arbitrary Precision Arithmetic967520 +Node: Computer Arithmetic969007 +Ref: table-numeric-ranges972773 +Ref: table-floating-point-ranges973266 +Ref: Computer Arithmetic-Footnote-1973924 +Node: Math Definitions973981 +Ref: table-ieee-formats977297 +Ref: Math Definitions-Footnote-1977900 +Node: MPFR features978005 +Node: FP Math Caution979723 +Ref: FP Math Caution-Footnote-1980795 +Node: Inexactness of computations981164 +Node: Inexact representation982124 +Node: Comparing FP Values983484 +Node: Errors accumulate984725 +Node: Getting Accuracy986158 +Node: Try To Round988868 +Node: Setting precision989767 +Ref: table-predefined-precision-strings990464 +Node: Setting the rounding mode992294 +Ref: table-gawk-rounding-modes992668 +Ref: Setting the rounding mode-Footnote-1996599 +Node: Arbitrary Precision Integers996778 +Ref: Arbitrary Precision Integers-Footnote-1999953 +Node: Checking for MPFR1000102 +Node: POSIX Floating Point Problems1001576 +Ref: POSIX Floating Point Problems-Footnote-11005861 +Node: Floating point summary1005899 +Node: Dynamic Extensions1008089 +Node: Extension Intro1009642 +Node: Plugin License1010908 +Node: Extension Mechanism Outline1011705 +Ref: figure-load-extension1012144 +Ref: figure-register-new-function1013709 +Ref: figure-call-new-function1014801 +Node: Extension API Description1016863 +Node: Extension API Functions Introduction1018576 +Ref: table-api-std-headers1020412 +Node: General Data Types1024661 +Ref: General Data Types-Footnote-11033291 +Node: Memory Allocation Functions1033590 +Ref: Memory Allocation Functions-Footnote-11038091 +Node: Constructor Functions1038190 +Node: API Ownership of MPFR and GMP Values1041656 +Node: Registration Functions1042969 +Node: Extension Functions1043669 +Node: Exit Callback Functions1048991 +Node: Extension Version String1050241 +Node: Input Parsers1050904 +Node: Output Wrappers1063625 +Node: Two-way processors1068137 +Node: Printing Messages1070402 +Ref: Printing Messages-Footnote-11071573 +Node: Updating ERRNO1071726 +Node: Requesting Values1072465 +Ref: table-value-types-returned1073202 +Node: Accessing Parameters1074138 +Node: Symbol Table Access1075375 +Node: Symbol table by name1075887 +Ref: Symbol table by name-Footnote-11078911 +Node: Symbol table by cookie1079039 +Ref: Symbol table by cookie-Footnote-11083224 +Node: Cached values1083288 +Ref: Cached values-Footnote-11086824 +Node: Array Manipulation1086977 +Ref: Array Manipulation-Footnote-11088068 +Node: Array Data Types1088105 +Ref: Array Data Types-Footnote-11090763 +Node: Array Functions1090855 +Node: Flattening Arrays1095353 +Node: Creating Arrays1102329 +Node: Redirection API1107096 +Node: Extension API Variables1109929 +Node: Extension Versioning1110640 +Ref: gawk-api-version1111069 +Node: Extension GMP/MPFR Versioning1112800 +Node: Extension API Informational Variables1114428 +Node: Extension API Boilerplate1115501 +Node: Changes from API V11119475 +Node: Finding Extensions1121047 +Node: Extension Example1121606 +Node: Internal File Description1122404 +Node: Internal File Ops1126484 +Ref: Internal File Ops-Footnote-11137834 +Node: Using Internal File Ops1137974 +Ref: Using Internal File Ops-Footnote-11140357 +Node: Extension Samples1140631 +Node: Extension Sample File Functions1142160 +Node: Extension Sample Fnmatch1149809 +Node: Extension Sample Fork1151296 +Node: Extension Sample Inplace1152514 +Node: Extension Sample Ord1156140 +Node: Extension Sample Readdir1156976 +Ref: table-readdir-file-types1157865 +Node: Extension Sample Revout1158932 +Node: Extension Sample Rev2way1159521 +Node: Extension Sample Read write array1160261 +Node: Extension Sample Readfile1162203 +Node: Extension Sample Time1163298 +Node: Extension Sample API Tests1165050 +Node: gawkextlib1165542 +Node: Extension summary1168460 +Node: Extension Exercises1172162 +Node: Language History1173404 +Node: V7/SVR3.11175060 +Node: SVR41177212 +Node: POSIX1178646 +Node: BTL1180027 +Node: POSIX/GNU1180756 +Node: Feature History1186534 +Node: Common Extensions1202853 +Node: Ranges and Locales1204136 +Ref: Ranges and Locales-Footnote-11208752 +Ref: Ranges and Locales-Footnote-21208779 +Ref: Ranges and Locales-Footnote-31209014 +Node: Contributors1209237 +Node: History summary1215234 +Node: Installation1216614 +Node: Gawk Distribution1217558 +Node: Getting1218042 +Node: Extracting1219005 +Node: Distribution contents1220643 +Node: Unix Installation1227123 +Node: Quick Installation1227805 +Node: Shell Startup Files1230219 +Node: Additional Configuration Options1231308 +Node: Configuration Philosophy1233623 +Node: Non-Unix Installation1235992 +Node: PC Installation1236452 +Node: PC Binary Installation1237290 +Node: PC Compiling1237725 +Node: PC Using1238842 +Node: Cygwin1242395 +Node: MSYS1243619 +Node: VMS Installation1244221 +Node: VMS Compilation1245012 +Ref: VMS Compilation-Footnote-11246241 +Node: VMS Dynamic Extensions1246299 +Node: VMS Installation Details1247984 +Node: VMS Running1250237 +Node: VMS GNV1254516 +Node: VMS Old Gawk1255251 +Node: Bugs1255722 +Node: Bug address1256385 +Node: Usenet1259367 +Node: Maintainers1260371 +Node: Other Versions1261556 +Node: Installation summary1268644 +Node: Notes1269853 +Node: Compatibility Mode1270647 +Node: Additions1271429 +Node: Accessing The Source1272354 +Node: Adding Code1273791 +Node: New Ports1280010 +Node: Derived Files1284385 +Ref: Derived Files-Footnote-11290045 +Ref: Derived Files-Footnote-21290080 +Ref: Derived Files-Footnote-31290678 +Node: Future Extensions1290792 +Node: Implementation Limitations1291450 +Node: Extension Design1292660 +Node: Old Extension Problems1293804 +Ref: Old Extension Problems-Footnote-11295322 +Node: Extension New Mechanism Goals1295379 +Ref: Extension New Mechanism Goals-Footnote-11298743 +Node: Extension Other Design Decisions1298932 +Node: Extension Future Growth1301045 +Node: Notes summary1301651 +Node: Basic Concepts1302809 +Node: Basic High Level1303490 +Ref: figure-general-flow1303772 +Ref: figure-process-flow1304457 +Ref: Basic High Level-Footnote-11307758 +Node: Basic Data Typing1307943 +Node: Glossary1311271 +Node: Copying1343156 +Node: GNU Free Documentation License1380699 +Node: Index1405819 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 2a1dbd5f..0dc7a037 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -3713,7 +3713,6 @@ and Perl.} @node Intro Summary @section Summary -@c FIXME: Review this chapter for summary of builtin functions called. @itemize @value{BULLET} @item Programs in @command{awk} consist of @var{pattern}--@var{action} pairs. @@ -4453,7 +4452,7 @@ input files to be processed in the order specified. However, an argument that has the form @code{@var{var}=@var{value}}, assigns the value @var{value} to the variable @var{var}---it does not specify a file at all. (See @ref{Assignment Options}.) In the following example, -@var{count=1} is a variable assignment, not a @value{FN}: +@samp{count=1} is a variable assignment, not a @value{FN}: @example awk -f program.awk file1 count=1 file2 @@ -4483,7 +4482,6 @@ current element. (@command{gawk} makes the full command line, including program text and options, available in @code{PROCINFO["argv"]}; @pxref{Auto-set}.) -@c FIXME: One day, move the ARGC and ARGV node closer to here. Changing @code{ARGC} and @code{ARGV} in your @command{awk} program lets you control how @command{awk} processes the input files; this is described in more detail in @ref{ARGC and ARGV}. @@ -8335,10 +8333,14 @@ contain at least one character. A straightforward modification FPAT = "([^,]*)|(\"[^\"]+\")" @end example -@c FIXME: 4/2015 +@c 4/2015: @c Consider use of FPAT = "([^,]*)|(\"[^\"]*\")" @c (star in latter part of value) to allow quoted strings to be empty. @c Per email from Ed Morton <mortoneccc@comcast.net> +@c +@c WONTFIX: 10/2020 +@c This is too much work. FPAT and CSV files are very flakey and +@c fragile. Doing something like this is merely inviting trouble. As with @code{FS}, the @code{IGNORECASE} variable (@pxref{User-modified}) affects field splitting with @code{FPAT}. diff --git a/doc/gawktexi.in b/doc/gawktexi.in index f42d2ee7..b584181d 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -3623,7 +3623,6 @@ and Perl.} @node Intro Summary @section Summary -@c FIXME: Review this chapter for summary of builtin functions called. @itemize @value{BULLET} @item Programs in @command{awk} consist of @var{pattern}--@var{action} pairs. @@ -4363,7 +4362,7 @@ input files to be processed in the order specified. However, an argument that has the form @code{@var{var}=@var{value}}, assigns the value @var{value} to the variable @var{var}---it does not specify a file at all. (See @ref{Assignment Options}.) In the following example, -@var{count=1} is a variable assignment, not a @value{FN}: +@samp{count=1} is a variable assignment, not a @value{FN}: @example awk -f program.awk file1 count=1 file2 @@ -4393,7 +4392,6 @@ current element. (@command{gawk} makes the full command line, including program text and options, available in @code{PROCINFO["argv"]}; @pxref{Auto-set}.) -@c FIXME: One day, move the ARGC and ARGV node closer to here. Changing @code{ARGC} and @code{ARGV} in your @command{awk} program lets you control how @command{awk} processes the input files; this is described in more detail in @ref{ARGC and ARGV}. @@ -7932,10 +7930,14 @@ contain at least one character. A straightforward modification FPAT = "([^,]*)|(\"[^\"]+\")" @end example -@c FIXME: 4/2015 +@c 4/2015: @c Consider use of FPAT = "([^,]*)|(\"[^\"]*\")" @c (star in latter part of value) to allow quoted strings to be empty. @c Per email from Ed Morton <mortoneccc@comcast.net> +@c +@c WONTFIX: 10/2020 +@c This is too much work. FPAT and CSV files are very flakey and +@c fragile. Doing something like this is merely inviting trouble. As with @code{FS}, the @code{IGNORECASE} variable (@pxref{User-modified}) affects field splitting with @code{FPAT}. |