diff options
| -rw-r--r-- | doc/gawk.info | 860 | ||||
| -rw-r--r-- | doc/gawk.texi | 17 |
2 files changed, 444 insertions, 433 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 8d9422f2..bfaca25b 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -10,8 +10,8 @@ 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 Free Software -Foundation, Inc. +2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012 Free +Software Foundation, Inc. This is Edition 4 of `GAWK: Effective AWK Programming: A User's @@ -42,8 +42,8 @@ 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 Free Software -Foundation, Inc. +2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012 Free +Software Foundation, Inc. This is Edition 4 of `GAWK: Effective AWK Programming: A User's @@ -1393,7 +1393,8 @@ pass to that interpreter. The operating system then runs the interpreter with the given argument and the full argument list of the executed program. The first argument in the list is the full file name of the `awk' program. The rest of the argument list contains either -options to `awk', or data files, or both. +options to `awk', or data files, or both. Note that on many systems +`awk' may be found in `/usr/bin' instead of in `/bin'. Caveat Emptor. File: gawk.info, Node: Comments, Next: Quoting, Prev: Executable Scripts, Up: Running gawk @@ -10554,7 +10555,8 @@ with numbers. Optional parameters are enclosed in square brackets ([ ]): `atan2(Y, X)' - Return the arctangent of `Y / X' in radians. + Return the arctangent of `Y / X' in radians. You can use `pi = + atan2(0, -1)' to retrieve the value of pi. `cos(X)' Return the cosine of X, with X in radians. @@ -25390,7 +25392,7 @@ Index * coprocesses, closing: Close Files And Pipes. (line 6) * coprocesses, getline from: Getline/Coprocess. (line 6) -* cos() function: Numeric Functions. (line 14) +* cos() function: Numeric Functions. (line 15) * counting: Wc Program. (line 6) * csh utility: Statements/Lines. (line 44) * csh utility, POSIXLY_CORRECT environment variable: Options. (line 305) @@ -25751,7 +25753,7 @@ Index * exclamation point (!), !~ operator: Regexp Usage. (line 19) * exit statement: Exit Statement. (line 6) * exit status, of gawk: Exit Status. (line 6) -* exp() function: Numeric Functions. (line 17) +* exp() function: Numeric Functions. (line 18) * expand utility: Very Simple. (line 69) * expressions: Expressions. (line 6) * expressions, as patterns: Expression Patterns. (line 6) @@ -26254,7 +26256,7 @@ Index * installation, VMS: VMS Installation. (line 6) * installing gawk: Installation. (line 6) * INT signal (MS-Windows): Profiling. (line 207) -* int() function: Numeric Functions. (line 22) +* int() function: Numeric Functions. (line 23) * integers: Basic Data Typing. (line 21) * integers, unsigned: Basic Data Typing. (line 30) * interacting with other programs: I/O Functions. (line 63) @@ -26422,7 +26424,7 @@ Index * localization, See internationalization, localization: I18N and L10N. (line 6) * log files, timestamps in: Time Functions. (line 6) -* log() function: Numeric Functions. (line 29) +* log() function: Numeric Functions. (line 30) * logical false/true: Truth Values. (line 6) * logical operators, See Boolean expressions: Boolean Ops. (line 6) * login information: Passwd Functions. (line 16) @@ -26554,7 +26556,7 @@ Index * numbers, hexadecimal: Nondecimal-numbers. (line 6) * numbers, NODE internal type: Internals. (line 23) * numbers, octal: Nondecimal-numbers. (line 6) -* numbers, random: Numeric Functions. (line 63) +* numbers, random: Numeric Functions. (line 64) * numbers, rounding: Round Function. (line 6) * numeric, constants: Scalar Constants. (line 6) * numeric, output format: OFMT. (line 6) @@ -26860,12 +26862,12 @@ Index * r debugger command (alias for run): Dgawk Execution Control. (line 62) * Rakitzis, Byron: History Sorting. (line 25) -* rand() function: Numeric Functions. (line 33) +* rand() function: Numeric Functions. (line 34) * random numbers, Cliff: Cliff Random Function. (line 6) * random numbers, rand()/srand() functions: Numeric Functions. - (line 33) -* random numbers, seed of: Numeric Functions. (line 63) + (line 34) +* random numbers, seed of: Numeric Functions. (line 64) * range expressions (regexps): Bracket Expressions. (line 6) * range patterns: Ranges. (line 6) * Rankin, Pat <1>: Bugs. (line 72) @@ -27068,7 +27070,7 @@ Index * SIGUSR1 signal: Profiling. (line 182) * silent debugger command: Dgawk Execution Control. (line 10) -* sin() function: Numeric Functions. (line 74) +* sin() function: Numeric Functions. (line 75) * single precision floating-point: Basic Data Typing. (line 36) * single quote (') <1>: Quoting. (line 31) * single quote (') <2>: Long. (line 33) @@ -27111,9 +27113,9 @@ Index * sprintf() function, OFMT variable and: User-modified. (line 124) * sprintf() function, print/printf statements and: Round Function. (line 6) -* sqrt() function: Numeric Functions. (line 77) +* sqrt() function: Numeric Functions. (line 78) * square brackets ([]): Regexp Operators. (line 55) -* srand() function: Numeric Functions. (line 81) +* srand() function: Numeric Functions. (line 82) * Stallman, Richard <1>: Glossary. (line 301) * Stallman, Richard <2>: Contributors. (line 24) * Stallman, Richard <3>: Acknowledgments. (line 18) @@ -27432,417 +27434,417 @@ Index Tag Table: -Node: Top1346 -Node: Foreword30270 -Node: Preface34615 -Ref: Preface-Footnote-137668 -Ref: Preface-Footnote-237774 -Node: History38006 -Node: Names40397 -Ref: Names-Footnote-141874 -Node: This Manual41946 -Ref: This Manual-Footnote-146893 -Node: Conventions46993 -Node: Manual History49127 -Ref: Manual History-Footnote-152397 -Ref: Manual History-Footnote-252438 -Node: How To Contribute52512 -Node: Acknowledgments53656 -Node: Getting Started57987 -Node: Running gawk60366 -Node: One-shot61552 -Node: Read Terminal62777 -Ref: Read Terminal-Footnote-164427 -Ref: Read Terminal-Footnote-264703 -Node: Long64874 -Node: Executable Scripts66250 -Ref: Executable Scripts-Footnote-168119 -Ref: Executable Scripts-Footnote-268221 -Node: Comments68672 -Node: Quoting71139 -Node: DOS Quoting75762 -Node: Sample Data Files76437 -Node: Very Simple79469 -Node: Two Rules84068 -Node: More Complex86215 -Ref: More Complex-Footnote-189145 -Node: Statements/Lines89230 -Ref: Statements/Lines-Footnote-193692 -Node: Other Features93957 -Node: When94885 -Node: Invoking Gawk97032 -Node: Command Line98417 -Node: Options99200 -Ref: Options-Footnote-1112637 -Node: Other Arguments112662 -Node: Naming Standard Input115320 -Node: Environment Variables116414 -Node: AWKPATH Variable116858 -Ref: AWKPATH Variable-Footnote-1119455 -Node: Other Environment Variables119715 -Node: Exit Status122055 -Node: Include Files122730 -Node: Obsolete126215 -Node: Undocumented126901 -Node: Regexp127142 -Node: Regexp Usage128531 -Node: Escape Sequences130557 -Node: Regexp Operators136320 -Ref: Regexp Operators-Footnote-1143517 -Ref: Regexp Operators-Footnote-2143664 -Node: Bracket Expressions143762 -Ref: table-char-classes145652 -Node: GNU Regexp Operators148175 -Node: Case-sensitivity151898 -Ref: Case-sensitivity-Footnote-1154866 -Ref: Case-sensitivity-Footnote-2155101 -Node: Leftmost Longest155209 -Node: Computed Regexps156410 -Node: Reading Files159820 -Node: Records161761 -Ref: Records-Footnote-1170435 -Node: Fields170472 -Ref: Fields-Footnote-1173505 -Node: Nonconstant Fields173591 -Node: Changing Fields175793 -Node: Field Separators181774 -Node: Default Field Splitting184403 -Node: Regexp Field Splitting185520 -Node: Single Character Fields188862 -Node: Command Line Field Separator189921 -Node: Field Splitting Summary193362 -Ref: Field Splitting Summary-Footnote-1196554 -Node: Constant Size196655 -Node: Splitting By Content201239 -Ref: Splitting By Content-Footnote-1204965 -Node: Multiple Line205005 -Ref: Multiple Line-Footnote-1210852 -Node: Getline211031 -Node: Plain Getline213259 -Node: Getline/Variable215348 -Node: Getline/File216489 -Node: Getline/Variable/File217811 -Ref: Getline/Variable/File-Footnote-1219410 -Node: Getline/Pipe219497 -Node: Getline/Variable/Pipe222057 -Node: Getline/Coprocess223164 -Node: Getline/Variable/Coprocess224407 -Node: Getline Notes225121 -Node: Getline Summary227063 -Ref: table-getline-variants227406 -Node: Command line directories228262 -Node: Printing228887 -Node: Print230518 -Node: Print Examples231855 -Node: Output Separators234639 -Node: OFMT236399 -Node: Printf237757 -Node: Basic Printf238663 -Node: Control Letters240202 -Node: Format Modifiers244014 -Node: Printf Examples250023 -Node: Redirection252738 -Node: Special Files259722 -Node: Special FD260255 -Ref: Special FD-Footnote-1263880 -Node: Special Network263954 -Node: Special Caveats264804 -Node: Close Files And Pipes265600 -Ref: Close Files And Pipes-Footnote-1272623 -Ref: Close Files And Pipes-Footnote-2272771 -Node: Expressions272921 -Node: Values274053 -Node: Constants274729 -Node: Scalar Constants275409 -Ref: Scalar Constants-Footnote-1276268 -Node: Nondecimal-numbers276450 -Node: Regexp Constants279509 -Node: Using Constant Regexps279984 -Node: Variables283039 -Node: Using Variables283694 -Node: Assignment Options285418 -Node: Conversion287290 -Ref: table-locale-affects292666 -Ref: Conversion-Footnote-1293290 -Node: All Operators293399 -Node: Arithmetic Ops294029 -Node: Concatenation296534 -Ref: Concatenation-Footnote-1299327 -Node: Assignment Ops299447 -Ref: table-assign-ops304435 -Node: Increment Ops305843 -Node: Truth Values and Conditions309313 -Node: Truth Values310396 -Node: Typing and Comparison311445 -Node: Variable Typing312234 -Ref: Variable Typing-Footnote-1316131 -Node: Comparison Operators316253 -Ref: table-relational-ops316663 -Node: POSIX String Comparison320212 -Ref: POSIX String Comparison-Footnote-1321168 -Node: Boolean Ops321306 -Ref: Boolean Ops-Footnote-1325384 -Node: Conditional Exp325475 -Node: Function Calls327207 -Node: Precedence330801 -Node: Locales334470 -Node: Patterns and Actions335559 -Node: Pattern Overview336613 -Node: Regexp Patterns338282 -Node: Expression Patterns338825 -Node: Ranges342510 -Node: BEGIN/END345476 -Node: Using BEGIN/END346238 -Ref: Using BEGIN/END-Footnote-1348969 -Node: I/O And BEGIN/END349075 -Node: BEGINFILE/ENDFILE351357 -Node: Empty354250 -Node: Using Shell Variables354566 -Node: Action Overview356851 -Node: Statements359208 -Node: If Statement361062 -Node: While Statement362561 -Node: Do Statement364605 -Node: For Statement365761 -Node: Switch Statement368913 -Node: Break Statement371010 -Node: Continue Statement373000 -Node: Next Statement374793 -Node: Nextfile Statement377183 -Node: Exit Statement379728 -Node: Built-in Variables382144 -Node: User-modified383239 -Ref: User-modified-Footnote-1391265 -Node: Auto-set391327 -Ref: Auto-set-Footnote-1400618 -Node: ARGC and ARGV400823 -Node: Arrays404674 -Node: Array Basics406179 -Node: Array Intro407005 -Node: Reference to Elements411323 -Node: Assigning Elements413593 -Node: Array Example414084 -Node: Scanning an Array415816 -Node: Controlling Scanning418130 -Ref: Controlling Scanning-Footnote-1423063 -Node: Delete423379 -Ref: Delete-Footnote-1425814 -Node: Numeric Array Subscripts425871 -Node: Uninitialized Subscripts428054 -Node: Multi-dimensional429682 -Node: Multi-scanning432776 -Node: Arrays of Arrays434367 -Node: Functions439012 -Node: Built-in439834 -Node: Calling Built-in440912 -Node: Numeric Functions442900 -Ref: Numeric Functions-Footnote-1446665 -Ref: Numeric Functions-Footnote-2447022 -Ref: Numeric Functions-Footnote-3447070 -Node: String Functions447339 -Ref: String Functions-Footnote-1470836 -Ref: String Functions-Footnote-2470965 -Ref: String Functions-Footnote-3471213 -Node: Gory Details471300 -Ref: table-sub-escapes472979 -Ref: table-sub-posix-92474333 -Ref: table-sub-proposed475676 -Ref: table-posix-sub477026 -Ref: table-gensub-escapes478572 -Ref: Gory Details-Footnote-1479779 -Ref: Gory Details-Footnote-2479830 -Node: I/O Functions479981 -Ref: I/O Functions-Footnote-1486636 -Node: Time Functions486783 -Ref: Time Functions-Footnote-1497675 -Ref: Time Functions-Footnote-2497743 -Ref: Time Functions-Footnote-3497901 -Ref: Time Functions-Footnote-4498012 -Ref: Time Functions-Footnote-5498124 -Ref: Time Functions-Footnote-6498351 -Node: Bitwise Functions498617 -Ref: table-bitwise-ops499175 -Ref: Bitwise Functions-Footnote-1503335 -Node: Type Functions503519 -Node: I18N Functions503989 -Node: User-defined505616 -Node: Definition Syntax506420 -Ref: Definition Syntax-Footnote-1511330 -Node: Function Example511399 -Node: Function Caveats513993 -Node: Calling A Function514414 -Node: Variable Scope515529 -Node: Pass By Value/Reference517504 -Node: Return Statement520944 -Node: Dynamic Typing523925 -Node: Indirect Calls524660 -Node: Internationalization534345 -Node: I18N and L10N535771 -Node: Explaining gettext536457 -Ref: Explaining gettext-Footnote-1541523 -Ref: Explaining gettext-Footnote-2541707 -Node: Programmer i18n541872 -Node: Translator i18n546072 -Node: String Extraction546865 -Ref: String Extraction-Footnote-1547826 -Node: Printf Ordering547912 -Ref: Printf Ordering-Footnote-1550696 -Node: I18N Portability550760 -Ref: I18N Portability-Footnote-1553209 -Node: I18N Example553272 -Ref: I18N Example-Footnote-1555907 -Node: Gawk I18N555979 -Node: Advanced Features556596 -Node: Nondecimal Data558109 -Node: Array Sorting559692 -Node: Controlling Array Traversal560389 -Node: Array Sorting Functions568626 -Ref: Array Sorting Functions-Footnote-1572300 -Ref: Array Sorting Functions-Footnote-2572393 -Node: Two-way I/O572587 -Ref: Two-way I/O-Footnote-1578019 -Node: TCP/IP Networking578089 -Node: Profiling580933 -Node: Library Functions588407 -Ref: Library Functions-Footnote-1591414 -Node: Library Names591585 -Ref: Library Names-Footnote-1595056 -Ref: Library Names-Footnote-2595276 -Node: General Functions595362 -Node: Strtonum Function596315 -Node: Assert Function599245 -Node: Round Function602571 -Node: Cliff Random Function604114 -Node: Ordinal Functions605130 -Ref: Ordinal Functions-Footnote-1608200 -Ref: Ordinal Functions-Footnote-2608452 -Node: Join Function608661 -Ref: Join Function-Footnote-1610432 -Node: Gettimeofday Function610632 -Node: Data File Management614347 -Node: Filetrans Function614979 -Node: Rewind Function619118 -Node: File Checking620505 -Node: Empty Files621599 -Node: Ignoring Assigns623829 -Node: Getopt Function625382 -Ref: Getopt Function-Footnote-1636686 -Node: Passwd Functions636889 -Ref: Passwd Functions-Footnote-1645864 -Node: Group Functions645952 -Node: Walking Arrays654036 -Node: Sample Programs655605 -Node: Running Examples656270 -Node: Clones656998 -Node: Cut Program658222 -Node: Egrep Program668067 -Ref: Egrep Program-Footnote-1675840 -Node: Id Program675950 -Node: Split Program679566 -Ref: Split Program-Footnote-1683085 -Node: Tee Program683213 -Node: Uniq Program686016 -Node: Wc Program693445 -Ref: Wc Program-Footnote-1697711 -Ref: Wc Program-Footnote-2697911 -Node: Miscellaneous Programs698003 -Node: Dupword Program699191 -Node: Alarm Program701222 -Node: Translate Program705971 -Ref: Translate Program-Footnote-1710358 -Ref: Translate Program-Footnote-2710586 -Node: Labels Program710720 -Ref: Labels Program-Footnote-1714091 -Node: Word Sorting714175 -Node: History Sorting718059 -Node: Extract Program719898 -Ref: Extract Program-Footnote-1727381 -Node: Simple Sed727509 -Node: Igawk Program730571 -Ref: Igawk Program-Footnote-1745728 -Ref: Igawk Program-Footnote-2745929 -Node: Anagram Program746067 -Node: Signature Program749135 -Node: Debugger750235 -Node: Debugging751146 -Node: Debugging Concepts751559 -Node: Debugging Terms753415 -Node: Awk Debugging756038 -Node: Sample dgawk session756930 -Node: dgawk invocation757422 -Node: Finding The Bug758604 -Node: List of Debugger Commands765090 -Node: Breakpoint Control766401 -Node: Dgawk Execution Control770037 -Node: Viewing And Changing Data773388 -Node: Dgawk Stack776725 -Node: Dgawk Info778185 -Node: Miscellaneous Dgawk Commands782133 -Node: Readline Support787561 -Node: Dgawk Limitations788399 -Node: Language History790588 -Node: V7/SVR3.1792100 -Node: SVR4794421 -Node: POSIX795863 -Node: BTL796871 -Node: POSIX/GNU797605 -Node: Common Extensions802756 -Node: Ranges and Locales803863 -Ref: Ranges and Locales-Footnote-1808467 -Node: Contributors808688 -Node: Installation812950 -Node: Gawk Distribution813844 -Node: Getting814328 -Node: Extracting815154 -Node: Distribution contents816846 -Node: Unix Installation822068 -Node: Quick Installation822685 -Node: Additional Configuration Options824647 -Node: Configuration Philosophy826124 -Node: Non-Unix Installation828466 -Node: PC Installation828924 -Node: PC Binary Installation830223 -Node: PC Compiling832071 -Node: PC Testing835015 -Node: PC Using836191 -Node: Cygwin840376 -Node: MSYS841376 -Node: VMS Installation841890 -Node: VMS Compilation842493 -Ref: VMS Compilation-Footnote-1843500 -Node: VMS Installation Details843558 -Node: VMS Running845193 -Node: VMS Old Gawk846800 -Node: Bugs847274 -Node: Other Versions851126 -Node: Notes856407 -Node: Compatibility Mode857099 -Node: Additions857882 -Node: Accessing The Source858694 -Node: Adding Code860119 -Node: New Ports866086 -Node: Dynamic Extensions870199 -Node: Internals871575 -Node: Plugin License880678 -Node: Sample Library881312 -Node: Internal File Description881998 -Node: Internal File Ops885713 -Ref: Internal File Ops-Footnote-1890494 -Node: Using Internal File Ops890634 -Node: Future Extensions893011 -Node: Basic Concepts895515 -Node: Basic High Level896272 -Ref: Basic High Level-Footnote-1900307 -Node: Basic Data Typing900492 -Node: Floating Point Issues905017 -Node: String Conversion Precision906100 -Ref: String Conversion Precision-Footnote-1907800 -Node: Unexpected Results907909 -Node: POSIX Floating Point Problems909735 -Ref: POSIX Floating Point Problems-Footnote-1913440 -Node: Glossary913478 -Node: Copying938454 -Node: GNU Free Documentation License976011 -Node: Index1001148 +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-1112745 +Node: Other Arguments112770 +Node: Naming Standard Input115428 +Node: Environment Variables116522 +Node: AWKPATH Variable116966 +Ref: AWKPATH Variable-Footnote-1119563 +Node: Other Environment Variables119823 +Node: Exit Status122163 +Node: Include Files122838 +Node: Obsolete126323 +Node: Undocumented127009 +Node: Regexp127250 +Node: Regexp Usage128639 +Node: Escape Sequences130665 +Node: Regexp Operators136428 +Ref: Regexp Operators-Footnote-1143625 +Ref: Regexp Operators-Footnote-2143772 +Node: Bracket Expressions143870 +Ref: table-char-classes145760 +Node: GNU Regexp Operators148283 +Node: Case-sensitivity152006 +Ref: Case-sensitivity-Footnote-1154974 +Ref: Case-sensitivity-Footnote-2155209 +Node: Leftmost Longest155317 +Node: Computed Regexps156518 +Node: Reading Files159928 +Node: Records161869 +Ref: Records-Footnote-1170543 +Node: Fields170580 +Ref: Fields-Footnote-1173613 +Node: Nonconstant Fields173699 +Node: Changing Fields175901 +Node: Field Separators181882 +Node: Default Field Splitting184511 +Node: Regexp Field Splitting185628 +Node: Single Character Fields188970 +Node: Command Line Field Separator190029 +Node: Field Splitting Summary193470 +Ref: Field Splitting Summary-Footnote-1196662 +Node: Constant Size196763 +Node: Splitting By Content201347 +Ref: Splitting By Content-Footnote-1205073 +Node: Multiple Line205113 +Ref: Multiple Line-Footnote-1210960 +Node: Getline211139 +Node: Plain Getline213367 +Node: Getline/Variable215456 +Node: Getline/File216597 +Node: Getline/Variable/File217919 +Ref: Getline/Variable/File-Footnote-1219518 +Node: Getline/Pipe219605 +Node: Getline/Variable/Pipe222165 +Node: Getline/Coprocess223272 +Node: Getline/Variable/Coprocess224515 +Node: Getline Notes225229 +Node: Getline Summary227171 +Ref: table-getline-variants227514 +Node: Command line directories228370 +Node: Printing228995 +Node: Print230626 +Node: Print Examples231963 +Node: Output Separators234747 +Node: OFMT236507 +Node: Printf237865 +Node: Basic Printf238771 +Node: Control Letters240310 +Node: Format Modifiers244122 +Node: Printf Examples250131 +Node: Redirection252846 +Node: Special Files259830 +Node: Special FD260363 +Ref: Special FD-Footnote-1263988 +Node: Special Network264062 +Node: Special Caveats264912 +Node: Close Files And Pipes265708 +Ref: Close Files And Pipes-Footnote-1272731 +Ref: Close Files And Pipes-Footnote-2272879 +Node: Expressions273029 +Node: Values274161 +Node: Constants274837 +Node: Scalar Constants275517 +Ref: Scalar Constants-Footnote-1276376 +Node: Nondecimal-numbers276558 +Node: Regexp Constants279617 +Node: Using Constant Regexps280092 +Node: Variables283147 +Node: Using Variables283802 +Node: Assignment Options285526 +Node: Conversion287398 +Ref: table-locale-affects292774 +Ref: Conversion-Footnote-1293398 +Node: All Operators293507 +Node: Arithmetic Ops294137 +Node: Concatenation296642 +Ref: Concatenation-Footnote-1299435 +Node: Assignment Ops299555 +Ref: table-assign-ops304543 +Node: Increment Ops305951 +Node: Truth Values and Conditions309421 +Node: Truth Values310504 +Node: Typing and Comparison311553 +Node: Variable Typing312342 +Ref: Variable Typing-Footnote-1316239 +Node: Comparison Operators316361 +Ref: table-relational-ops316771 +Node: POSIX String Comparison320320 +Ref: POSIX String Comparison-Footnote-1321276 +Node: Boolean Ops321414 +Ref: Boolean Ops-Footnote-1325492 +Node: Conditional Exp325583 +Node: Function Calls327315 +Node: Precedence330909 +Node: Locales334578 +Node: Patterns and Actions335667 +Node: Pattern Overview336721 +Node: Regexp Patterns338390 +Node: Expression Patterns338933 +Node: Ranges342618 +Node: BEGIN/END345584 +Node: Using BEGIN/END346346 +Ref: Using BEGIN/END-Footnote-1349077 +Node: I/O And BEGIN/END349183 +Node: BEGINFILE/ENDFILE351465 +Node: Empty354358 +Node: Using Shell Variables354674 +Node: Action Overview356959 +Node: Statements359316 +Node: If Statement361170 +Node: While Statement362669 +Node: Do Statement364713 +Node: For Statement365869 +Node: Switch Statement369021 +Node: Break Statement371118 +Node: Continue Statement373108 +Node: Next Statement374901 +Node: Nextfile Statement377291 +Node: Exit Statement379836 +Node: Built-in Variables382252 +Node: User-modified383347 +Ref: User-modified-Footnote-1391373 +Node: Auto-set391435 +Ref: Auto-set-Footnote-1400726 +Node: ARGC and ARGV400931 +Node: Arrays404782 +Node: Array Basics406287 +Node: Array Intro407113 +Node: Reference to Elements411431 +Node: Assigning Elements413701 +Node: Array Example414192 +Node: Scanning an Array415924 +Node: Controlling Scanning418238 +Ref: Controlling Scanning-Footnote-1423171 +Node: Delete423487 +Ref: Delete-Footnote-1425922 +Node: Numeric Array Subscripts425979 +Node: Uninitialized Subscripts428162 +Node: Multi-dimensional429790 +Node: Multi-scanning432884 +Node: Arrays of Arrays434475 +Node: Functions439120 +Node: Built-in439942 +Node: Calling Built-in441020 +Node: Numeric Functions443008 +Ref: Numeric Functions-Footnote-1446840 +Ref: Numeric Functions-Footnote-2447197 +Ref: Numeric Functions-Footnote-3447245 +Node: String Functions447514 +Ref: String Functions-Footnote-1471011 +Ref: String Functions-Footnote-2471140 +Ref: String Functions-Footnote-3471388 +Node: Gory Details471475 +Ref: table-sub-escapes473154 +Ref: table-sub-posix-92474508 +Ref: table-sub-proposed475851 +Ref: table-posix-sub477201 +Ref: table-gensub-escapes478747 +Ref: Gory Details-Footnote-1479954 +Ref: Gory Details-Footnote-2480005 +Node: I/O Functions480156 +Ref: I/O Functions-Footnote-1486811 +Node: Time Functions486958 +Ref: Time Functions-Footnote-1497850 +Ref: Time Functions-Footnote-2497918 +Ref: Time Functions-Footnote-3498076 +Ref: Time Functions-Footnote-4498187 +Ref: Time Functions-Footnote-5498299 +Ref: Time Functions-Footnote-6498526 +Node: Bitwise Functions498792 +Ref: table-bitwise-ops499350 +Ref: Bitwise Functions-Footnote-1503510 +Node: Type Functions503694 +Node: I18N Functions504164 +Node: User-defined505791 +Node: Definition Syntax506595 +Ref: Definition Syntax-Footnote-1511505 +Node: Function Example511574 +Node: Function Caveats514168 +Node: Calling A Function514589 +Node: Variable Scope515704 +Node: Pass By Value/Reference517679 +Node: Return Statement521119 +Node: Dynamic Typing524100 +Node: Indirect Calls524835 +Node: Internationalization534520 +Node: I18N and L10N535946 +Node: Explaining gettext536632 +Ref: Explaining gettext-Footnote-1541698 +Ref: Explaining gettext-Footnote-2541882 +Node: Programmer i18n542047 +Node: Translator i18n546247 +Node: String Extraction547040 +Ref: String Extraction-Footnote-1548001 +Node: Printf Ordering548087 +Ref: Printf Ordering-Footnote-1550871 +Node: I18N Portability550935 +Ref: I18N Portability-Footnote-1553384 +Node: I18N Example553447 +Ref: I18N Example-Footnote-1556082 +Node: Gawk I18N556154 +Node: Advanced Features556771 +Node: Nondecimal Data558284 +Node: Array Sorting559867 +Node: Controlling Array Traversal560564 +Node: Array Sorting Functions568801 +Ref: Array Sorting Functions-Footnote-1572475 +Ref: Array Sorting Functions-Footnote-2572568 +Node: Two-way I/O572762 +Ref: Two-way I/O-Footnote-1578194 +Node: TCP/IP Networking578264 +Node: Profiling581108 +Node: Library Functions588582 +Ref: Library Functions-Footnote-1591589 +Node: Library Names591760 +Ref: Library Names-Footnote-1595231 +Ref: Library Names-Footnote-2595451 +Node: General Functions595537 +Node: Strtonum Function596490 +Node: Assert Function599420 +Node: Round Function602746 +Node: Cliff Random Function604289 +Node: Ordinal Functions605305 +Ref: Ordinal Functions-Footnote-1608375 +Ref: Ordinal Functions-Footnote-2608627 +Node: Join Function608836 +Ref: Join Function-Footnote-1610607 +Node: Gettimeofday Function610807 +Node: Data File Management614522 +Node: Filetrans Function615154 +Node: Rewind Function619293 +Node: File Checking620680 +Node: Empty Files621774 +Node: Ignoring Assigns624004 +Node: Getopt Function625557 +Ref: Getopt Function-Footnote-1636861 +Node: Passwd Functions637064 +Ref: Passwd Functions-Footnote-1646039 +Node: Group Functions646127 +Node: Walking Arrays654211 +Node: Sample Programs655780 +Node: Running Examples656445 +Node: Clones657173 +Node: Cut Program658397 +Node: Egrep Program668242 +Ref: Egrep Program-Footnote-1676015 +Node: Id Program676125 +Node: Split Program679741 +Ref: Split Program-Footnote-1683260 +Node: Tee Program683388 +Node: Uniq Program686191 +Node: Wc Program693620 +Ref: Wc Program-Footnote-1697886 +Ref: Wc Program-Footnote-2698086 +Node: Miscellaneous Programs698178 +Node: Dupword Program699366 +Node: Alarm Program701397 +Node: Translate Program706146 +Ref: Translate Program-Footnote-1710533 +Ref: Translate Program-Footnote-2710761 +Node: Labels Program710895 +Ref: Labels Program-Footnote-1714266 +Node: Word Sorting714350 +Node: History Sorting718234 +Node: Extract Program720073 +Ref: Extract Program-Footnote-1727556 +Node: Simple Sed727684 +Node: Igawk Program730746 +Ref: Igawk Program-Footnote-1745903 +Ref: Igawk Program-Footnote-2746104 +Node: Anagram Program746242 +Node: Signature Program749310 +Node: Debugger750410 +Node: Debugging751321 +Node: Debugging Concepts751734 +Node: Debugging Terms753590 +Node: Awk Debugging756213 +Node: Sample dgawk session757105 +Node: dgawk invocation757597 +Node: Finding The Bug758779 +Node: List of Debugger Commands765265 +Node: Breakpoint Control766576 +Node: Dgawk Execution Control770212 +Node: Viewing And Changing Data773563 +Node: Dgawk Stack776900 +Node: Dgawk Info778360 +Node: Miscellaneous Dgawk Commands782308 +Node: Readline Support787736 +Node: Dgawk Limitations788574 +Node: Language History790763 +Node: V7/SVR3.1792275 +Node: SVR4794596 +Node: POSIX796038 +Node: BTL797046 +Node: POSIX/GNU797780 +Node: Common Extensions802931 +Node: Ranges and Locales804038 +Ref: Ranges and Locales-Footnote-1808642 +Node: Contributors808863 +Node: Installation813125 +Node: Gawk Distribution814019 +Node: Getting814503 +Node: Extracting815329 +Node: Distribution contents817021 +Node: Unix Installation822243 +Node: Quick Installation822860 +Node: Additional Configuration Options824822 +Node: Configuration Philosophy826299 +Node: Non-Unix Installation828641 +Node: PC Installation829099 +Node: PC Binary Installation830398 +Node: PC Compiling832246 +Node: PC Testing835190 +Node: PC Using836366 +Node: Cygwin840551 +Node: MSYS841551 +Node: VMS Installation842065 +Node: VMS Compilation842668 +Ref: VMS Compilation-Footnote-1843675 +Node: VMS Installation Details843733 +Node: VMS Running845368 +Node: VMS Old Gawk846975 +Node: Bugs847449 +Node: Other Versions851301 +Node: Notes856582 +Node: Compatibility Mode857274 +Node: Additions858057 +Node: Accessing The Source858869 +Node: Adding Code860294 +Node: New Ports866261 +Node: Dynamic Extensions870374 +Node: Internals871750 +Node: Plugin License880853 +Node: Sample Library881487 +Node: Internal File Description882173 +Node: Internal File Ops885888 +Ref: Internal File Ops-Footnote-1890669 +Node: Using Internal File Ops890809 +Node: Future Extensions893186 +Node: Basic Concepts895690 +Node: Basic High Level896447 +Ref: Basic High Level-Footnote-1900482 +Node: Basic Data Typing900667 +Node: Floating Point Issues905192 +Node: String Conversion Precision906275 +Ref: String Conversion Precision-Footnote-1907975 +Node: Unexpected Results908084 +Node: POSIX Floating Point Problems909910 +Ref: POSIX Floating Point Problems-Footnote-1913615 +Node: Glossary913653 +Node: Copying938629 +Node: GNU Free Documentation License976186 +Node: Index1001323 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 33e66d70..ee401f9e 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 November, 2011 +@set UPDATE-MONTH February, 2012 @set VERSION 4.0 @set PATCHLEVEL 1 @@ -143,7 +143,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 +2000, 2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012 Free Software Foundation, Inc. @sp 2 @@ -1969,9 +1969,11 @@ line beginning with @samp{#!} lists the full @value{FN} of an interpreter to run and an optional initial command-line argument to pass to that interpreter. The operating system then runs the interpreter with the given argument and the full argument list of the executed program. The first argument -in the list is the full @value{FN} of the @command{awk} program. The rest of the +in the list is the full @value{FN} of the @command{awk} program. +The rest of the argument list contains either options to @command{awk}, or @value{DF}s, -or both.} as if you had +or both. Note that on many systems @command{awk} may be found in +@file{/usr/bin} instead of in @file{/bin}. Caveat Emptor.} as if you had typed @samp{awk -f advice}: @example @@ -14203,6 +14205,13 @@ Optional parameters are enclosed in square brackets@w{ ([ ]):} @item atan2(@var{y}, @var{x}) @cindex @code{atan2()} function Return the arctangent of @code{@var{y} / @var{x}} in radians. +You can use @samp{pi = atan2(0, -1)} to retrieve the value of +@tex +$\pi$. +@end tex +@ifnottex +pi. +@end ifnottex @item cos(@var{x}) @cindex @code{cos()} function |