diff options
| -rw-r--r-- | doc/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/awkcard.in | 14 | ||||
| -rw-r--r-- | doc/gawk.info | 889 | ||||
| -rw-r--r-- | doc/gawk.texi | 16 |
4 files changed, 476 insertions, 448 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index b540b6ed..a548570b 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2013-01-06 Arnold D. Robbins <arnold@skeeve.com> + + * gawk.texi, awkcard.in: Add Git Hub info for BWK awk. + Update copyrights. + 2012-12-24 Arnold D. Robbins <arnold@skeeve.com> * 4.0.2: Release tar ball made. diff --git a/doc/awkcard.in b/doc/awkcard.in index 3197d38d..9f92c1d6 100644 --- a/doc/awkcard.in +++ b/doc/awkcard.in @@ -1,7 +1,7 @@ .\" AWK Reference Card --- Arnold Robbins, arnold@skeeve.com .\" .\" Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, -.\" 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012 +.\" 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012, 2013 .\" Free Software Foundation, Inc. .\" .\" Permission is granted to make and distribute verbatim copies of @@ -102,7 +102,7 @@ Brian Kernighan and Michael Brennan who reviewed it. .SL .nf \*(FRCopyright \(co 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, -2005, 2007, 2009, 2010, 2011, 2012 Free Software Foundation, Inc. +2005, 2007, 2009, 2010, 2011, 2012, 2013 Free Software Foundation, Inc. .nf .BT @@ -1920,8 +1920,10 @@ GNU \*(AK (\*(GK). There may be a later version. .in -.2i .nf .sp .4 -\*(FChttp://www.cs.princeton.edu/~bwk/btl.mirror/ -awk.tar.gz\fP +.\" http://www.cs.princeton.edu/~bwk/btl.mirror/ +.\" awk.tar.gz +.\" .br +\*(FCgit clone git://github.com/onetrueawk/awk\fP .in +.2i .fi \*(NK. This version requires an ANSI C compiler; @@ -1939,13 +1941,13 @@ File: \*(FC/mawk/mawk.tar.gz\fP Michael Brennan's \*(MK. Thomas Dickey now maintains it.\*(CX .in -.2i -.EB "\s+2\f(HBFTP/HTTP INFORMATION\*(FR\s0" +.EB "\s+2\f(HBFTP/HTTP/GIT INFORMATION\*(FR\s0" .sp .5 .\" --- Copying Permissions .ES .fi \*(CDCopyright \(co 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -2007, 2009, 2010, 2011, 2012 Free Software Foundation, Inc. +2007, 2009, 2010, 2011, 2012, 2013 Free Software Foundation, Inc. .sp .5 Permission is granted to make and distribute verbatim copies of this reference card provided the copyright notice and this permission notice diff --git a/doc/gawk.info b/doc/gawk.info index 9ce4b602..a460447a 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -10,7 +10,7 @@ START-INFO-DIR-ENTRY END-INFO-DIR-ENTRY Copyright (C) 1989, 1991, 1992, 1993, 1996, 1997, 1998, 1999, 2000, -2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012 Free +2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012, 2013 Free Software Foundation, Inc. @@ -42,7 +42,7 @@ This file documents `awk', a program that you can use to select particular records in a file and perform operations upon them. Copyright (C) 1989, 1991, 1992, 1993, 1996, 1997, 1998, 1999, 2000, -2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012 Free +2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012, 2013 Free Software Foundation, Inc. @@ -21349,6 +21349,15 @@ Unix `awk' Zip file `http://www.cs.princeton.edu/~bwk/btl.mirror/awk.zip' + You can also retrieve it from Git Hub: + + git clone git://github.com/onetrueawk/awk bwkawk + + The above command creates a copy of the Git + (http://www.git-scm.com) repository in a directory named `bwkawk'. + If you leave that argument off the `git' command line, the + repository copy is created in a directory named `awk'. + This version requires an ISO C (1990 standard) compiler; the C compiler from GCC (the GNU Compiler Collection) works quite nicely. @@ -25155,7 +25164,7 @@ Index (line 13) * awk, versions of, See Also Brian Kernighan's awk: BTL. (line 6) * awk.h file (internal): Internals. (line 15) -* awka compiler for awk: Other Versions. (line 55) +* awka compiler for awk: Other Versions. (line 64) * AWKNUM internal type: Internals. (line 19) * AWKPATH environment variable <1>: PC Using. (line 11) * AWKPATH environment variable: AWKPATH Variable. (line 6) @@ -25215,7 +25224,7 @@ Index * backslash (\), regexp constants: Computed Regexps. (line 28) * backtrace debugger command: Dgawk Stack. (line 13) * BBS-list file: Sample Data Files. (line 6) -* Beebe, Nelson <1>: Other Versions. (line 69) +* Beebe, Nelson <1>: Other Versions. (line 78) * Beebe, Nelson: Acknowledgments. (line 60) * BEGIN pattern <1>: BEGIN/END. (line 6) * BEGIN pattern <2>: Field Separators. (line 44) @@ -25308,7 +25317,7 @@ Index * built-in variables, -v option, setting with: Options. (line 40) * built-in variables, conveying information: Auto-set. (line 6) * built-in variables, user-modifiable: User-modified. (line 6) -* Busybox Awk: Other Versions. (line 78) +* Busybox Awk: Other Versions. (line 87) * call by reference: Pass By Value/Reference. (line 47) * call by value: Pass By Value/Reference. @@ -26384,9 +26393,9 @@ Index * Jacobs, Andrew: Passwd Functions. (line 90) * Jaegermann, Michal <1>: Contributors. (line 46) * Jaegermann, Michal: Acknowledgments. (line 60) -* Java implementation of awk: Other Versions. (line 96) +* Java implementation of awk: Other Versions. (line 105) * Java programming language: Glossary. (line 384) -* jawk: Other Versions. (line 96) +* jawk: Other Versions. (line 105) * Jedi knights: Undocumented. (line 6) * join() user-defined function: Join Function. (line 18) * Kahrs, Ju"rgen <1>: Contributors. (line 70) @@ -26430,7 +26439,7 @@ Index * length() function: String Functions. (line 166) * Lesser General Public License (LGPL): Glossary. (line 401) * LGPL (Lesser General Public License): Glossary. (line 401) -* libmawk: Other Versions. (line 104) +* libmawk: Other Versions. (line 113) * libraries of awk functions: Library Functions. (line 6) * libraries of awk functions, assertions: Assert Function. (line 6) * libraries of awk functions, associative arrays and: Library Names. @@ -26518,7 +26527,7 @@ Index (line 9) * matching, leftmost longest: Multiple Line. (line 26) * matching, null strings: Gory Details. (line 164) -* mawk program: Other Versions. (line 35) +* mawk program: Other Versions. (line 44) * McPhee, Patrick: Contributors. (line 100) * memory, releasing: Internals. (line 101) * message object files: Explaining gettext. (line 41) @@ -26638,7 +26647,7 @@ Index * OFS variable <2>: Output Separators. (line 6) * OFS variable: Changing Fields. (line 64) * OpenBSD: Glossary. (line 615) -* OpenSolaris: Other Versions. (line 86) +* OpenSolaris: Other Versions. (line 95) * operating systems, BSD-based: Manual History. (line 28) * operating systems, PC, gawk on: PC Using. (line 6) * operating systems, PC, gawk on, installing: PC Installation. @@ -26724,7 +26733,7 @@ Index * patterns, regexp constants as: Expression Patterns. (line 36) * patterns, types of: Pattern Overview. (line 15) * pawk (profiling version of Brian Kernighan's awk): Other Versions. - (line 69) + (line 78) * PC operating systems, gawk on: PC Using. (line 6) * PC operating systems, gawk on, installing: PC Installation. (line 6) * percent sign (%), % operator: Precedence. (line 55) @@ -26908,12 +26917,12 @@ Index * pwcat program: Passwd Functions. (line 23) * q debugger command (alias for quit): Miscellaneous Dgawk Commands. (line 101) -* QSE Awk: Other Versions. (line 108) +* QSE Awk: Other Versions. (line 117) * question mark (?) regexp operator <1>: GNU Regexp Operators. (line 59) * question mark (?) regexp operator: Regexp Operators. (line 111) * question mark (?), ?: operator: Precedence. (line 92) -* QuikTrim Awk: Other Versions. (line 112) +* QuikTrim Awk: Other Versions. (line 121) * quit debugger command: Miscellaneous Dgawk Commands. (line 101) * QUIT signal (MS-Windows): Profiling. (line 207) @@ -27144,26 +27153,26 @@ Index (line 6) * Skywalker, Luke: Undocumented. (line 6) * sleep utility: Alarm Program. (line 109) -* Solaris, POSIX-compliant awk: Other Versions. (line 86) +* Solaris, POSIX-compliant awk: Other Versions. (line 95) * sort function, arrays, sorting: Array Sorting Functions. (line 6) * sort utility: Word Sorting. (line 50) * sort utility, coprocesses and: Two-way I/O. (line 83) * sorting characters in different languages: Explaining gettext. (line 93) -* source code, awka: Other Versions. (line 55) +* source code, awka: Other Versions. (line 64) * source code, Brian Kernighan's awk: Other Versions. (line 13) -* source code, Busybox Awk: Other Versions. (line 78) +* source code, Busybox Awk: Other Versions. (line 87) * source code, gawk: Gawk Distribution. (line 6) -* source code, jawk: Other Versions. (line 96) -* source code, libmawk: Other Versions. (line 104) -* source code, mawk: Other Versions. (line 35) +* source code, jawk: Other Versions. (line 105) +* source code, libmawk: Other Versions. (line 113) +* source code, mawk: Other Versions. (line 44) * source code, mixing: Options. (line 108) -* source code, pawk: Other Versions. (line 69) -* source code, QSE Awk: Other Versions. (line 108) -* source code, QuikTrim Awk: Other Versions. (line 112) -* source code, Solaris awk: Other Versions. (line 86) -* source code, xgawk: Other Versions. (line 119) +* source code, pawk: Other Versions. (line 78) +* source code, QSE Awk: Other Versions. (line 117) +* source code, QuikTrim Awk: Other Versions. (line 121) +* source code, Solaris awk: Other Versions. (line 95) +* source code, xgawk: Other Versions. (line 128) * source files, search path for: Igawk Program. (line 368) * sparse arrays: Array Intro. (line 71) * Spencer, Henry: Glossary. (line 12) @@ -27241,7 +27250,7 @@ Index * SUBSEP variable, multidimensional arrays: Multi-dimensional. (line 16) * substr() function: String Functions. (line 481) -* Sumner, Andrew: Other Versions. (line 55) +* Sumner, Andrew: Other Versions. (line 64) * switch statement: Switch Statement. (line 6) * syntactic ambiguity: /= operator vs. /=.../ regexp constant: Assignment Ops. (line 148) @@ -27458,7 +27467,7 @@ Index * words, usage counts, generating: Word Sorting. (line 6) * wstlen internal variable: Internals. (line 61) * wstptr internal variable: Internals. (line 61) -* xgawk: Other Versions. (line 119) +* xgawk: Other Versions. (line 128) * xgettext utility: String Extraction. (line 13) * XML (eXtensible Markup Language): Internals. (line 160) * XOR bitwise operation: Bitwise Functions. (line 6) @@ -27497,419 +27506,419 @@ Index Tag Table: -Node: Top1352 -Node: Foreword30282 -Node: Preface34627 -Ref: Preface-Footnote-137680 -Ref: Preface-Footnote-237786 -Node: History38018 -Node: Names40409 -Ref: Names-Footnote-141886 -Node: This Manual41958 -Ref: This Manual-Footnote-146905 -Node: Conventions47005 -Node: Manual History49139 -Ref: Manual History-Footnote-152409 -Ref: Manual History-Footnote-252450 -Node: How To Contribute52524 -Node: Acknowledgments53668 -Node: Getting Started57999 -Node: Running gawk60378 -Node: One-shot61564 -Node: Read Terminal62789 -Ref: Read Terminal-Footnote-164439 -Ref: Read Terminal-Footnote-264715 -Node: Long64886 -Node: Executable Scripts66262 -Ref: Executable Scripts-Footnote-168131 -Ref: Executable Scripts-Footnote-268233 -Node: Comments68780 -Node: Quoting71247 -Node: DOS Quoting75870 -Node: Sample Data Files76545 -Node: Very Simple79577 -Node: Two Rules84176 -Node: More Complex86323 -Ref: More Complex-Footnote-189253 -Node: Statements/Lines89338 -Ref: Statements/Lines-Footnote-193800 -Node: Other Features94065 -Node: When94993 -Node: Invoking Gawk97140 -Node: Command Line98525 -Node: Options99308 -Ref: Options-Footnote-1112852 -Node: Other Arguments112877 -Node: Naming Standard Input115535 -Node: Environment Variables116629 -Node: AWKPATH Variable117073 -Ref: AWKPATH Variable-Footnote-1119670 -Node: Other Environment Variables119930 -Node: Exit Status122270 -Node: Include Files122945 -Node: Obsolete126430 -Node: Undocumented127116 -Node: Regexp127357 -Node: Regexp Usage128746 -Node: Escape Sequences130772 -Node: Regexp Operators136535 -Ref: Regexp Operators-Footnote-1143915 -Ref: Regexp Operators-Footnote-2144062 -Node: Bracket Expressions144160 -Ref: table-char-classes146050 -Node: GNU Regexp Operators148573 -Node: Case-sensitivity152296 -Ref: Case-sensitivity-Footnote-1155264 -Ref: Case-sensitivity-Footnote-2155499 -Node: Leftmost Longest155607 -Node: Computed Regexps156808 -Node: Reading Files160218 -Node: Records162159 -Ref: Records-Footnote-1171083 -Node: Fields171120 -Ref: Fields-Footnote-1174153 -Node: Nonconstant Fields174239 -Node: Changing Fields176441 -Node: Field Separators182422 -Node: Default Field Splitting185051 -Node: Regexp Field Splitting186168 -Node: Single Character Fields189510 -Node: Command Line Field Separator190569 -Node: Field Splitting Summary194010 -Ref: Field Splitting Summary-Footnote-1197202 -Node: Constant Size197303 -Node: Splitting By Content201887 -Ref: Splitting By Content-Footnote-1205613 -Node: Multiple Line205653 -Ref: Multiple Line-Footnote-1211500 -Node: Getline211679 -Node: Plain Getline213907 -Node: Getline/Variable215996 -Node: Getline/File217137 -Node: Getline/Variable/File218459 -Ref: Getline/Variable/File-Footnote-1220058 -Node: Getline/Pipe220145 -Node: Getline/Variable/Pipe222705 -Node: Getline/Coprocess223812 -Node: Getline/Variable/Coprocess225055 -Node: Getline Notes225769 -Node: Getline Summary228556 -Ref: table-getline-variants228899 -Node: Command line directories229755 -Node: Printing230380 -Node: Print232011 -Node: Print Examples233348 -Node: Output Separators236132 -Node: OFMT237892 -Node: Printf239250 -Node: Basic Printf240156 -Node: Control Letters241695 -Node: Format Modifiers245507 -Node: Printf Examples251516 -Node: Redirection254231 -Node: Special Files261215 -Node: Special FD261748 -Ref: Special FD-Footnote-1265373 -Node: Special Network265447 -Node: Special Caveats266297 -Node: Close Files And Pipes267093 -Ref: Close Files And Pipes-Footnote-1274116 -Ref: Close Files And Pipes-Footnote-2274264 -Node: Expressions274414 -Node: Values275546 -Node: Constants276222 -Node: Scalar Constants276902 -Ref: Scalar Constants-Footnote-1277761 -Node: Nondecimal-numbers277943 -Node: Regexp Constants281002 -Node: Using Constant Regexps281477 -Node: Variables284532 -Node: Using Variables285187 -Node: Assignment Options286911 -Node: Conversion288783 -Ref: table-locale-affects294159 -Ref: Conversion-Footnote-1294783 -Node: All Operators294892 -Node: Arithmetic Ops295522 -Node: Concatenation298027 -Ref: Concatenation-Footnote-1300820 -Node: Assignment Ops300940 -Ref: table-assign-ops305928 -Node: Increment Ops307336 -Node: Truth Values and Conditions310806 -Node: Truth Values311889 -Node: Typing and Comparison312938 -Node: Variable Typing313727 -Ref: Variable Typing-Footnote-1317624 -Node: Comparison Operators317746 -Ref: table-relational-ops318156 -Node: POSIX String Comparison321705 -Ref: POSIX String Comparison-Footnote-1322661 -Node: Boolean Ops322799 -Ref: Boolean Ops-Footnote-1326877 -Node: Conditional Exp326968 -Node: Function Calls328700 -Node: Precedence332294 -Node: Locales335963 -Node: Patterns and Actions337052 -Node: Pattern Overview338106 -Node: Regexp Patterns339775 -Node: Expression Patterns340318 -Node: Ranges344003 -Node: BEGIN/END346969 -Node: Using BEGIN/END347731 -Ref: Using BEGIN/END-Footnote-1350462 -Node: I/O And BEGIN/END350568 -Node: BEGINFILE/ENDFILE352850 -Node: Empty355743 -Node: Using Shell Variables356059 -Node: Action Overview358344 -Node: Statements360701 -Node: If Statement362555 -Node: While Statement364054 -Node: Do Statement366098 -Node: For Statement367254 -Node: Switch Statement370406 -Node: Break Statement372503 -Node: Continue Statement374493 -Node: Next Statement376286 -Node: Nextfile Statement378676 -Node: Exit Statement381317 -Node: Built-in Variables383733 -Node: User-modified384828 -Ref: User-modified-Footnote-1392854 -Node: Auto-set392916 -Ref: Auto-set-Footnote-1402207 -Node: ARGC and ARGV402412 -Node: Arrays406263 -Node: Array Basics407768 -Node: Array Intro408594 -Node: Reference to Elements412912 -Node: Assigning Elements415182 -Node: Array Example415673 -Node: Scanning an Array417405 -Node: Controlling Scanning419719 -Ref: Controlling Scanning-Footnote-1424652 -Node: Delete424968 -Ref: Delete-Footnote-1427733 -Node: Numeric Array Subscripts427790 -Node: Uninitialized Subscripts429973 -Node: Multi-dimensional431601 -Node: Multi-scanning434695 -Node: Arrays of Arrays436286 -Node: Functions440931 -Node: Built-in441753 -Node: Calling Built-in442831 -Node: Numeric Functions444819 -Ref: Numeric Functions-Footnote-1448651 -Ref: Numeric Functions-Footnote-2449008 -Ref: Numeric Functions-Footnote-3449056 -Node: String Functions449325 -Ref: String Functions-Footnote-1472822 -Ref: String Functions-Footnote-2472951 -Ref: String Functions-Footnote-3473199 -Node: Gory Details473286 -Ref: table-sub-escapes474965 -Ref: table-sub-posix-92476319 -Ref: table-sub-proposed477662 -Ref: table-posix-sub479012 -Ref: table-gensub-escapes480558 -Ref: Gory Details-Footnote-1481765 -Ref: Gory Details-Footnote-2481816 -Node: I/O Functions481967 -Ref: I/O Functions-Footnote-1489072 -Node: Time Functions489219 -Ref: Time Functions-Footnote-1500111 -Ref: Time Functions-Footnote-2500179 -Ref: Time Functions-Footnote-3500337 -Ref: Time Functions-Footnote-4500448 -Ref: Time Functions-Footnote-5500560 -Ref: Time Functions-Footnote-6500787 -Node: Bitwise Functions501053 -Ref: table-bitwise-ops501611 -Ref: Bitwise Functions-Footnote-1505771 -Node: Type Functions505955 -Node: I18N Functions506425 -Node: User-defined508052 -Node: Definition Syntax508856 -Ref: Definition Syntax-Footnote-1513766 -Node: Function Example513835 -Node: Function Caveats516429 -Node: Calling A Function516850 -Node: Variable Scope517965 -Node: Pass By Value/Reference519940 -Node: Return Statement523380 -Node: Dynamic Typing526361 -Node: Indirect Calls527096 -Node: Internationalization536781 -Node: I18N and L10N538207 -Node: Explaining gettext538893 -Ref: Explaining gettext-Footnote-1543959 -Ref: Explaining gettext-Footnote-2544143 -Node: Programmer i18n544308 -Node: Translator i18n548508 -Node: String Extraction549301 -Ref: String Extraction-Footnote-1550262 -Node: Printf Ordering550348 -Ref: Printf Ordering-Footnote-1553132 -Node: I18N Portability553196 -Ref: I18N Portability-Footnote-1555645 -Node: I18N Example555708 -Ref: I18N Example-Footnote-1558343 -Node: Gawk I18N558415 -Node: Advanced Features559032 -Node: Nondecimal Data560545 -Node: Array Sorting562128 -Node: Controlling Array Traversal562825 -Node: Array Sorting Functions571062 -Ref: Array Sorting Functions-Footnote-1574736 -Ref: Array Sorting Functions-Footnote-2574829 -Node: Two-way I/O575023 -Ref: Two-way I/O-Footnote-1580455 -Node: TCP/IP Networking580525 -Node: Profiling583369 -Node: Library Functions590843 -Ref: Library Functions-Footnote-1593850 -Node: Library Names594021 -Ref: Library Names-Footnote-1597492 -Ref: Library Names-Footnote-2597712 -Node: General Functions597798 -Node: Strtonum Function598751 -Node: Assert Function601681 -Node: Round Function605007 -Node: Cliff Random Function606550 -Node: Ordinal Functions607566 -Ref: Ordinal Functions-Footnote-1610636 -Ref: Ordinal Functions-Footnote-2610888 -Node: Join Function611097 -Ref: Join Function-Footnote-1612868 -Node: Gettimeofday Function613068 -Node: Data File Management616783 -Node: Filetrans Function617415 -Node: Rewind Function621554 -Node: File Checking622941 -Node: Empty Files624035 -Node: Ignoring Assigns626265 -Node: Getopt Function627818 -Ref: Getopt Function-Footnote-1639122 -Node: Passwd Functions639325 -Ref: Passwd Functions-Footnote-1648300 -Node: Group Functions648388 -Node: Walking Arrays656472 -Node: Sample Programs658041 -Node: Running Examples658706 -Node: Clones659434 -Node: Cut Program660658 -Node: Egrep Program670503 -Ref: Egrep Program-Footnote-1678276 -Node: Id Program678386 -Node: Split Program682002 -Ref: Split Program-Footnote-1685521 -Node: Tee Program685649 -Node: Uniq Program688452 -Node: Wc Program695881 -Ref: Wc Program-Footnote-1700147 -Ref: Wc Program-Footnote-2700347 -Node: Miscellaneous Programs700439 -Node: Dupword Program701627 -Node: Alarm Program703658 -Node: Translate Program708407 -Ref: Translate Program-Footnote-1712794 -Ref: Translate Program-Footnote-2713022 -Node: Labels Program713156 -Ref: Labels Program-Footnote-1716527 -Node: Word Sorting716611 -Node: History Sorting720495 -Node: Extract Program722334 -Ref: Extract Program-Footnote-1729817 -Node: Simple Sed729945 -Node: Igawk Program733007 -Ref: Igawk Program-Footnote-1748164 -Ref: Igawk Program-Footnote-2748365 -Node: Anagram Program748503 -Node: Signature Program751571 -Node: Debugger752671 -Node: Debugging753582 -Node: Debugging Concepts753995 -Node: Debugging Terms755851 -Node: Awk Debugging758474 -Node: Sample dgawk session759366 -Node: dgawk invocation759858 -Node: Finding The Bug761040 -Node: List of Debugger Commands767526 -Node: Breakpoint Control768837 -Node: Dgawk Execution Control772473 -Node: Viewing And Changing Data775824 -Node: Dgawk Stack779161 -Node: Dgawk Info780621 -Node: Miscellaneous Dgawk Commands784569 -Node: Readline Support789997 -Node: Dgawk Limitations790835 -Node: Language History793024 -Node: V7/SVR3.1794536 -Node: SVR4796857 -Node: POSIX798299 -Node: BTL799307 -Node: POSIX/GNU800112 -Node: Common Extensions805263 -Node: Ranges and Locales806322 -Ref: Ranges and Locales-Footnote-1810940 -Ref: Ranges and Locales-Footnote-2810967 -Ref: Ranges and Locales-Footnote-3811227 -Node: Contributors811448 -Node: Installation815710 -Node: Gawk Distribution816604 -Node: Getting817088 -Node: Extracting817914 -Node: Distribution contents819606 -Node: Unix Installation824867 -Node: Quick Installation825484 -Node: Additional Configuration Options827446 -Node: Configuration Philosophy828923 -Node: Non-Unix Installation831265 -Node: PC Installation831723 -Node: PC Binary Installation833022 -Node: PC Compiling835037 -Node: PC Testing837981 -Node: PC Using839157 -Node: Cygwin843342 -Node: MSYS844342 -Node: VMS Installation844856 -Node: VMS Compilation845459 -Ref: VMS Compilation-Footnote-1846466 -Node: VMS Installation Details846524 -Node: VMS Running848159 -Node: VMS Old Gawk849766 -Node: Bugs850240 -Node: Other Versions854092 -Node: Notes859373 -Node: Compatibility Mode860065 -Node: Additions860848 -Node: Accessing The Source861660 -Node: Adding Code863085 -Node: New Ports869052 -Node: Dynamic Extensions873165 -Node: Internals874541 -Node: Plugin License883644 -Node: Sample Library884278 -Node: Internal File Description884964 -Node: Internal File Ops888679 -Ref: Internal File Ops-Footnote-1893460 -Node: Using Internal File Ops893600 -Node: Future Extensions895977 -Node: Basic Concepts898481 -Node: Basic High Level899238 -Ref: Basic High Level-Footnote-1903273 -Node: Basic Data Typing903458 -Node: Floating Point Issues907983 -Node: String Conversion Precision909066 -Ref: String Conversion Precision-Footnote-1910766 -Node: Unexpected Results910875 -Node: POSIX Floating Point Problems912701 -Ref: POSIX Floating Point Problems-Footnote-1916406 -Node: Glossary916444 -Node: Copying941619 -Node: GNU Free Documentation License979176 -Node: Index1004313 +Node: Top1358 +Node: Foreword30294 +Node: Preface34639 +Ref: Preface-Footnote-137692 +Ref: Preface-Footnote-237798 +Node: History38030 +Node: Names40421 +Ref: Names-Footnote-141898 +Node: This Manual41970 +Ref: This Manual-Footnote-146917 +Node: Conventions47017 +Node: Manual History49151 +Ref: Manual History-Footnote-152421 +Ref: Manual History-Footnote-252462 +Node: How To Contribute52536 +Node: Acknowledgments53680 +Node: Getting Started58011 +Node: Running gawk60390 +Node: One-shot61576 +Node: Read Terminal62801 +Ref: Read Terminal-Footnote-164451 +Ref: Read Terminal-Footnote-264727 +Node: Long64898 +Node: Executable Scripts66274 +Ref: Executable Scripts-Footnote-168143 +Ref: Executable Scripts-Footnote-268245 +Node: Comments68792 +Node: Quoting71259 +Node: DOS Quoting75882 +Node: Sample Data Files76557 +Node: Very Simple79589 +Node: Two Rules84188 +Node: More Complex86335 +Ref: More Complex-Footnote-189265 +Node: Statements/Lines89350 +Ref: Statements/Lines-Footnote-193812 +Node: Other Features94077 +Node: When95005 +Node: Invoking Gawk97152 +Node: Command Line98537 +Node: Options99320 +Ref: Options-Footnote-1112864 +Node: Other Arguments112889 +Node: Naming Standard Input115547 +Node: Environment Variables116641 +Node: AWKPATH Variable117085 +Ref: AWKPATH Variable-Footnote-1119682 +Node: Other Environment Variables119942 +Node: Exit Status122282 +Node: Include Files122957 +Node: Obsolete126442 +Node: Undocumented127128 +Node: Regexp127369 +Node: Regexp Usage128758 +Node: Escape Sequences130784 +Node: Regexp Operators136547 +Ref: Regexp Operators-Footnote-1143927 +Ref: Regexp Operators-Footnote-2144074 +Node: Bracket Expressions144172 +Ref: table-char-classes146062 +Node: GNU Regexp Operators148585 +Node: Case-sensitivity152308 +Ref: Case-sensitivity-Footnote-1155276 +Ref: Case-sensitivity-Footnote-2155511 +Node: Leftmost Longest155619 +Node: Computed Regexps156820 +Node: Reading Files160230 +Node: Records162171 +Ref: Records-Footnote-1171095 +Node: Fields171132 +Ref: Fields-Footnote-1174165 +Node: Nonconstant Fields174251 +Node: Changing Fields176453 +Node: Field Separators182434 +Node: Default Field Splitting185063 +Node: Regexp Field Splitting186180 +Node: Single Character Fields189522 +Node: Command Line Field Separator190581 +Node: Field Splitting Summary194022 +Ref: Field Splitting Summary-Footnote-1197214 +Node: Constant Size197315 +Node: Splitting By Content201899 +Ref: Splitting By Content-Footnote-1205625 +Node: Multiple Line205665 +Ref: Multiple Line-Footnote-1211512 +Node: Getline211691 +Node: Plain Getline213919 +Node: Getline/Variable216008 +Node: Getline/File217149 +Node: Getline/Variable/File218471 +Ref: Getline/Variable/File-Footnote-1220070 +Node: Getline/Pipe220157 +Node: Getline/Variable/Pipe222717 +Node: Getline/Coprocess223824 +Node: Getline/Variable/Coprocess225067 +Node: Getline Notes225781 +Node: Getline Summary228568 +Ref: table-getline-variants228911 +Node: Command line directories229767 +Node: Printing230392 +Node: Print232023 +Node: Print Examples233360 +Node: Output Separators236144 +Node: OFMT237904 +Node: Printf239262 +Node: Basic Printf240168 +Node: Control Letters241707 +Node: Format Modifiers245519 +Node: Printf Examples251528 +Node: Redirection254243 +Node: Special Files261227 +Node: Special FD261760 +Ref: Special FD-Footnote-1265385 +Node: Special Network265459 +Node: Special Caveats266309 +Node: Close Files And Pipes267105 +Ref: Close Files And Pipes-Footnote-1274128 +Ref: Close Files And Pipes-Footnote-2274276 +Node: Expressions274426 +Node: Values275558 +Node: Constants276234 +Node: Scalar Constants276914 +Ref: Scalar Constants-Footnote-1277773 +Node: Nondecimal-numbers277955 +Node: Regexp Constants281014 +Node: Using Constant Regexps281489 +Node: Variables284544 +Node: Using Variables285199 +Node: Assignment Options286923 +Node: Conversion288795 +Ref: table-locale-affects294171 +Ref: Conversion-Footnote-1294795 +Node: All Operators294904 +Node: Arithmetic Ops295534 +Node: Concatenation298039 +Ref: Concatenation-Footnote-1300832 +Node: Assignment Ops300952 +Ref: table-assign-ops305940 +Node: Increment Ops307348 +Node: Truth Values and Conditions310818 +Node: Truth Values311901 +Node: Typing and Comparison312950 +Node: Variable Typing313739 +Ref: Variable Typing-Footnote-1317636 +Node: Comparison Operators317758 +Ref: table-relational-ops318168 +Node: POSIX String Comparison321717 +Ref: POSIX String Comparison-Footnote-1322673 +Node: Boolean Ops322811 +Ref: Boolean Ops-Footnote-1326889 +Node: Conditional Exp326980 +Node: Function Calls328712 +Node: Precedence332306 +Node: Locales335975 +Node: Patterns and Actions337064 +Node: Pattern Overview338118 +Node: Regexp Patterns339787 +Node: Expression Patterns340330 +Node: Ranges344015 +Node: BEGIN/END346981 +Node: Using BEGIN/END347743 +Ref: Using BEGIN/END-Footnote-1350474 +Node: I/O And BEGIN/END350580 +Node: BEGINFILE/ENDFILE352862 +Node: Empty355755 +Node: Using Shell Variables356071 +Node: Action Overview358356 +Node: Statements360713 +Node: If Statement362567 +Node: While Statement364066 +Node: Do Statement366110 +Node: For Statement367266 +Node: Switch Statement370418 +Node: Break Statement372515 +Node: Continue Statement374505 +Node: Next Statement376298 +Node: Nextfile Statement378688 +Node: Exit Statement381329 +Node: Built-in Variables383745 +Node: User-modified384840 +Ref: User-modified-Footnote-1392866 +Node: Auto-set392928 +Ref: Auto-set-Footnote-1402219 +Node: ARGC and ARGV402424 +Node: Arrays406275 +Node: Array Basics407780 +Node: Array Intro408606 +Node: Reference to Elements412924 +Node: Assigning Elements415194 +Node: Array Example415685 +Node: Scanning an Array417417 +Node: Controlling Scanning419731 +Ref: Controlling Scanning-Footnote-1424664 +Node: Delete424980 +Ref: Delete-Footnote-1427745 +Node: Numeric Array Subscripts427802 +Node: Uninitialized Subscripts429985 +Node: Multi-dimensional431613 +Node: Multi-scanning434707 +Node: Arrays of Arrays436298 +Node: Functions440943 +Node: Built-in441765 +Node: Calling Built-in442843 +Node: Numeric Functions444831 +Ref: Numeric Functions-Footnote-1448663 +Ref: Numeric Functions-Footnote-2449020 +Ref: Numeric Functions-Footnote-3449068 +Node: String Functions449337 +Ref: String Functions-Footnote-1472834 +Ref: String Functions-Footnote-2472963 +Ref: String Functions-Footnote-3473211 +Node: Gory Details473298 +Ref: table-sub-escapes474977 +Ref: table-sub-posix-92476331 +Ref: table-sub-proposed477674 +Ref: table-posix-sub479024 +Ref: table-gensub-escapes480570 +Ref: Gory Details-Footnote-1481777 +Ref: Gory Details-Footnote-2481828 +Node: I/O Functions481979 +Ref: I/O Functions-Footnote-1489084 +Node: Time Functions489231 +Ref: Time Functions-Footnote-1500123 +Ref: Time Functions-Footnote-2500191 +Ref: Time Functions-Footnote-3500349 +Ref: Time Functions-Footnote-4500460 +Ref: Time Functions-Footnote-5500572 +Ref: Time Functions-Footnote-6500799 +Node: Bitwise Functions501065 +Ref: table-bitwise-ops501623 +Ref: Bitwise Functions-Footnote-1505783 +Node: Type Functions505967 +Node: I18N Functions506437 +Node: User-defined508064 +Node: Definition Syntax508868 +Ref: Definition Syntax-Footnote-1513778 +Node: Function Example513847 +Node: Function Caveats516441 +Node: Calling A Function516862 +Node: Variable Scope517977 +Node: Pass By Value/Reference519952 +Node: Return Statement523392 +Node: Dynamic Typing526373 +Node: Indirect Calls527108 +Node: Internationalization536793 +Node: I18N and L10N538219 +Node: Explaining gettext538905 +Ref: Explaining gettext-Footnote-1543971 +Ref: Explaining gettext-Footnote-2544155 +Node: Programmer i18n544320 +Node: Translator i18n548520 +Node: String Extraction549313 +Ref: String Extraction-Footnote-1550274 +Node: Printf Ordering550360 +Ref: Printf Ordering-Footnote-1553144 +Node: I18N Portability553208 +Ref: I18N Portability-Footnote-1555657 +Node: I18N Example555720 +Ref: I18N Example-Footnote-1558355 +Node: Gawk I18N558427 +Node: Advanced Features559044 +Node: Nondecimal Data560557 +Node: Array Sorting562140 +Node: Controlling Array Traversal562837 +Node: Array Sorting Functions571074 +Ref: Array Sorting Functions-Footnote-1574748 +Ref: Array Sorting Functions-Footnote-2574841 +Node: Two-way I/O575035 +Ref: Two-way I/O-Footnote-1580467 +Node: TCP/IP Networking580537 +Node: Profiling583381 +Node: Library Functions590855 +Ref: Library Functions-Footnote-1593862 +Node: Library Names594033 +Ref: Library Names-Footnote-1597504 +Ref: Library Names-Footnote-2597724 +Node: General Functions597810 +Node: Strtonum Function598763 +Node: Assert Function601693 +Node: Round Function605019 +Node: Cliff Random Function606562 +Node: Ordinal Functions607578 +Ref: Ordinal Functions-Footnote-1610648 +Ref: Ordinal Functions-Footnote-2610900 +Node: Join Function611109 +Ref: Join Function-Footnote-1612880 +Node: Gettimeofday Function613080 +Node: Data File Management616795 +Node: Filetrans Function617427 +Node: Rewind Function621566 +Node: File Checking622953 +Node: Empty Files624047 +Node: Ignoring Assigns626277 +Node: Getopt Function627830 +Ref: Getopt Function-Footnote-1639134 +Node: Passwd Functions639337 +Ref: Passwd Functions-Footnote-1648312 +Node: Group Functions648400 +Node: Walking Arrays656484 +Node: Sample Programs658053 +Node: Running Examples658718 +Node: Clones659446 +Node: Cut Program660670 +Node: Egrep Program670515 +Ref: Egrep Program-Footnote-1678288 +Node: Id Program678398 +Node: Split Program682014 +Ref: Split Program-Footnote-1685533 +Node: Tee Program685661 +Node: Uniq Program688464 +Node: Wc Program695893 +Ref: Wc Program-Footnote-1700159 +Ref: Wc Program-Footnote-2700359 +Node: Miscellaneous Programs700451 +Node: Dupword Program701639 +Node: Alarm Program703670 +Node: Translate Program708419 +Ref: Translate Program-Footnote-1712806 +Ref: Translate Program-Footnote-2713034 +Node: Labels Program713168 +Ref: Labels Program-Footnote-1716539 +Node: Word Sorting716623 +Node: History Sorting720507 +Node: Extract Program722346 +Ref: Extract Program-Footnote-1729829 +Node: Simple Sed729957 +Node: Igawk Program733019 +Ref: Igawk Program-Footnote-1748176 +Ref: Igawk Program-Footnote-2748377 +Node: Anagram Program748515 +Node: Signature Program751583 +Node: Debugger752683 +Node: Debugging753594 +Node: Debugging Concepts754007 +Node: Debugging Terms755863 +Node: Awk Debugging758486 +Node: Sample dgawk session759378 +Node: dgawk invocation759870 +Node: Finding The Bug761052 +Node: List of Debugger Commands767538 +Node: Breakpoint Control768849 +Node: Dgawk Execution Control772485 +Node: Viewing And Changing Data775836 +Node: Dgawk Stack779173 +Node: Dgawk Info780633 +Node: Miscellaneous Dgawk Commands784581 +Node: Readline Support790009 +Node: Dgawk Limitations790847 +Node: Language History793036 +Node: V7/SVR3.1794548 +Node: SVR4796869 +Node: POSIX798311 +Node: BTL799319 +Node: POSIX/GNU800124 +Node: Common Extensions805275 +Node: Ranges and Locales806334 +Ref: Ranges and Locales-Footnote-1810952 +Ref: Ranges and Locales-Footnote-2810979 +Ref: Ranges and Locales-Footnote-3811239 +Node: Contributors811460 +Node: Installation815722 +Node: Gawk Distribution816616 +Node: Getting817100 +Node: Extracting817926 +Node: Distribution contents819618 +Node: Unix Installation824879 +Node: Quick Installation825496 +Node: Additional Configuration Options827458 +Node: Configuration Philosophy828935 +Node: Non-Unix Installation831277 +Node: PC Installation831735 +Node: PC Binary Installation833034 +Node: PC Compiling835049 +Node: PC Testing837993 +Node: PC Using839169 +Node: Cygwin843354 +Node: MSYS844354 +Node: VMS Installation844868 +Node: VMS Compilation845471 +Ref: VMS Compilation-Footnote-1846478 +Node: VMS Installation Details846536 +Node: VMS Running848171 +Node: VMS Old Gawk849778 +Node: Bugs850252 +Node: Other Versions854104 +Node: Notes859736 +Node: Compatibility Mode860428 +Node: Additions861211 +Node: Accessing The Source862023 +Node: Adding Code863448 +Node: New Ports869415 +Node: Dynamic Extensions873528 +Node: Internals874904 +Node: Plugin License884007 +Node: Sample Library884641 +Node: Internal File Description885327 +Node: Internal File Ops889042 +Ref: Internal File Ops-Footnote-1893823 +Node: Using Internal File Ops893963 +Node: Future Extensions896340 +Node: Basic Concepts898844 +Node: Basic High Level899601 +Ref: Basic High Level-Footnote-1903636 +Node: Basic Data Typing903821 +Node: Floating Point Issues908346 +Node: String Conversion Precision909429 +Ref: String Conversion Precision-Footnote-1911129 +Node: Unexpected Results911238 +Node: POSIX Floating Point Problems913064 +Ref: POSIX Floating Point Problems-Footnote-1916769 +Node: Glossary916807 +Node: Copying941982 +Node: GNU Free Documentation License979539 +Node: Index1004676 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index f620047a..90658dc3 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -20,7 +20,7 @@ @c applies to and all the info about who's publishing this edition @c These apply across the board. -@set UPDATE-MONTH December, 2012 +@set UPDATE-MONTH January, 2013 @set VERSION 4.0 @set PATCHLEVEL 2 @@ -152,7 +152,7 @@ Some comments on the layout for TeX. @copying Copyright @copyright{} 1989, 1991, 1992, 1993, 1996, 1997, 1998, 1999, -2000, 2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012 +2000, 2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012, 2013 Free Software Foundation, Inc. @sp 2 @@ -28591,6 +28591,18 @@ It is available in several archive formats: @uref{http://www.cs.princeton.edu/~bwk/btl.mirror/awk.zip} @end table +You can also retrieve it from Git Hub: + +@example +git clone git://github.com/onetrueawk/awk bwkawk +@end example + +@noindent +The above command creates a copy of the @uref{http://www.git-scm.com, Git} +repository in a directory named @file{bwkawk}. If you leave that argument +off the @command{git} command line, the repository copy is created in a +directory named @file{awk}. + This version requires an ISO C (1990 standard) compiler; the C compiler from GCC (the GNU Compiler Collection) |