diff options
| -rw-r--r-- | doc/ChangeLog | 4 | ||||
| -rw-r--r-- | doc/gawk.info | 1063 | ||||
| -rw-r--r-- | doc/gawk.texi | 5 | ||||
| -rw-r--r-- | doc/gawktexi.in | 17 |
4 files changed, 562 insertions, 527 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 4dc782e1..1d4d9f9d 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2014-01-03 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in (Full Line Fields): New node. + 2013-12-26 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: More minor additions / fixes. diff --git a/doc/gawk.info b/doc/gawk.info index 358551af..95522fed 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -193,6 +193,7 @@ texts being (a) (see below), and with the Back-Cover Texts being (b) field. * Command Line Field Separator:: Setting `FS' from the command-line. +* Full Line Fields:: Making the full line be a single field. * Field Splitting Summary:: Some final points and a summary table. * Constant Size:: Reading constant width data. * Splitting By Content:: Defining Fields By Content @@ -4381,6 +4382,7 @@ File: gawk.info, Node: Field Separators, Next: Constant Size, Prev: Changing * Regexp Field Splitting:: Using regexps as the field separator. * Single Character Fields:: Making each character a separate field. * Command Line Field Separator:: Setting `FS' from the command-line. +* Full Line Fields:: Making the full line be a single field. * Field Splitting Summary:: Some final points and a summary table. The "field separator", which is either a single character or a @@ -4562,7 +4564,7 @@ Options::), if `FS' is the null string, then `gawk' also behaves this way. -File: gawk.info, Node: Command Line Field Separator, Next: Field Splitting Summary, Prev: Single Character Fields, Up: Field Separators +File: gawk.info, Node: Command Line Field Separator, Next: Full Line Fields, Prev: Single Character Fields, Up: Field Separators 4.5.4 Setting `FS' from the Command Line ---------------------------------------- @@ -4649,9 +4651,15 @@ the entries for users who have no password: awk -F: '$2 == ""' /etc/passwd -File: gawk.info, Node: Field Splitting Summary, Prev: Command Line Field Separator, Up: Field Separators +File: gawk.info, Node: Full Line Fields, Next: Field Splitting Summary, Prev: Command Line Field Separator, Up: Field Separators -4.5.5 Field-Splitting Summary +4.5.5 Making The Full Line Be A Single Field +-------------------------------------------- + + +File: gawk.info, Node: Field Splitting Summary, Prev: Full Line Fields, Up: Field Separators + +4.5.6 Field-Splitting Summary ----------------------------- It is important to remember that when you assign a string constant as @@ -29898,7 +29906,7 @@ Index * Beebe, Nelson: Acknowledgments. (line 60) * BEGIN pattern <1>: Profiling. (line 62) * BEGIN pattern <2>: BEGIN/END. (line 6) -* BEGIN pattern <3>: Field Separators. (line 44) +* BEGIN pattern <3>: Field Separators. (line 45) * BEGIN pattern: Records. (line 29) * BEGIN pattern, assert() user-defined function and: Assert Function. (line 83) @@ -30557,8 +30565,8 @@ Index * field operator $: Fields. (line 19) * field operators, dollar sign as: Fields. (line 19) * field separators <1>: User-modified. (line 56) -* field separators: Field Separators. (line 14) -* field separators, choice of: Field Separators. (line 50) +* field separators: Field Separators. (line 15) +* field separators, choice of: Field Separators. (line 51) * field separators, FIELDWIDTHS variable and: User-modified. (line 35) * field separators, FPAT variable and: User-modified. (line 45) * field separators, in multiline records: Multiple Line. (line 41) @@ -30569,7 +30577,7 @@ Index * field separators, POSIX and: Fields. (line 6) * field separators, regular expressions as <1>: Regexp Field Splitting. (line 6) -* field separators, regular expressions as: Field Separators. (line 50) +* field separators, regular expressions as: Field Separators. (line 51) * field separators, See Also OFS: Changing Fields. (line 64) * field separators, spaces as: Cut Program. (line 109) * fields <1>: Basic High Level. (line 73) @@ -30582,7 +30590,7 @@ Index * fields, number of: Fields. (line 33) * fields, numbers: Nonconstant Fields. (line 6) * fields, printing: Print Examples. (line 21) -* fields, separating: Field Separators. (line 14) +* fields, separating: Field Separators. (line 15) * fields, single-character: Single Character Fields. (line 6) * FIELDWIDTHS variable <1>: User-modified. (line 35) @@ -30691,12 +30699,12 @@ Index * Free Software Foundation (FSF): Manual History. (line 6) * FreeBSD: Glossary. (line 624) * FS variable <1>: User-modified. (line 56) -* FS variable: Field Separators. (line 14) +* FS variable: Field Separators. (line 15) * FS variable, --field-separator option and: Options. (line 21) * FS variable, as null string: Single Character Fields. (line 20) * FS variable, as TAB character: Options. (line 259) -* FS variable, changing value of: Field Separators. (line 34) +* FS variable, changing value of: Field Separators. (line 35) * FS variable, running awk programs and: Cut Program. (line 68) * FS variable, setting from command line: Command Line Field Separator. (line 6) @@ -31632,7 +31640,7 @@ Index * regexp constants, vs. string constants: Computed Regexps. (line 38) * regexp, See regular expressions: Regexp. (line 6) * regular expressions: Regexp. (line 6) -* regular expressions as field separators: Field Separators. (line 50) +* regular expressions as field separators: Field Separators. (line 51) * regular expressions, anchors in: Regexp Operators. (line 22) * regular expressions, as field separators: Regexp Field Splitting. (line 6) @@ -32002,7 +32010,7 @@ Index * troubleshooting, --non-decimal-data option: Options. (line 207) * troubleshooting, == operator: Comparison Operators. (line 37) -* troubleshooting, awk uses FS not IFS: Field Separators. (line 29) +* troubleshooting, awk uses FS not IFS: Field Separators. (line 30) * troubleshooting, backslash before nonspecial character: Escape Sequences. (line 112) * troubleshooting, division: Arithmetic Ops. (line 44) @@ -32197,520 +32205,521 @@ Index Tag Table: Node: Top1360 -Node: Foreword40460 -Node: Preface44805 -Ref: Preface-Footnote-147858 -Ref: Preface-Footnote-247954 -Node: History48186 -Node: Names50560 -Ref: Names-Footnote-152037 -Node: This Manual52109 -Ref: This Manual-Footnote-157883 -Node: Conventions57983 -Node: Manual History60139 -Ref: Manual History-Footnote-163587 -Ref: Manual History-Footnote-263628 -Node: How To Contribute63702 -Node: Acknowledgments64846 -Node: Getting Started69055 -Node: Running gawk71434 -Node: One-shot72620 -Node: Read Terminal73845 -Ref: Read Terminal-Footnote-175495 -Ref: Read Terminal-Footnote-275771 -Node: Long75942 -Node: Executable Scripts77318 -Ref: Executable Scripts-Footnote-179151 -Ref: Executable Scripts-Footnote-279253 -Node: Comments79800 -Node: Quoting82267 -Node: DOS Quoting86890 -Node: Sample Data Files87565 -Node: Very Simple90609 -Node: Two Rules95208 -Node: More Complex97355 -Ref: More Complex-Footnote-1100285 -Node: Statements/Lines100370 -Ref: Statements/Lines-Footnote-1104832 -Node: Other Features105097 -Node: When106025 -Node: Invoking Gawk108172 -Node: Command Line109633 -Node: Options110416 -Ref: Options-Footnote-1125808 -Node: Other Arguments125833 -Node: Naming Standard Input128491 -Node: Environment Variables129585 -Node: AWKPATH Variable130143 -Ref: AWKPATH Variable-Footnote-1132901 -Node: AWKLIBPATH Variable133161 -Node: Other Environment Variables133879 -Node: Exit Status136842 -Node: Include Files137517 -Node: Loading Shared Libraries141086 -Node: Obsolete142450 -Node: Undocumented143147 -Node: Regexp143389 -Node: Regexp Usage144778 -Node: Escape Sequences146804 -Node: Regexp Operators152473 -Ref: Regexp Operators-Footnote-1159853 -Ref: Regexp Operators-Footnote-2160000 -Node: Bracket Expressions160098 -Ref: table-char-classes161988 -Node: GNU Regexp Operators164511 -Node: Case-sensitivity168234 -Ref: Case-sensitivity-Footnote-1171202 -Ref: Case-sensitivity-Footnote-2171437 -Node: Leftmost Longest171545 -Node: Computed Regexps172746 -Node: Reading Files176083 -Node: Records178085 -Ref: Records-Footnote-1186974 -Node: Fields187011 -Ref: Fields-Footnote-1190044 -Node: Nonconstant Fields190130 -Node: Changing Fields192332 -Node: Field Separators198291 -Node: Default Field Splitting200920 -Node: Regexp Field Splitting202037 -Node: Single Character Fields205379 -Node: Command Line Field Separator206438 -Node: Field Splitting Summary209879 -Ref: Field Splitting Summary-Footnote-1212990 -Node: Constant Size213091 -Node: Splitting By Content217675 -Ref: Splitting By Content-Footnote-1221401 -Node: Multiple Line221441 -Ref: Multiple Line-Footnote-1227288 -Node: Getline227467 -Node: Plain Getline229683 -Node: Getline/Variable231778 -Node: Getline/File232925 -Node: Getline/Variable/File234266 -Ref: Getline/Variable/File-Footnote-1235865 -Node: Getline/Pipe235952 -Node: Getline/Variable/Pipe238651 -Node: Getline/Coprocess239758 -Node: Getline/Variable/Coprocess241010 -Node: Getline Notes241747 -Node: Getline Summary244534 -Ref: table-getline-variants244942 -Node: Read Timeout245854 -Ref: Read Timeout-Footnote-1249595 -Node: Command line directories249652 -Node: Printing250282 -Node: Print251913 -Node: Print Examples253250 -Node: Output Separators256034 -Node: OFMT257794 -Node: Printf259152 -Node: Basic Printf260058 -Node: Control Letters261597 -Node: Format Modifiers265409 -Node: Printf Examples271418 -Node: Redirection274133 -Node: Special Files281098 -Node: Special FD281631 -Ref: Special FD-Footnote-1285256 -Node: Special Network285330 -Node: Special Caveats286180 -Node: Close Files And Pipes286976 -Ref: Close Files And Pipes-Footnote-1293959 -Ref: Close Files And Pipes-Footnote-2294107 -Node: Expressions294257 -Node: Values295389 -Node: Constants296065 -Node: Scalar Constants296745 -Ref: Scalar Constants-Footnote-1297604 -Node: Nondecimal-numbers297786 -Node: Regexp Constants300786 -Node: Using Constant Regexps301261 -Node: Variables304316 -Node: Using Variables304971 -Node: Assignment Options306695 -Node: Conversion308567 -Ref: table-locale-affects314068 -Ref: Conversion-Footnote-1314692 -Node: All Operators314801 -Node: Arithmetic Ops315431 -Node: Concatenation317936 -Ref: Concatenation-Footnote-1320728 -Node: Assignment Ops320848 -Ref: table-assign-ops325836 -Node: Increment Ops327167 -Node: Truth Values and Conditions330601 -Node: Truth Values331684 -Node: Typing and Comparison332733 -Node: Variable Typing333526 -Ref: Variable Typing-Footnote-1337423 -Node: Comparison Operators337545 -Ref: table-relational-ops337955 -Node: POSIX String Comparison341504 -Ref: POSIX String Comparison-Footnote-1342460 -Node: Boolean Ops342598 -Ref: Boolean Ops-Footnote-1346676 -Node: Conditional Exp346767 -Node: Function Calls348499 -Node: Precedence352093 -Node: Locales355762 -Node: Patterns and Actions356851 -Node: Pattern Overview357905 -Node: Regexp Patterns359574 -Node: Expression Patterns360117 -Node: Ranges363802 -Node: BEGIN/END366768 -Node: Using BEGIN/END367530 -Ref: Using BEGIN/END-Footnote-1370261 -Node: I/O And BEGIN/END370367 -Node: BEGINFILE/ENDFILE372649 -Node: Empty375563 -Node: Using Shell Variables375879 -Node: Action Overview378164 -Node: Statements380521 -Node: If Statement382375 -Node: While Statement383874 -Node: Do Statement385918 -Node: For Statement387074 -Node: Switch Statement390226 -Node: Break Statement392323 -Node: Continue Statement394313 -Node: Next Statement396106 -Node: Nextfile Statement398496 -Node: Exit Statement401139 -Node: Built-in Variables403555 -Node: User-modified404650 -Ref: User-modified-Footnote-1413008 -Node: Auto-set413070 -Ref: Auto-set-Footnote-1426148 -Ref: Auto-set-Footnote-2426353 -Node: ARGC and ARGV426409 -Node: Arrays430260 -Node: Array Basics431765 -Node: Array Intro432591 -Node: Reference to Elements436908 -Node: Assigning Elements439178 -Node: Array Example439669 -Node: Scanning an Array441401 -Node: Controlling Scanning443715 -Ref: Controlling Scanning-Footnote-1448802 -Node: Delete449118 -Ref: Delete-Footnote-1451883 -Node: Numeric Array Subscripts451940 -Node: Uninitialized Subscripts454123 -Node: Multidimensional455750 -Node: Multiscanning458842 -Node: Arrays of Arrays460431 -Node: Functions465071 -Node: Built-in465890 -Node: Calling Built-in466968 -Node: Numeric Functions468956 -Ref: Numeric Functions-Footnote-1472788 -Ref: Numeric Functions-Footnote-2473145 -Ref: Numeric Functions-Footnote-3473193 -Node: String Functions473462 -Ref: String Functions-Footnote-1496382 -Ref: String Functions-Footnote-2496511 -Ref: String Functions-Footnote-3496759 -Node: Gory Details496846 -Ref: table-sub-escapes498525 -Ref: table-sub-posix-92499879 -Ref: table-sub-proposed501230 -Ref: table-posix-sub502584 -Ref: table-gensub-escapes504129 -Ref: Gory Details-Footnote-1505305 -Ref: Gory Details-Footnote-2505356 -Node: I/O Functions505507 -Ref: I/O Functions-Footnote-1512492 -Node: Time Functions512639 -Ref: Time Functions-Footnote-1523572 -Ref: Time Functions-Footnote-2523640 -Ref: Time Functions-Footnote-3523798 -Ref: Time Functions-Footnote-4523909 -Ref: Time Functions-Footnote-5524021 -Ref: Time Functions-Footnote-6524248 -Node: Bitwise Functions524514 -Ref: table-bitwise-ops525076 -Ref: Bitwise Functions-Footnote-1529297 -Node: Type Functions529481 -Node: I18N Functions530632 -Node: User-defined532259 -Node: Definition Syntax533063 -Ref: Definition Syntax-Footnote-1537973 -Node: Function Example538042 -Node: Function Caveats540636 -Node: Calling A Function541057 -Node: Variable Scope542172 -Node: Pass By Value/Reference545135 -Node: Return Statement548643 -Node: Dynamic Typing551624 -Node: Indirect Calls552555 -Node: Library Functions562240 -Ref: Library Functions-Footnote-1565753 -Ref: Library Functions-Footnote-2565896 -Node: Library Names566067 -Ref: Library Names-Footnote-1569538 -Ref: Library Names-Footnote-2569758 -Node: General Functions569844 -Node: Strtonum Function570872 -Node: Assert Function573802 -Node: Round Function577128 -Node: Cliff Random Function578671 -Node: Ordinal Functions579687 -Ref: Ordinal Functions-Footnote-1582757 -Ref: Ordinal Functions-Footnote-2583009 -Node: Join Function583218 -Ref: Join Function-Footnote-1584989 -Node: Getlocaltime Function585189 -Node: Readfile Function588930 -Node: Data File Management590769 -Node: Filetrans Function591401 -Node: Rewind Function595470 -Node: File Checking596857 -Node: Empty Files597951 -Node: Ignoring Assigns600181 -Node: Getopt Function601734 -Ref: Getopt Function-Footnote-1613037 -Node: Passwd Functions613240 -Ref: Passwd Functions-Footnote-1622215 -Node: Group Functions622303 -Node: Walking Arrays630387 -Node: Sample Programs632524 -Node: Running Examples633198 -Node: Clones633926 -Node: Cut Program635150 -Node: Egrep Program644995 -Ref: Egrep Program-Footnote-1652768 -Node: Id Program652878 -Node: Split Program656494 -Ref: Split Program-Footnote-1660013 -Node: Tee Program660141 -Node: Uniq Program662944 -Node: Wc Program670373 -Ref: Wc Program-Footnote-1674639 -Ref: Wc Program-Footnote-2674839 -Node: Miscellaneous Programs674931 -Node: Dupword Program676119 -Node: Alarm Program678150 -Node: Translate Program682903 -Ref: Translate Program-Footnote-1687290 -Ref: Translate Program-Footnote-2687538 -Node: Labels Program687672 -Ref: Labels Program-Footnote-1691043 -Node: Word Sorting691127 -Node: History Sorting695011 -Node: Extract Program696850 -Ref: Extract Program-Footnote-1704353 -Node: Simple Sed704481 -Node: Igawk Program707543 -Ref: Igawk Program-Footnote-1722700 -Ref: Igawk Program-Footnote-2722901 -Node: Anagram Program723039 -Node: Signature Program726107 -Node: Advanced Features727207 -Node: Nondecimal Data729093 -Node: Array Sorting730676 -Node: Controlling Array Traversal731373 -Node: Array Sorting Functions739657 -Ref: Array Sorting Functions-Footnote-1743526 -Node: Two-way I/O743720 -Ref: Two-way I/O-Footnote-1749152 -Node: TCP/IP Networking749222 -Node: Profiling752066 -Node: Internationalization759563 -Node: I18N and L10N760988 -Node: Explaining gettext761674 -Ref: Explaining gettext-Footnote-1766742 -Ref: Explaining gettext-Footnote-2766926 -Node: Programmer i18n767091 -Node: Translator i18n771293 -Node: String Extraction772086 -Ref: String Extraction-Footnote-1773047 -Node: Printf Ordering773133 -Ref: Printf Ordering-Footnote-1775917 -Node: I18N Portability775981 -Ref: I18N Portability-Footnote-1778430 -Node: I18N Example778493 -Ref: I18N Example-Footnote-1781131 -Node: Gawk I18N781203 -Node: Debugger781824 -Node: Debugging782795 -Node: Debugging Concepts783228 -Node: Debugging Terms785084 -Node: Awk Debugging787681 -Node: Sample Debugging Session788573 -Node: Debugger Invocation789093 -Node: Finding The Bug790425 -Node: List of Debugger Commands796913 -Node: Breakpoint Control798247 -Node: Debugger Execution Control801911 -Node: Viewing And Changing Data805271 -Node: Execution Stack808627 -Node: Debugger Info810094 -Node: Miscellaneous Debugger Commands814076 -Node: Readline Support819252 -Node: Limitations820083 -Node: Arbitrary Precision Arithmetic822335 -Ref: Arbitrary Precision Arithmetic-Footnote-1823984 -Node: General Arithmetic824132 -Node: Floating Point Issues825852 -Node: String Conversion Precision826733 -Ref: String Conversion Precision-Footnote-1828438 -Node: Unexpected Results828547 -Node: POSIX Floating Point Problems830700 -Ref: POSIX Floating Point Problems-Footnote-1834525 -Node: Integer Programming834563 -Node: Floating-point Programming836302 -Ref: Floating-point Programming-Footnote-1842633 -Ref: Floating-point Programming-Footnote-2842903 -Node: Floating-point Representation843167 -Node: Floating-point Context844332 -Ref: table-ieee-formats845171 -Node: Rounding Mode846555 -Ref: table-rounding-modes847034 -Ref: Rounding Mode-Footnote-1850049 -Node: Gawk and MPFR850228 -Node: Arbitrary Precision Floats851483 -Ref: Arbitrary Precision Floats-Footnote-1853926 -Node: Setting Precision854242 -Ref: table-predefined-precision-strings854928 -Node: Setting Rounding Mode857073 -Ref: table-gawk-rounding-modes857477 -Node: Floating-point Constants858664 -Node: Changing Precision860093 -Ref: Changing Precision-Footnote-1861490 -Node: Exact Arithmetic861664 -Node: Arbitrary Precision Integers864802 -Ref: Arbitrary Precision Integers-Footnote-1867820 -Node: Dynamic Extensions867967 -Node: Extension Intro869425 -Node: Plugin License870690 -Node: Extension Mechanism Outline871375 -Ref: load-extension871792 -Ref: load-new-function873270 -Ref: call-new-function874265 -Node: Extension API Description876280 -Node: Extension API Functions Introduction877493 -Node: General Data Types882359 -Ref: General Data Types-Footnote-1887964 -Node: Requesting Values888263 -Ref: table-value-types-returned888994 -Node: Constructor Functions889948 -Node: Registration Functions892968 -Node: Extension Functions893653 -Node: Exit Callback Functions895878 -Node: Extension Version String897127 -Node: Input Parsers897777 -Node: Output Wrappers907534 -Node: Two-way processors912044 -Node: Printing Messages914252 -Ref: Printing Messages-Footnote-1915329 -Node: Updating `ERRNO'915481 -Node: Accessing Parameters916220 -Node: Symbol Table Access917450 -Node: Symbol table by name917962 -Node: Symbol table by cookie919709 -Ref: Symbol table by cookie-Footnote-1923839 -Node: Cached values923902 -Ref: Cached values-Footnote-1927351 -Node: Array Manipulation927442 -Ref: Array Manipulation-Footnote-1928540 -Node: Array Data Types928579 -Ref: Array Data Types-Footnote-1931282 -Node: Array Functions931374 -Node: Flattening Arrays935140 -Node: Creating Arrays941992 -Node: Extension API Variables946717 -Node: Extension Versioning947353 -Node: Extension API Informational Variables949254 -Node: Extension API Boilerplate950340 -Node: Finding Extensions954144 -Node: Extension Example954704 -Node: Internal File Description955434 -Node: Internal File Ops959525 -Ref: Internal File Ops-Footnote-1971033 -Node: Using Internal File Ops971173 -Ref: Using Internal File Ops-Footnote-1973526 -Node: Extension Samples973792 -Node: Extension Sample File Functions975316 -Node: Extension Sample Fnmatch983801 -Node: Extension Sample Fork985527 -Node: Extension Sample Inplace986745 -Node: Extension Sample Ord988523 -Node: Extension Sample Readdir989359 -Node: Extension Sample Revout990891 -Node: Extension Sample Rev2way991484 -Node: Extension Sample Read write array992174 -Node: Extension Sample Readfile994057 -Node: Extension Sample API Tests994875 -Node: Extension Sample Time995400 -Node: gawkextlib996764 -Node: Language History999545 -Node: V7/SVR3.11001067 -Node: SVR41003387 -Node: POSIX1004829 -Node: BTL1006215 -Node: POSIX/GNU1006949 -Node: Common Extensions1012484 -Node: Ranges and Locales1013790 -Ref: Ranges and Locales-Footnote-11018408 -Ref: Ranges and Locales-Footnote-21018435 -Ref: Ranges and Locales-Footnote-31018695 -Node: Contributors1018916 -Node: Installation1023991 -Node: Gawk Distribution1024885 -Node: Getting1025369 -Node: Extracting1026195 -Node: Distribution contents1027887 -Node: Unix Installation1033592 -Node: Quick Installation1034209 -Node: Additional Configuration Options1036653 -Node: Configuration Philosophy1038389 -Node: Non-Unix Installation1040743 -Node: PC Installation1041201 -Node: PC Binary Installation1042500 -Node: PC Compiling1044348 -Node: PC Testing1047292 -Node: PC Using1048468 -Node: Cygwin1052653 -Node: MSYS1053653 -Node: VMS Installation1054167 -Node: VMS Compilation1054770 -Ref: VMS Compilation-Footnote-11055777 -Node: VMS Installation Details1055835 -Node: VMS Running1057470 -Node: VMS Old Gawk1059077 -Node: Bugs1059551 -Node: Other Versions1063407 -Node: Notes1069491 -Node: Compatibility Mode1070291 -Node: Additions1071074 -Node: Accessing The Source1072001 -Node: Adding Code1073441 -Node: New Ports1079486 -Node: Derived Files1083621 -Ref: Derived Files-Footnote-11088942 -Ref: Derived Files-Footnote-21088976 -Ref: Derived Files-Footnote-31089576 -Node: Future Extensions1089674 -Node: Implementation Limitations1090257 -Node: Extension Design1091509 -Node: Old Extension Problems1092663 -Ref: Old Extension Problems-Footnote-11094171 -Node: Extension New Mechanism Goals1094228 -Ref: Extension New Mechanism Goals-Footnote-11097593 -Node: Extension Other Design Decisions1097779 -Node: Extension Future Growth1099885 -Node: Old Extension Mechanism1100721 -Node: Basic Concepts1102461 -Node: Basic High Level1103142 -Ref: figure-general-flow1103413 -Ref: figure-process-flow1104012 -Ref: Basic High Level-Footnote-11107241 -Node: Basic Data Typing1107426 -Node: Glossary1110781 -Node: Copying1136243 -Node: GNU Free Documentation License1173800 -Node: Index1198937 +Node: Foreword40540 +Node: Preface44885 +Ref: Preface-Footnote-147938 +Ref: Preface-Footnote-248034 +Node: History48266 +Node: Names50640 +Ref: Names-Footnote-152117 +Node: This Manual52189 +Ref: This Manual-Footnote-157963 +Node: Conventions58063 +Node: Manual History60219 +Ref: Manual History-Footnote-163667 +Ref: Manual History-Footnote-263708 +Node: How To Contribute63782 +Node: Acknowledgments64926 +Node: Getting Started69135 +Node: Running gawk71514 +Node: One-shot72700 +Node: Read Terminal73925 +Ref: Read Terminal-Footnote-175575 +Ref: Read Terminal-Footnote-275851 +Node: Long76022 +Node: Executable Scripts77398 +Ref: Executable Scripts-Footnote-179231 +Ref: Executable Scripts-Footnote-279333 +Node: Comments79880 +Node: Quoting82347 +Node: DOS Quoting86970 +Node: Sample Data Files87645 +Node: Very Simple90689 +Node: Two Rules95288 +Node: More Complex97435 +Ref: More Complex-Footnote-1100365 +Node: Statements/Lines100450 +Ref: Statements/Lines-Footnote-1104912 +Node: Other Features105177 +Node: When106105 +Node: Invoking Gawk108252 +Node: Command Line109713 +Node: Options110496 +Ref: Options-Footnote-1125888 +Node: Other Arguments125913 +Node: Naming Standard Input128571 +Node: Environment Variables129665 +Node: AWKPATH Variable130223 +Ref: AWKPATH Variable-Footnote-1132981 +Node: AWKLIBPATH Variable133241 +Node: Other Environment Variables133959 +Node: Exit Status136922 +Node: Include Files137597 +Node: Loading Shared Libraries141166 +Node: Obsolete142530 +Node: Undocumented143227 +Node: Regexp143469 +Node: Regexp Usage144858 +Node: Escape Sequences146884 +Node: Regexp Operators152553 +Ref: Regexp Operators-Footnote-1159933 +Ref: Regexp Operators-Footnote-2160080 +Node: Bracket Expressions160178 +Ref: table-char-classes162068 +Node: GNU Regexp Operators164591 +Node: Case-sensitivity168314 +Ref: Case-sensitivity-Footnote-1171282 +Ref: Case-sensitivity-Footnote-2171517 +Node: Leftmost Longest171625 +Node: Computed Regexps172826 +Node: Reading Files176163 +Node: Records178165 +Ref: Records-Footnote-1187054 +Node: Fields187091 +Ref: Fields-Footnote-1190124 +Node: Nonconstant Fields190210 +Node: Changing Fields192412 +Node: Field Separators198371 +Node: Default Field Splitting201073 +Node: Regexp Field Splitting202190 +Node: Single Character Fields205532 +Node: Command Line Field Separator206591 +Node: Full Line Fields210025 +Node: Field Splitting Summary210252 +Ref: Field Splitting Summary-Footnote-1213351 +Node: Constant Size213452 +Node: Splitting By Content218036 +Ref: Splitting By Content-Footnote-1221762 +Node: Multiple Line221802 +Ref: Multiple Line-Footnote-1227649 +Node: Getline227828 +Node: Plain Getline230044 +Node: Getline/Variable232139 +Node: Getline/File233286 +Node: Getline/Variable/File234627 +Ref: Getline/Variable/File-Footnote-1236226 +Node: Getline/Pipe236313 +Node: Getline/Variable/Pipe239012 +Node: Getline/Coprocess240119 +Node: Getline/Variable/Coprocess241371 +Node: Getline Notes242108 +Node: Getline Summary244895 +Ref: table-getline-variants245303 +Node: Read Timeout246215 +Ref: Read Timeout-Footnote-1249956 +Node: Command line directories250013 +Node: Printing250643 +Node: Print252274 +Node: Print Examples253611 +Node: Output Separators256395 +Node: OFMT258155 +Node: Printf259513 +Node: Basic Printf260419 +Node: Control Letters261958 +Node: Format Modifiers265770 +Node: Printf Examples271779 +Node: Redirection274494 +Node: Special Files281459 +Node: Special FD281992 +Ref: Special FD-Footnote-1285617 +Node: Special Network285691 +Node: Special Caveats286541 +Node: Close Files And Pipes287337 +Ref: Close Files And Pipes-Footnote-1294320 +Ref: Close Files And Pipes-Footnote-2294468 +Node: Expressions294618 +Node: Values295750 +Node: Constants296426 +Node: Scalar Constants297106 +Ref: Scalar Constants-Footnote-1297965 +Node: Nondecimal-numbers298147 +Node: Regexp Constants301147 +Node: Using Constant Regexps301622 +Node: Variables304677 +Node: Using Variables305332 +Node: Assignment Options307056 +Node: Conversion308928 +Ref: table-locale-affects314429 +Ref: Conversion-Footnote-1315053 +Node: All Operators315162 +Node: Arithmetic Ops315792 +Node: Concatenation318297 +Ref: Concatenation-Footnote-1321089 +Node: Assignment Ops321209 +Ref: table-assign-ops326197 +Node: Increment Ops327528 +Node: Truth Values and Conditions330962 +Node: Truth Values332045 +Node: Typing and Comparison333094 +Node: Variable Typing333887 +Ref: Variable Typing-Footnote-1337784 +Node: Comparison Operators337906 +Ref: table-relational-ops338316 +Node: POSIX String Comparison341865 +Ref: POSIX String Comparison-Footnote-1342821 +Node: Boolean Ops342959 +Ref: Boolean Ops-Footnote-1347037 +Node: Conditional Exp347128 +Node: Function Calls348860 +Node: Precedence352454 +Node: Locales356123 +Node: Patterns and Actions357212 +Node: Pattern Overview358266 +Node: Regexp Patterns359935 +Node: Expression Patterns360478 +Node: Ranges364163 +Node: BEGIN/END367129 +Node: Using BEGIN/END367891 +Ref: Using BEGIN/END-Footnote-1370622 +Node: I/O And BEGIN/END370728 +Node: BEGINFILE/ENDFILE373010 +Node: Empty375924 +Node: Using Shell Variables376240 +Node: Action Overview378525 +Node: Statements380882 +Node: If Statement382736 +Node: While Statement384235 +Node: Do Statement386279 +Node: For Statement387435 +Node: Switch Statement390587 +Node: Break Statement392684 +Node: Continue Statement394674 +Node: Next Statement396467 +Node: Nextfile Statement398857 +Node: Exit Statement401500 +Node: Built-in Variables403916 +Node: User-modified405011 +Ref: User-modified-Footnote-1413369 +Node: Auto-set413431 +Ref: Auto-set-Footnote-1426509 +Ref: Auto-set-Footnote-2426714 +Node: ARGC and ARGV426770 +Node: Arrays430621 +Node: Array Basics432126 +Node: Array Intro432952 +Node: Reference to Elements437269 +Node: Assigning Elements439539 +Node: Array Example440030 +Node: Scanning an Array441762 +Node: Controlling Scanning444076 +Ref: Controlling Scanning-Footnote-1449163 +Node: Delete449479 +Ref: Delete-Footnote-1452244 +Node: Numeric Array Subscripts452301 +Node: Uninitialized Subscripts454484 +Node: Multidimensional456111 +Node: Multiscanning459203 +Node: Arrays of Arrays460792 +Node: Functions465432 +Node: Built-in466251 +Node: Calling Built-in467329 +Node: Numeric Functions469317 +Ref: Numeric Functions-Footnote-1473149 +Ref: Numeric Functions-Footnote-2473506 +Ref: Numeric Functions-Footnote-3473554 +Node: String Functions473823 +Ref: String Functions-Footnote-1496743 +Ref: String Functions-Footnote-2496872 +Ref: String Functions-Footnote-3497120 +Node: Gory Details497207 +Ref: table-sub-escapes498886 +Ref: table-sub-posix-92500240 +Ref: table-sub-proposed501591 +Ref: table-posix-sub502945 +Ref: table-gensub-escapes504490 +Ref: Gory Details-Footnote-1505666 +Ref: Gory Details-Footnote-2505717 +Node: I/O Functions505868 +Ref: I/O Functions-Footnote-1512853 +Node: Time Functions513000 +Ref: Time Functions-Footnote-1523933 +Ref: Time Functions-Footnote-2524001 +Ref: Time Functions-Footnote-3524159 +Ref: Time Functions-Footnote-4524270 +Ref: Time Functions-Footnote-5524382 +Ref: Time Functions-Footnote-6524609 +Node: Bitwise Functions524875 +Ref: table-bitwise-ops525437 +Ref: Bitwise Functions-Footnote-1529658 +Node: Type Functions529842 +Node: I18N Functions530993 +Node: User-defined532620 +Node: Definition Syntax533424 +Ref: Definition Syntax-Footnote-1538334 +Node: Function Example538403 +Node: Function Caveats540997 +Node: Calling A Function541418 +Node: Variable Scope542533 +Node: Pass By Value/Reference545496 +Node: Return Statement549004 +Node: Dynamic Typing551985 +Node: Indirect Calls552916 +Node: Library Functions562601 +Ref: Library Functions-Footnote-1566114 +Ref: Library Functions-Footnote-2566257 +Node: Library Names566428 +Ref: Library Names-Footnote-1569899 +Ref: Library Names-Footnote-2570119 +Node: General Functions570205 +Node: Strtonum Function571233 +Node: Assert Function574163 +Node: Round Function577489 +Node: Cliff Random Function579032 +Node: Ordinal Functions580048 +Ref: Ordinal Functions-Footnote-1583118 +Ref: Ordinal Functions-Footnote-2583370 +Node: Join Function583579 +Ref: Join Function-Footnote-1585350 +Node: Getlocaltime Function585550 +Node: Readfile Function589291 +Node: Data File Management591130 +Node: Filetrans Function591762 +Node: Rewind Function595831 +Node: File Checking597218 +Node: Empty Files598312 +Node: Ignoring Assigns600542 +Node: Getopt Function602095 +Ref: Getopt Function-Footnote-1613398 +Node: Passwd Functions613601 +Ref: Passwd Functions-Footnote-1622576 +Node: Group Functions622664 +Node: Walking Arrays630748 +Node: Sample Programs632885 +Node: Running Examples633559 +Node: Clones634287 +Node: Cut Program635511 +Node: Egrep Program645356 +Ref: Egrep Program-Footnote-1653129 +Node: Id Program653239 +Node: Split Program656855 +Ref: Split Program-Footnote-1660374 +Node: Tee Program660502 +Node: Uniq Program663305 +Node: Wc Program670734 +Ref: Wc Program-Footnote-1675000 +Ref: Wc Program-Footnote-2675200 +Node: Miscellaneous Programs675292 +Node: Dupword Program676480 +Node: Alarm Program678511 +Node: Translate Program683264 +Ref: Translate Program-Footnote-1687651 +Ref: Translate Program-Footnote-2687899 +Node: Labels Program688033 +Ref: Labels Program-Footnote-1691404 +Node: Word Sorting691488 +Node: History Sorting695372 +Node: Extract Program697211 +Ref: Extract Program-Footnote-1704714 +Node: Simple Sed704842 +Node: Igawk Program707904 +Ref: Igawk Program-Footnote-1723061 +Ref: Igawk Program-Footnote-2723262 +Node: Anagram Program723400 +Node: Signature Program726468 +Node: Advanced Features727568 +Node: Nondecimal Data729454 +Node: Array Sorting731037 +Node: Controlling Array Traversal731734 +Node: Array Sorting Functions740018 +Ref: Array Sorting Functions-Footnote-1743887 +Node: Two-way I/O744081 +Ref: Two-way I/O-Footnote-1749513 +Node: TCP/IP Networking749583 +Node: Profiling752427 +Node: Internationalization759924 +Node: I18N and L10N761349 +Node: Explaining gettext762035 +Ref: Explaining gettext-Footnote-1767103 +Ref: Explaining gettext-Footnote-2767287 +Node: Programmer i18n767452 +Node: Translator i18n771654 +Node: String Extraction772447 +Ref: String Extraction-Footnote-1773408 +Node: Printf Ordering773494 +Ref: Printf Ordering-Footnote-1776278 +Node: I18N Portability776342 +Ref: I18N Portability-Footnote-1778791 +Node: I18N Example778854 +Ref: I18N Example-Footnote-1781492 +Node: Gawk I18N781564 +Node: Debugger782185 +Node: Debugging783156 +Node: Debugging Concepts783589 +Node: Debugging Terms785445 +Node: Awk Debugging788042 +Node: Sample Debugging Session788934 +Node: Debugger Invocation789454 +Node: Finding The Bug790786 +Node: List of Debugger Commands797274 +Node: Breakpoint Control798608 +Node: Debugger Execution Control802272 +Node: Viewing And Changing Data805632 +Node: Execution Stack808988 +Node: Debugger Info810455 +Node: Miscellaneous Debugger Commands814437 +Node: Readline Support819613 +Node: Limitations820444 +Node: Arbitrary Precision Arithmetic822696 +Ref: Arbitrary Precision Arithmetic-Footnote-1824345 +Node: General Arithmetic824493 +Node: Floating Point Issues826213 +Node: String Conversion Precision827094 +Ref: String Conversion Precision-Footnote-1828799 +Node: Unexpected Results828908 +Node: POSIX Floating Point Problems831061 +Ref: POSIX Floating Point Problems-Footnote-1834886 +Node: Integer Programming834924 +Node: Floating-point Programming836663 +Ref: Floating-point Programming-Footnote-1842994 +Ref: Floating-point Programming-Footnote-2843264 +Node: Floating-point Representation843528 +Node: Floating-point Context844693 +Ref: table-ieee-formats845532 +Node: Rounding Mode846916 +Ref: table-rounding-modes847395 +Ref: Rounding Mode-Footnote-1850410 +Node: Gawk and MPFR850589 +Node: Arbitrary Precision Floats851844 +Ref: Arbitrary Precision Floats-Footnote-1854287 +Node: Setting Precision854603 +Ref: table-predefined-precision-strings855289 +Node: Setting Rounding Mode857434 +Ref: table-gawk-rounding-modes857838 +Node: Floating-point Constants859025 +Node: Changing Precision860454 +Ref: Changing Precision-Footnote-1861851 +Node: Exact Arithmetic862025 +Node: Arbitrary Precision Integers865163 +Ref: Arbitrary Precision Integers-Footnote-1868181 +Node: Dynamic Extensions868328 +Node: Extension Intro869786 +Node: Plugin License871051 +Node: Extension Mechanism Outline871736 +Ref: load-extension872153 +Ref: load-new-function873631 +Ref: call-new-function874626 +Node: Extension API Description876641 +Node: Extension API Functions Introduction877854 +Node: General Data Types882720 +Ref: General Data Types-Footnote-1888325 +Node: Requesting Values888624 +Ref: table-value-types-returned889355 +Node: Constructor Functions890309 +Node: Registration Functions893329 +Node: Extension Functions894014 +Node: Exit Callback Functions896239 +Node: Extension Version String897488 +Node: Input Parsers898138 +Node: Output Wrappers907895 +Node: Two-way processors912405 +Node: Printing Messages914613 +Ref: Printing Messages-Footnote-1915690 +Node: Updating `ERRNO'915842 +Node: Accessing Parameters916581 +Node: Symbol Table Access917811 +Node: Symbol table by name918323 +Node: Symbol table by cookie920070 +Ref: Symbol table by cookie-Footnote-1924200 +Node: Cached values924263 +Ref: Cached values-Footnote-1927712 +Node: Array Manipulation927803 +Ref: Array Manipulation-Footnote-1928901 +Node: Array Data Types928940 +Ref: Array Data Types-Footnote-1931643 +Node: Array Functions931735 +Node: Flattening Arrays935501 +Node: Creating Arrays942353 +Node: Extension API Variables947078 +Node: Extension Versioning947714 +Node: Extension API Informational Variables949615 +Node: Extension API Boilerplate950701 +Node: Finding Extensions954505 +Node: Extension Example955065 +Node: Internal File Description955795 +Node: Internal File Ops959886 +Ref: Internal File Ops-Footnote-1971394 +Node: Using Internal File Ops971534 +Ref: Using Internal File Ops-Footnote-1973887 +Node: Extension Samples974153 +Node: Extension Sample File Functions975677 +Node: Extension Sample Fnmatch984162 +Node: Extension Sample Fork985888 +Node: Extension Sample Inplace987106 +Node: Extension Sample Ord988884 +Node: Extension Sample Readdir989720 +Node: Extension Sample Revout991252 +Node: Extension Sample Rev2way991845 +Node: Extension Sample Read write array992535 +Node: Extension Sample Readfile994418 +Node: Extension Sample API Tests995236 +Node: Extension Sample Time995761 +Node: gawkextlib997125 +Node: Language History999906 +Node: V7/SVR3.11001428 +Node: SVR41003748 +Node: POSIX1005190 +Node: BTL1006576 +Node: POSIX/GNU1007310 +Node: Common Extensions1012845 +Node: Ranges and Locales1014151 +Ref: Ranges and Locales-Footnote-11018769 +Ref: Ranges and Locales-Footnote-21018796 +Ref: Ranges and Locales-Footnote-31019056 +Node: Contributors1019277 +Node: Installation1024352 +Node: Gawk Distribution1025246 +Node: Getting1025730 +Node: Extracting1026556 +Node: Distribution contents1028248 +Node: Unix Installation1033953 +Node: Quick Installation1034570 +Node: Additional Configuration Options1037014 +Node: Configuration Philosophy1038750 +Node: Non-Unix Installation1041104 +Node: PC Installation1041562 +Node: PC Binary Installation1042861 +Node: PC Compiling1044709 +Node: PC Testing1047653 +Node: PC Using1048829 +Node: Cygwin1053014 +Node: MSYS1054014 +Node: VMS Installation1054528 +Node: VMS Compilation1055131 +Ref: VMS Compilation-Footnote-11056138 +Node: VMS Installation Details1056196 +Node: VMS Running1057831 +Node: VMS Old Gawk1059438 +Node: Bugs1059912 +Node: Other Versions1063768 +Node: Notes1069852 +Node: Compatibility Mode1070652 +Node: Additions1071435 +Node: Accessing The Source1072362 +Node: Adding Code1073802 +Node: New Ports1079847 +Node: Derived Files1083982 +Ref: Derived Files-Footnote-11089303 +Ref: Derived Files-Footnote-21089337 +Ref: Derived Files-Footnote-31089937 +Node: Future Extensions1090035 +Node: Implementation Limitations1090618 +Node: Extension Design1091870 +Node: Old Extension Problems1093024 +Ref: Old Extension Problems-Footnote-11094532 +Node: Extension New Mechanism Goals1094589 +Ref: Extension New Mechanism Goals-Footnote-11097954 +Node: Extension Other Design Decisions1098140 +Node: Extension Future Growth1100246 +Node: Old Extension Mechanism1101082 +Node: Basic Concepts1102822 +Node: Basic High Level1103503 +Ref: figure-general-flow1103774 +Ref: figure-process-flow1104373 +Ref: Basic High Level-Footnote-11107602 +Node: Basic Data Typing1107787 +Node: Glossary1111142 +Node: Copying1136604 +Node: GNU Free Documentation License1174161 +Node: Index1199298 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 47ea0acc..bfc3a17f 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -401,6 +401,7 @@ particular records in a file and perform operations upon them. field. * Command Line Field Separator:: Setting @code{FS} from the command-line. +* Full Line Fields:: Making the full line be a single field. * Field Splitting Summary:: Some final points and a summary table. * Constant Size:: Reading constant width data. * Splitting By Content:: Defining Fields By Content @@ -6303,6 +6304,7 @@ with a statement such as @samp{$1 = $1}, as described earlier. * Regexp Field Splitting:: Using regexps as the field separator. * Single Character Fields:: Making each character a separate field. * Command Line Field Separator:: Setting @code{FS} from the command-line. +* Full Line Fields:: Making the full line be a single field. * Field Splitting Summary:: Some final points and a summary table. @end menu @@ -6671,6 +6673,9 @@ the entries for users who have no password: awk -F: '$2 == ""' /etc/passwd @end example +@node Full Line Fields +@subsection Making The Full Line Be A Single Field + @node Field Splitting Summary @subsection Field-Splitting Summary diff --git a/doc/gawktexi.in b/doc/gawktexi.in index a82a1b37..842fafe6 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -396,6 +396,7 @@ particular records in a file and perform operations upon them. field. * Command Line Field Separator:: Setting @code{FS} from the command-line. +* Full Line Fields:: Making the full line be a single field. * Field Splitting Summary:: Some final points and a summary table. * Constant Size:: Reading constant width data. * Splitting By Content:: Defining Fields By Content @@ -6024,6 +6025,7 @@ with a statement such as @samp{$1 = $1}, as described earlier. * Regexp Field Splitting:: Using regexps as the field separator. * Single Character Fields:: Making each character a separate field. * Command Line Field Separator:: Setting @code{FS} from the command-line. +* Full Line Fields:: Making the full line be a single field. * Field Splitting Summary:: Some final points and a summary table. @end menu @@ -6392,6 +6394,21 @@ the entries for users who have no password: awk -F: '$2 == ""' /etc/passwd @end example +@node Full Line Fields +@subsection Making The Full Line Be A Single Field + +Occasionally, it's useful to treat the whole input line as a +single field. This can be done easily and portably simply by +setting @code{FS} to @code{"\n"} (a newline).@footnote{Thanks to +Andrew Schorr for this tip.} + +@example +awk -F'\n' '@var{program}' @var{files @dots{}} +@end example + +@noindent +When you do this, @code{$1} is the same as @code{$0}. + @node Field Splitting Summary @subsection Field-Splitting Summary |