diff options
| -rw-r--r-- | doc/ChangeLog | 1 | ||||
| -rw-r--r-- | doc/gawk.info | 1026 | ||||
| -rw-r--r-- | doc/gawk.texi | 54 | ||||
| -rw-r--r-- | doc/gawktexi.in | 52 |
4 files changed, 624 insertions, 509 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 43d935fa..e613ffa6 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,6 +1,7 @@ 2015-02-04 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: O'Reilly fixes. + * gawktexi.in: Update various version-related bits of info. 2015-02-02 Arnold D. Robbins <arnold@skeeve.com> diff --git a/doc/gawk.info b/doc/gawk.info index bfca7f05..f488769b 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -3453,8 +3453,8 @@ sequences apply to both string constants and regexp constants: would continue incorporating hexadecimal digits into the value until a non-hexadecimal digit or the end of the string was encountered. However, using more than two hexadecimal - digits produced undefined results. As of version *FIXME:* - 4.3.0, only two digits are processed. + digits produced undefined results. As of version 4.2, only + two digits are processed. `\/' A literal slash (necessary for regexp constants only). This @@ -19011,7 +19011,7 @@ File: gawk.info, Node: Programs Summary, Next: Programs Exercises, Prev: Misc the separator can considerably simplify such tasks. * The examples here demonstrate the usefulness of the library - functions from *note Library Functions:: for a number of real (if + functions from *note Library Functions::, for a number of real (if small) programs. * Besides reinventing POSIX wheels, other programs solved a @@ -26519,6 +26519,9 @@ the current version of `gawk'. - The `bindtextdomain()', `dcgettext()' and `dcngettext()' functions for internationalization (*note Programmer i18n::). + - The `div()' function for doing integer division and remainder + (*note Numeric Functions::). + * Changes and/or additions in the command-line options: - The `AWKPATH' environment variable for specifying a path @@ -26573,7 +26576,10 @@ the current version of `gawk'. - Ultrix - * Support for MirBSD was removed at `gawk' version 4.2. + * Support for the following systems was removed from the code for + `gawk' version 4.2: + + - MirBSD @@ -26960,6 +26966,26 @@ in POSIX `awk', in the order they were added to `gawk'. * The dynamic extension interface was completely redone (*note Dynamic Extensions::). + * Support for Ultrix was removed. + + + Version 4.2 introduced the following changes: + + * Changes to `ENVIRON' are reflected into `gawk''s environment and + that of programs that it runs. *Note Auto-set::. + + * The `--pretty-print' option no longer runs the `awk' program too. + *Note Options::. + + * The `igawk' program and its manual page are no longer installed + when `gawk' is built. *Note Igawk Program::. + + * The `div()' function. *Note Numeric Functions::. + + * The maximum number of hexdecimal digits in `\x' escapes is now two. + *Note Escape Sequences::. + + * Support for MirBSD was removed. File: gawk.info, Node: Common Extensions, Next: Ranges and Locales, Prev: Feature History, Up: Language History @@ -34689,501 +34715,501 @@ Node: Invoking Summary151836 Node: Regexp153499 Node: Regexp Usage154953 Node: Escape Sequences156990 -Node: Regexp Operators163230 -Ref: Regexp Operators-Footnote-1170640 -Ref: Regexp Operators-Footnote-2170787 -Node: Bracket Expressions170885 -Ref: table-char-classes172900 -Node: Leftmost Longest175842 -Node: Computed Regexps177144 -Node: GNU Regexp Operators180573 -Node: Case-sensitivity184245 -Ref: Case-sensitivity-Footnote-1187130 -Ref: Case-sensitivity-Footnote-2187365 -Node: Regexp Summary187473 -Node: Reading Files188940 -Node: Records191033 -Node: awk split records191766 -Node: gawk split records196695 -Ref: gawk split records-Footnote-1201234 -Node: Fields201271 -Ref: Fields-Footnote-1204049 -Node: Nonconstant Fields204135 -Ref: Nonconstant Fields-Footnote-1206373 -Node: Changing Fields206576 -Node: Field Separators212507 -Node: Default Field Splitting215211 -Node: Regexp Field Splitting216328 -Node: Single Character Fields219678 -Node: Command Line Field Separator220737 -Node: Full Line Fields223954 -Ref: Full Line Fields-Footnote-1225475 -Ref: Full Line Fields-Footnote-2225521 -Node: Field Splitting Summary225622 -Node: Constant Size227696 -Node: Splitting By Content232279 -Ref: Splitting By Content-Footnote-1236244 -Node: Multiple Line236407 -Ref: Multiple Line-Footnote-1242288 -Node: Getline242467 -Node: Plain Getline244674 -Node: Getline/Variable247314 -Node: Getline/File248463 -Node: Getline/Variable/File249848 -Ref: Getline/Variable/File-Footnote-1251451 -Node: Getline/Pipe251538 -Node: Getline/Variable/Pipe254216 -Node: Getline/Coprocess255347 -Node: Getline/Variable/Coprocess256611 -Node: Getline Notes257350 -Node: Getline Summary260144 -Ref: table-getline-variants260556 -Node: Read Timeout261385 -Ref: Read Timeout-Footnote-1265222 -Node: Command-line directories265280 -Node: Input Summary266185 -Node: Input Exercises269570 -Node: Printing270298 -Node: Print272075 -Node: Print Examples273532 -Node: Output Separators276311 -Node: OFMT278329 -Node: Printf279684 -Node: Basic Printf280469 -Node: Control Letters282041 -Node: Format Modifiers286026 -Node: Printf Examples292036 -Node: Redirection294522 -Node: Special FD301360 -Ref: Special FD-Footnote-1304526 -Node: Special Files304600 -Node: Other Inherited Files305217 -Node: Special Network306217 -Node: Special Caveats307079 -Node: Close Files And Pipes308028 -Ref: Close Files And Pipes-Footnote-1315219 -Ref: Close Files And Pipes-Footnote-2315367 -Node: Output Summary315517 -Node: Output Exercises316515 -Node: Expressions317195 -Node: Values318384 -Node: Constants319061 -Node: Scalar Constants319752 -Ref: Scalar Constants-Footnote-1320614 -Node: Nondecimal-numbers320864 -Node: Regexp Constants323874 -Node: Using Constant Regexps324400 -Node: Variables327563 -Node: Using Variables328220 -Node: Assignment Options330131 -Node: Conversion332006 -Node: Strings And Numbers332530 -Ref: Strings And Numbers-Footnote-1335595 -Node: Locale influences conversions335704 -Ref: table-locale-affects338450 -Node: All Operators339042 -Node: Arithmetic Ops339671 -Node: Concatenation342176 -Ref: Concatenation-Footnote-1344995 -Node: Assignment Ops345102 -Ref: table-assign-ops350081 -Node: Increment Ops351391 -Node: Truth Values and Conditions354822 -Node: Truth Values355905 -Node: Typing and Comparison356954 -Node: Variable Typing357770 -Node: Comparison Operators361437 -Ref: table-relational-ops361847 -Node: POSIX String Comparison365342 -Ref: POSIX String Comparison-Footnote-1366414 -Node: Boolean Ops366553 -Ref: Boolean Ops-Footnote-1371031 -Node: Conditional Exp371122 -Node: Function Calls372860 -Node: Precedence376740 -Node: Locales380400 -Node: Expressions Summary382032 -Node: Patterns and Actions384603 -Node: Pattern Overview385723 -Node: Regexp Patterns387402 -Node: Expression Patterns387945 -Node: Ranges391654 -Node: BEGIN/END394761 -Node: Using BEGIN/END395522 -Ref: Using BEGIN/END-Footnote-1398258 -Node: I/O And BEGIN/END398364 -Node: BEGINFILE/ENDFILE400679 -Node: Empty403576 -Node: Using Shell Variables403893 -Node: Action Overview406166 -Node: Statements408492 -Node: If Statement410340 -Node: While Statement411835 -Node: Do Statement413863 -Node: For Statement415011 -Node: Switch Statement418169 -Node: Break Statement420551 -Node: Continue Statement422592 -Node: Next Statement424419 -Node: Nextfile Statement426800 -Node: Exit Statement429428 -Node: Built-in Variables431839 -Node: User-modified432972 -Ref: User-modified-Footnote-1440675 -Node: Auto-set440737 -Ref: Auto-set-Footnote-1454446 -Ref: Auto-set-Footnote-2454651 -Node: ARGC and ARGV454707 -Node: Pattern Action Summary458925 -Node: Arrays461358 -Node: Array Basics462687 -Node: Array Intro463531 -Ref: figure-array-elements465465 -Ref: Array Intro-Footnote-1468085 -Node: Reference to Elements468213 -Node: Assigning Elements470675 -Node: Array Example471166 -Node: Scanning an Array472925 -Node: Controlling Scanning475945 -Ref: Controlling Scanning-Footnote-1481339 -Node: Numeric Array Subscripts481655 -Node: Uninitialized Subscripts483840 -Node: Delete485457 -Ref: Delete-Footnote-1488206 -Node: Multidimensional488263 -Node: Multiscanning491360 -Node: Arrays of Arrays492949 -Node: Arrays Summary497703 -Node: Functions499794 -Node: Built-in500833 -Node: Calling Built-in501911 -Node: Numeric Functions503906 -Ref: Numeric Functions-Footnote-1508724 -Ref: Numeric Functions-Footnote-2509081 -Ref: Numeric Functions-Footnote-3509129 -Node: String Functions509401 -Ref: String Functions-Footnote-1532902 -Ref: String Functions-Footnote-2533031 -Ref: String Functions-Footnote-3533279 -Node: Gory Details533366 -Ref: table-sub-escapes535147 -Ref: table-sub-proposed536662 -Ref: table-posix-sub538024 -Ref: table-gensub-escapes539561 -Ref: Gory Details-Footnote-1540394 -Node: I/O Functions540545 -Ref: I/O Functions-Footnote-1547781 -Node: Time Functions547928 -Ref: Time Functions-Footnote-1558437 -Ref: Time Functions-Footnote-2558505 -Ref: Time Functions-Footnote-3558663 -Ref: Time Functions-Footnote-4558774 -Ref: Time Functions-Footnote-5558886 -Ref: Time Functions-Footnote-6559113 -Node: Bitwise Functions559379 -Ref: table-bitwise-ops559941 -Ref: Bitwise Functions-Footnote-1564269 -Node: Type Functions564441 -Node: I18N Functions565593 -Node: User-defined567240 -Node: Definition Syntax568045 -Ref: Definition Syntax-Footnote-1573704 -Node: Function Example573775 -Ref: Function Example-Footnote-1576696 -Node: Function Caveats576718 -Node: Calling A Function577236 -Node: Variable Scope578194 -Node: Pass By Value/Reference581187 -Node: Return Statement584684 -Node: Dynamic Typing587663 -Node: Indirect Calls588592 -Ref: Indirect Calls-Footnote-1599898 -Node: Functions Summary600026 -Node: Library Functions602728 -Ref: Library Functions-Footnote-1606336 -Ref: Library Functions-Footnote-2606479 -Node: Library Names606650 -Ref: Library Names-Footnote-1610108 -Ref: Library Names-Footnote-2610331 -Node: General Functions610417 -Node: Strtonum Function611520 -Node: Assert Function614542 -Node: Round Function617866 -Node: Cliff Random Function619407 -Node: Ordinal Functions620423 -Ref: Ordinal Functions-Footnote-1623486 -Ref: Ordinal Functions-Footnote-2623738 -Node: Join Function623949 -Ref: Join Function-Footnote-1625719 -Node: Getlocaltime Function625919 -Node: Readfile Function629663 -Node: Shell Quoting631635 -Node: Data File Management633036 -Node: Filetrans Function633668 -Node: Rewind Function637764 -Node: File Checking639150 -Ref: File Checking-Footnote-1640483 -Node: Empty Files640684 -Node: Ignoring Assigns642663 -Node: Getopt Function644213 -Ref: Getopt Function-Footnote-1655677 -Node: Passwd Functions655877 -Ref: Passwd Functions-Footnote-1664717 -Node: Group Functions664805 -Ref: Group Functions-Footnote-1672702 -Node: Walking Arrays672907 -Node: Library Functions Summary674507 -Node: Library Exercises675911 -Node: Sample Programs677191 -Node: Running Examples677961 -Node: Clones678689 -Node: Cut Program679913 -Node: Egrep Program689633 -Ref: Egrep Program-Footnote-1697136 -Node: Id Program697246 -Node: Split Program700922 -Ref: Split Program-Footnote-1704376 -Node: Tee Program704504 -Node: Uniq Program707293 -Node: Wc Program714712 -Ref: Wc Program-Footnote-1718962 -Node: Miscellaneous Programs719056 -Node: Dupword Program720269 -Node: Alarm Program722300 -Node: Translate Program727105 -Ref: Translate Program-Footnote-1731668 -Node: Labels Program731938 -Ref: Labels Program-Footnote-1735289 -Node: Word Sorting735373 -Node: History Sorting739443 -Node: Extract Program741278 -Node: Simple Sed748802 -Node: Igawk Program751872 -Ref: Igawk Program-Footnote-1766198 -Ref: Igawk Program-Footnote-2766399 -Ref: Igawk Program-Footnote-3766521 -Node: Anagram Program766636 -Node: Signature Program769697 -Node: Programs Summary770944 -Node: Programs Exercises772164 -Ref: Programs Exercises-Footnote-1776295 -Node: Advanced Features776386 -Node: Nondecimal Data778334 -Node: Array Sorting779924 -Node: Controlling Array Traversal780621 -Ref: Controlling Array Traversal-Footnote-1788954 -Node: Array Sorting Functions789072 -Ref: Array Sorting Functions-Footnote-1792961 -Node: Two-way I/O793157 -Ref: Two-way I/O-Footnote-1798102 -Ref: Two-way I/O-Footnote-2798288 -Node: TCP/IP Networking798370 -Node: Profiling801243 -Node: Advanced Features Summary809520 -Node: Internationalization811453 -Node: I18N and L10N812933 -Node: Explaining gettext813619 -Ref: Explaining gettext-Footnote-1818644 -Ref: Explaining gettext-Footnote-2818828 -Node: Programmer i18n818993 -Ref: Programmer i18n-Footnote-1823859 -Node: Translator i18n823908 -Node: String Extraction824702 -Ref: String Extraction-Footnote-1825833 -Node: Printf Ordering825919 -Ref: Printf Ordering-Footnote-1828705 -Node: I18N Portability828769 -Ref: I18N Portability-Footnote-1831224 -Node: I18N Example831287 -Ref: I18N Example-Footnote-1834090 -Node: Gawk I18N834162 -Node: I18N Summary834800 -Node: Debugger836139 -Node: Debugging837161 -Node: Debugging Concepts837602 -Node: Debugging Terms839455 -Node: Awk Debugging842027 -Node: Sample Debugging Session842921 -Node: Debugger Invocation843441 -Node: Finding The Bug844825 -Node: List of Debugger Commands851300 -Node: Breakpoint Control852633 -Node: Debugger Execution Control856329 -Node: Viewing And Changing Data859693 -Node: Execution Stack863071 -Node: Debugger Info864708 -Node: Miscellaneous Debugger Commands868725 -Node: Readline Support873754 -Node: Limitations874646 -Node: Debugging Summary876760 -Node: Arbitrary Precision Arithmetic877928 -Node: Computer Arithmetic879344 -Ref: table-numeric-ranges882942 -Ref: Computer Arithmetic-Footnote-1883801 -Node: Math Definitions883858 -Ref: table-ieee-formats887146 -Ref: Math Definitions-Footnote-1887750 -Node: MPFR features887855 -Node: FP Math Caution889526 -Ref: FP Math Caution-Footnote-1890576 -Node: Inexactness of computations890945 -Node: Inexact representation891904 -Node: Comparing FP Values893261 -Node: Errors accumulate894343 -Node: Getting Accuracy895776 -Node: Try To Round898438 -Node: Setting precision899337 -Ref: table-predefined-precision-strings900021 -Node: Setting the rounding mode901810 -Ref: table-gawk-rounding-modes902174 -Ref: Setting the rounding mode-Footnote-1905629 -Node: Arbitrary Precision Integers905808 -Ref: Arbitrary Precision Integers-Footnote-1910708 -Node: POSIX Floating Point Problems910857 -Ref: POSIX Floating Point Problems-Footnote-1914730 -Node: Floating point summary914768 -Node: Dynamic Extensions916962 -Node: Extension Intro918514 -Node: Plugin License919780 -Node: Extension Mechanism Outline920577 -Ref: figure-load-extension921005 -Ref: figure-register-new-function922485 -Ref: figure-call-new-function923489 -Node: Extension API Description925475 -Node: Extension API Functions Introduction926925 -Node: General Data Types931749 -Ref: General Data Types-Footnote-1937488 -Node: Memory Allocation Functions937787 -Ref: Memory Allocation Functions-Footnote-1940626 -Node: Constructor Functions940722 -Node: Registration Functions942456 -Node: Extension Functions943141 -Node: Exit Callback Functions945438 -Node: Extension Version String946686 -Node: Input Parsers947351 -Node: Output Wrappers957230 -Node: Two-way processors961745 -Node: Printing Messages963949 -Ref: Printing Messages-Footnote-1965025 -Node: Updating `ERRNO'965177 -Node: Requesting Values965917 -Ref: table-value-types-returned966645 -Node: Accessing Parameters967602 -Node: Symbol Table Access968833 -Node: Symbol table by name969347 -Node: Symbol table by cookie971328 -Ref: Symbol table by cookie-Footnote-1975472 -Node: Cached values975535 -Ref: Cached values-Footnote-1979034 -Node: Array Manipulation979125 -Ref: Array Manipulation-Footnote-1980223 -Node: Array Data Types980260 -Ref: Array Data Types-Footnote-1982915 -Node: Array Functions983007 -Node: Flattening Arrays986861 -Node: Creating Arrays993753 -Node: Extension API Variables998524 -Node: Extension Versioning999160 -Node: Extension API Informational Variables1001061 -Node: Extension API Boilerplate1002126 -Node: Finding Extensions1005935 -Node: Extension Example1006495 -Node: Internal File Description1007267 -Node: Internal File Ops1011334 -Ref: Internal File Ops-Footnote-11023004 -Node: Using Internal File Ops1023144 -Ref: Using Internal File Ops-Footnote-11025527 -Node: Extension Samples1025800 -Node: Extension Sample File Functions1027326 -Node: Extension Sample Fnmatch1034964 -Node: Extension Sample Fork1036455 -Node: Extension Sample Inplace1037670 -Node: Extension Sample Ord1039345 -Node: Extension Sample Readdir1040181 -Ref: table-readdir-file-types1041057 -Node: Extension Sample Revout1041868 -Node: Extension Sample Rev2way1042458 -Node: Extension Sample Read write array1043198 -Node: Extension Sample Readfile1045138 -Node: Extension Sample Time1046233 -Node: Extension Sample API Tests1047582 -Node: gawkextlib1048073 -Node: Extension summary1050731 -Node: Extension Exercises1054420 -Node: Language History1055142 -Node: V7/SVR3.11056798 -Node: SVR41058979 -Node: POSIX1060424 -Node: BTL1061813 -Node: POSIX/GNU1062547 -Node: Feature History1068171 -Node: Common Extensions1081269 -Node: Ranges and Locales1082593 -Ref: Ranges and Locales-Footnote-11087211 -Ref: Ranges and Locales-Footnote-21087238 -Ref: Ranges and Locales-Footnote-31087472 -Node: Contributors1087693 -Node: History summary1093234 -Node: Installation1094604 -Node: Gawk Distribution1095550 -Node: Getting1096034 -Node: Extracting1096857 -Node: Distribution contents1098492 -Node: Unix Installation1104557 -Node: Quick Installation1105240 -Node: Shell Startup Files1107651 -Node: Additional Configuration Options1108730 -Node: Configuration Philosophy1110469 -Node: Non-Unix Installation1112838 -Node: PC Installation1113296 -Node: PC Binary Installation1114615 -Node: PC Compiling1116463 -Ref: PC Compiling-Footnote-11119484 -Node: PC Testing1119593 -Node: PC Using1120769 -Node: Cygwin1124884 -Node: MSYS1125707 -Node: VMS Installation1126207 -Node: VMS Compilation1126999 -Ref: VMS Compilation-Footnote-11128221 -Node: VMS Dynamic Extensions1128279 -Node: VMS Installation Details1129963 -Node: VMS Running1132215 -Node: VMS GNV1135051 -Node: VMS Old Gawk1135785 -Node: Bugs1136255 -Node: Other Versions1140138 -Node: Installation summary1146562 -Node: Notes1147618 -Node: Compatibility Mode1148483 -Node: Additions1149265 -Node: Accessing The Source1150190 -Node: Adding Code1151625 -Node: New Ports1157782 -Node: Derived Files1162264 -Ref: Derived Files-Footnote-11167739 -Ref: Derived Files-Footnote-21167773 -Ref: Derived Files-Footnote-31168369 -Node: Future Extensions1168483 -Node: Implementation Limitations1169089 -Node: Extension Design1170337 -Node: Old Extension Problems1171491 -Ref: Old Extension Problems-Footnote-11173008 -Node: Extension New Mechanism Goals1173065 -Ref: Extension New Mechanism Goals-Footnote-11176425 -Node: Extension Other Design Decisions1176614 -Node: Extension Future Growth1178722 -Node: Old Extension Mechanism1179558 -Node: Notes summary1181320 -Node: Basic Concepts1182506 -Node: Basic High Level1183187 -Ref: figure-general-flow1183459 -Ref: figure-process-flow1184058 -Ref: Basic High Level-Footnote-11187287 -Node: Basic Data Typing1187472 -Node: Glossary1190800 -Node: Copying1222729 -Node: GNU Free Documentation License1260285 -Node: Index1285421 +Node: Regexp Operators163219 +Ref: Regexp Operators-Footnote-1170629 +Ref: Regexp Operators-Footnote-2170776 +Node: Bracket Expressions170874 +Ref: table-char-classes172889 +Node: Leftmost Longest175831 +Node: Computed Regexps177133 +Node: GNU Regexp Operators180562 +Node: Case-sensitivity184234 +Ref: Case-sensitivity-Footnote-1187119 +Ref: Case-sensitivity-Footnote-2187354 +Node: Regexp Summary187462 +Node: Reading Files188929 +Node: Records191022 +Node: awk split records191755 +Node: gawk split records196684 +Ref: gawk split records-Footnote-1201223 +Node: Fields201260 +Ref: Fields-Footnote-1204038 +Node: Nonconstant Fields204124 +Ref: Nonconstant Fields-Footnote-1206362 +Node: Changing Fields206565 +Node: Field Separators212496 +Node: Default Field Splitting215200 +Node: Regexp Field Splitting216317 +Node: Single Character Fields219667 +Node: Command Line Field Separator220726 +Node: Full Line Fields223943 +Ref: Full Line Fields-Footnote-1225464 +Ref: Full Line Fields-Footnote-2225510 +Node: Field Splitting Summary225611 +Node: Constant Size227685 +Node: Splitting By Content232268 +Ref: Splitting By Content-Footnote-1236233 +Node: Multiple Line236396 +Ref: Multiple Line-Footnote-1242277 +Node: Getline242456 +Node: Plain Getline244663 +Node: Getline/Variable247303 +Node: Getline/File248452 +Node: Getline/Variable/File249837 +Ref: Getline/Variable/File-Footnote-1251440 +Node: Getline/Pipe251527 +Node: Getline/Variable/Pipe254205 +Node: Getline/Coprocess255336 +Node: Getline/Variable/Coprocess256600 +Node: Getline Notes257339 +Node: Getline Summary260133 +Ref: table-getline-variants260545 +Node: Read Timeout261374 +Ref: Read Timeout-Footnote-1265211 +Node: Command-line directories265269 +Node: Input Summary266174 +Node: Input Exercises269559 +Node: Printing270287 +Node: Print272064 +Node: Print Examples273521 +Node: Output Separators276300 +Node: OFMT278318 +Node: Printf279673 +Node: Basic Printf280458 +Node: Control Letters282030 +Node: Format Modifiers286015 +Node: Printf Examples292025 +Node: Redirection294511 +Node: Special FD301349 +Ref: Special FD-Footnote-1304515 +Node: Special Files304589 +Node: Other Inherited Files305206 +Node: Special Network306206 +Node: Special Caveats307068 +Node: Close Files And Pipes308017 +Ref: Close Files And Pipes-Footnote-1315208 +Ref: Close Files And Pipes-Footnote-2315356 +Node: Output Summary315506 +Node: Output Exercises316504 +Node: Expressions317184 +Node: Values318373 +Node: Constants319050 +Node: Scalar Constants319741 +Ref: Scalar Constants-Footnote-1320603 +Node: Nondecimal-numbers320853 +Node: Regexp Constants323863 +Node: Using Constant Regexps324389 +Node: Variables327552 +Node: Using Variables328209 +Node: Assignment Options330120 +Node: Conversion331995 +Node: Strings And Numbers332519 +Ref: Strings And Numbers-Footnote-1335584 +Node: Locale influences conversions335693 +Ref: table-locale-affects338439 +Node: All Operators339031 +Node: Arithmetic Ops339660 +Node: Concatenation342165 +Ref: Concatenation-Footnote-1344984 +Node: Assignment Ops345091 +Ref: table-assign-ops350070 +Node: Increment Ops351380 +Node: Truth Values and Conditions354811 +Node: Truth Values355894 +Node: Typing and Comparison356943 +Node: Variable Typing357759 +Node: Comparison Operators361426 +Ref: table-relational-ops361836 +Node: POSIX String Comparison365331 +Ref: POSIX String Comparison-Footnote-1366403 +Node: Boolean Ops366542 +Ref: Boolean Ops-Footnote-1371020 +Node: Conditional Exp371111 +Node: Function Calls372849 +Node: Precedence376729 +Node: Locales380389 +Node: Expressions Summary382021 +Node: Patterns and Actions384592 +Node: Pattern Overview385712 +Node: Regexp Patterns387391 +Node: Expression Patterns387934 +Node: Ranges391643 +Node: BEGIN/END394750 +Node: Using BEGIN/END395511 +Ref: Using BEGIN/END-Footnote-1398247 +Node: I/O And BEGIN/END398353 +Node: BEGINFILE/ENDFILE400668 +Node: Empty403565 +Node: Using Shell Variables403882 +Node: Action Overview406155 +Node: Statements408481 +Node: If Statement410329 +Node: While Statement411824 +Node: Do Statement413852 +Node: For Statement415000 +Node: Switch Statement418158 +Node: Break Statement420540 +Node: Continue Statement422581 +Node: Next Statement424408 +Node: Nextfile Statement426789 +Node: Exit Statement429417 +Node: Built-in Variables431828 +Node: User-modified432961 +Ref: User-modified-Footnote-1440664 +Node: Auto-set440726 +Ref: Auto-set-Footnote-1454435 +Ref: Auto-set-Footnote-2454640 +Node: ARGC and ARGV454696 +Node: Pattern Action Summary458914 +Node: Arrays461347 +Node: Array Basics462676 +Node: Array Intro463520 +Ref: figure-array-elements465454 +Ref: Array Intro-Footnote-1468074 +Node: Reference to Elements468202 +Node: Assigning Elements470664 +Node: Array Example471155 +Node: Scanning an Array472914 +Node: Controlling Scanning475934 +Ref: Controlling Scanning-Footnote-1481328 +Node: Numeric Array Subscripts481644 +Node: Uninitialized Subscripts483829 +Node: Delete485446 +Ref: Delete-Footnote-1488195 +Node: Multidimensional488252 +Node: Multiscanning491349 +Node: Arrays of Arrays492938 +Node: Arrays Summary497692 +Node: Functions499783 +Node: Built-in500822 +Node: Calling Built-in501900 +Node: Numeric Functions503895 +Ref: Numeric Functions-Footnote-1508713 +Ref: Numeric Functions-Footnote-2509070 +Ref: Numeric Functions-Footnote-3509118 +Node: String Functions509390 +Ref: String Functions-Footnote-1532891 +Ref: String Functions-Footnote-2533020 +Ref: String Functions-Footnote-3533268 +Node: Gory Details533355 +Ref: table-sub-escapes535136 +Ref: table-sub-proposed536651 +Ref: table-posix-sub538013 +Ref: table-gensub-escapes539550 +Ref: Gory Details-Footnote-1540383 +Node: I/O Functions540534 +Ref: I/O Functions-Footnote-1547770 +Node: Time Functions547917 +Ref: Time Functions-Footnote-1558426 +Ref: Time Functions-Footnote-2558494 +Ref: Time Functions-Footnote-3558652 +Ref: Time Functions-Footnote-4558763 +Ref: Time Functions-Footnote-5558875 +Ref: Time Functions-Footnote-6559102 +Node: Bitwise Functions559368 +Ref: table-bitwise-ops559930 +Ref: Bitwise Functions-Footnote-1564258 +Node: Type Functions564430 +Node: I18N Functions565582 +Node: User-defined567229 +Node: Definition Syntax568034 +Ref: Definition Syntax-Footnote-1573693 +Node: Function Example573764 +Ref: Function Example-Footnote-1576685 +Node: Function Caveats576707 +Node: Calling A Function577225 +Node: Variable Scope578183 +Node: Pass By Value/Reference581176 +Node: Return Statement584673 +Node: Dynamic Typing587652 +Node: Indirect Calls588581 +Ref: Indirect Calls-Footnote-1599887 +Node: Functions Summary600015 +Node: Library Functions602717 +Ref: Library Functions-Footnote-1606325 +Ref: Library Functions-Footnote-2606468 +Node: Library Names606639 +Ref: Library Names-Footnote-1610097 +Ref: Library Names-Footnote-2610320 +Node: General Functions610406 +Node: Strtonum Function611509 +Node: Assert Function614531 +Node: Round Function617855 +Node: Cliff Random Function619396 +Node: Ordinal Functions620412 +Ref: Ordinal Functions-Footnote-1623475 +Ref: Ordinal Functions-Footnote-2623727 +Node: Join Function623938 +Ref: Join Function-Footnote-1625708 +Node: Getlocaltime Function625908 +Node: Readfile Function629652 +Node: Shell Quoting631624 +Node: Data File Management633025 +Node: Filetrans Function633657 +Node: Rewind Function637753 +Node: File Checking639139 +Ref: File Checking-Footnote-1640472 +Node: Empty Files640673 +Node: Ignoring Assigns642652 +Node: Getopt Function644202 +Ref: Getopt Function-Footnote-1655666 +Node: Passwd Functions655866 +Ref: Passwd Functions-Footnote-1664706 +Node: Group Functions664794 +Ref: Group Functions-Footnote-1672691 +Node: Walking Arrays672896 +Node: Library Functions Summary674496 +Node: Library Exercises675900 +Node: Sample Programs677180 +Node: Running Examples677950 +Node: Clones678678 +Node: Cut Program679902 +Node: Egrep Program689622 +Ref: Egrep Program-Footnote-1697125 +Node: Id Program697235 +Node: Split Program700911 +Ref: Split Program-Footnote-1704365 +Node: Tee Program704493 +Node: Uniq Program707282 +Node: Wc Program714701 +Ref: Wc Program-Footnote-1718951 +Node: Miscellaneous Programs719045 +Node: Dupword Program720258 +Node: Alarm Program722289 +Node: Translate Program727094 +Ref: Translate Program-Footnote-1731657 +Node: Labels Program731927 +Ref: Labels Program-Footnote-1735278 +Node: Word Sorting735362 +Node: History Sorting739432 +Node: Extract Program741267 +Node: Simple Sed748791 +Node: Igawk Program751861 +Ref: Igawk Program-Footnote-1766187 +Ref: Igawk Program-Footnote-2766388 +Ref: Igawk Program-Footnote-3766510 +Node: Anagram Program766625 +Node: Signature Program769686 +Node: Programs Summary770933 +Node: Programs Exercises772154 +Ref: Programs Exercises-Footnote-1776285 +Node: Advanced Features776376 +Node: Nondecimal Data778324 +Node: Array Sorting779914 +Node: Controlling Array Traversal780611 +Ref: Controlling Array Traversal-Footnote-1788944 +Node: Array Sorting Functions789062 +Ref: Array Sorting Functions-Footnote-1792951 +Node: Two-way I/O793147 +Ref: Two-way I/O-Footnote-1798092 +Ref: Two-way I/O-Footnote-2798278 +Node: TCP/IP Networking798360 +Node: Profiling801233 +Node: Advanced Features Summary809510 +Node: Internationalization811443 +Node: I18N and L10N812923 +Node: Explaining gettext813609 +Ref: Explaining gettext-Footnote-1818634 +Ref: Explaining gettext-Footnote-2818818 +Node: Programmer i18n818983 +Ref: Programmer i18n-Footnote-1823849 +Node: Translator i18n823898 +Node: String Extraction824692 +Ref: String Extraction-Footnote-1825823 +Node: Printf Ordering825909 +Ref: Printf Ordering-Footnote-1828695 +Node: I18N Portability828759 +Ref: I18N Portability-Footnote-1831214 +Node: I18N Example831277 +Ref: I18N Example-Footnote-1834080 +Node: Gawk I18N834152 +Node: I18N Summary834790 +Node: Debugger836129 +Node: Debugging837151 +Node: Debugging Concepts837592 +Node: Debugging Terms839445 +Node: Awk Debugging842017 +Node: Sample Debugging Session842911 +Node: Debugger Invocation843431 +Node: Finding The Bug844815 +Node: List of Debugger Commands851290 +Node: Breakpoint Control852623 +Node: Debugger Execution Control856319 +Node: Viewing And Changing Data859683 +Node: Execution Stack863061 +Node: Debugger Info864698 +Node: Miscellaneous Debugger Commands868715 +Node: Readline Support873744 +Node: Limitations874636 +Node: Debugging Summary876750 +Node: Arbitrary Precision Arithmetic877918 +Node: Computer Arithmetic879334 +Ref: table-numeric-ranges882932 +Ref: Computer Arithmetic-Footnote-1883791 +Node: Math Definitions883848 +Ref: table-ieee-formats887136 +Ref: Math Definitions-Footnote-1887740 +Node: MPFR features887845 +Node: FP Math Caution889516 +Ref: FP Math Caution-Footnote-1890566 +Node: Inexactness of computations890935 +Node: Inexact representation891894 +Node: Comparing FP Values893251 +Node: Errors accumulate894333 +Node: Getting Accuracy895766 +Node: Try To Round898428 +Node: Setting precision899327 +Ref: table-predefined-precision-strings900011 +Node: Setting the rounding mode901800 +Ref: table-gawk-rounding-modes902164 +Ref: Setting the rounding mode-Footnote-1905619 +Node: Arbitrary Precision Integers905798 +Ref: Arbitrary Precision Integers-Footnote-1910698 +Node: POSIX Floating Point Problems910847 +Ref: POSIX Floating Point Problems-Footnote-1914720 +Node: Floating point summary914758 +Node: Dynamic Extensions916952 +Node: Extension Intro918504 +Node: Plugin License919770 +Node: Extension Mechanism Outline920567 +Ref: figure-load-extension920995 +Ref: figure-register-new-function922475 +Ref: figure-call-new-function923479 +Node: Extension API Description925465 +Node: Extension API Functions Introduction926915 +Node: General Data Types931739 +Ref: General Data Types-Footnote-1937478 +Node: Memory Allocation Functions937777 +Ref: Memory Allocation Functions-Footnote-1940616 +Node: Constructor Functions940712 +Node: Registration Functions942446 +Node: Extension Functions943131 +Node: Exit Callback Functions945428 +Node: Extension Version String946676 +Node: Input Parsers947341 +Node: Output Wrappers957220 +Node: Two-way processors961735 +Node: Printing Messages963939 +Ref: Printing Messages-Footnote-1965015 +Node: Updating `ERRNO'965167 +Node: Requesting Values965907 +Ref: table-value-types-returned966635 +Node: Accessing Parameters967592 +Node: Symbol Table Access968823 +Node: Symbol table by name969337 +Node: Symbol table by cookie971318 +Ref: Symbol table by cookie-Footnote-1975462 +Node: Cached values975525 +Ref: Cached values-Footnote-1979024 +Node: Array Manipulation979115 +Ref: Array Manipulation-Footnote-1980213 +Node: Array Data Types980250 +Ref: Array Data Types-Footnote-1982905 +Node: Array Functions982997 +Node: Flattening Arrays986851 +Node: Creating Arrays993743 +Node: Extension API Variables998514 +Node: Extension Versioning999150 +Node: Extension API Informational Variables1001051 +Node: Extension API Boilerplate1002116 +Node: Finding Extensions1005925 +Node: Extension Example1006485 +Node: Internal File Description1007257 +Node: Internal File Ops1011324 +Ref: Internal File Ops-Footnote-11022994 +Node: Using Internal File Ops1023134 +Ref: Using Internal File Ops-Footnote-11025517 +Node: Extension Samples1025790 +Node: Extension Sample File Functions1027316 +Node: Extension Sample Fnmatch1034954 +Node: Extension Sample Fork1036445 +Node: Extension Sample Inplace1037660 +Node: Extension Sample Ord1039335 +Node: Extension Sample Readdir1040171 +Ref: table-readdir-file-types1041047 +Node: Extension Sample Revout1041858 +Node: Extension Sample Rev2way1042448 +Node: Extension Sample Read write array1043188 +Node: Extension Sample Readfile1045128 +Node: Extension Sample Time1046223 +Node: Extension Sample API Tests1047572 +Node: gawkextlib1048063 +Node: Extension summary1050721 +Node: Extension Exercises1054410 +Node: Language History1055132 +Node: V7/SVR3.11056788 +Node: SVR41058969 +Node: POSIX1060414 +Node: BTL1061803 +Node: POSIX/GNU1062537 +Node: Feature History1068326 +Node: Common Extensions1082052 +Node: Ranges and Locales1083376 +Ref: Ranges and Locales-Footnote-11087994 +Ref: Ranges and Locales-Footnote-21088021 +Ref: Ranges and Locales-Footnote-31088255 +Node: Contributors1088476 +Node: History summary1094017 +Node: Installation1095387 +Node: Gawk Distribution1096333 +Node: Getting1096817 +Node: Extracting1097640 +Node: Distribution contents1099275 +Node: Unix Installation1105340 +Node: Quick Installation1106023 +Node: Shell Startup Files1108434 +Node: Additional Configuration Options1109513 +Node: Configuration Philosophy1111252 +Node: Non-Unix Installation1113621 +Node: PC Installation1114079 +Node: PC Binary Installation1115398 +Node: PC Compiling1117246 +Ref: PC Compiling-Footnote-11120267 +Node: PC Testing1120376 +Node: PC Using1121552 +Node: Cygwin1125667 +Node: MSYS1126490 +Node: VMS Installation1126990 +Node: VMS Compilation1127782 +Ref: VMS Compilation-Footnote-11129004 +Node: VMS Dynamic Extensions1129062 +Node: VMS Installation Details1130746 +Node: VMS Running1132998 +Node: VMS GNV1135834 +Node: VMS Old Gawk1136568 +Node: Bugs1137038 +Node: Other Versions1140921 +Node: Installation summary1147345 +Node: Notes1148401 +Node: Compatibility Mode1149266 +Node: Additions1150048 +Node: Accessing The Source1150973 +Node: Adding Code1152408 +Node: New Ports1158565 +Node: Derived Files1163047 +Ref: Derived Files-Footnote-11168522 +Ref: Derived Files-Footnote-21168556 +Ref: Derived Files-Footnote-31169152 +Node: Future Extensions1169266 +Node: Implementation Limitations1169872 +Node: Extension Design1171120 +Node: Old Extension Problems1172274 +Ref: Old Extension Problems-Footnote-11173791 +Node: Extension New Mechanism Goals1173848 +Ref: Extension New Mechanism Goals-Footnote-11177208 +Node: Extension Other Design Decisions1177397 +Node: Extension Future Growth1179505 +Node: Old Extension Mechanism1180341 +Node: Notes summary1182103 +Node: Basic Concepts1183289 +Node: Basic High Level1183970 +Ref: figure-general-flow1184242 +Ref: figure-process-flow1184841 +Ref: Basic High Level-Footnote-11188070 +Node: Basic Data Typing1188255 +Node: Glossary1191583 +Node: Copying1223512 +Node: GNU Free Documentation License1261068 +Node: Index1286204 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 0f4e1eb9..6233bb38 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -5178,13 +5178,12 @@ letters or numbers. @value{COMMONEXT} @quotation CAUTION In ISO C, the escape sequence continues until the first nonhexadecimal digit is seen. -@c FIXME: Add exact version here. For many years, @command{gawk} would continue incorporating hexadecimal digits into the value until a non-hexadecimal digit or the end of the string was encountered. However, using more than two hexadecimal digits produced undefined results. -As of @value{PVERSION} @strong{FIXME:} 4.3.0, only two digits +As of @value{PVERSION} 4.2, only two digits are processed. @end quotation @@ -26543,7 +26542,7 @@ the separator can considerably simplify such tasks. @item The examples here demonstrate the usefulness of the library -functions from @ref{Library Functions} +functions from @DBREF{Library Functions} for a number of real (if small) programs. @item @@ -35740,6 +35739,11 @@ The @code{isarray()} function to check if a variable is an array or not The @code{bindtextdomain()}, @code{dcgettext()} and @code{dcngettext()} functions for internationalization (@pxref{Programmer i18n}). + +@item +The @code{div()} function for doing integer +division and remainder +(@pxref{Numeric Functions}). @end itemize @item @@ -35873,8 +35877,14 @@ Ultrix @end itemize @item -@c FIXME: Verify the version here. -Support for MirBSD was removed at @command{gawk} @value{PVERSION} 4.2. +Support for the following systems was removed from the code +for @command{gawk} @value{PVERSION} 4.2: + +@c nested table +@itemize @value{MINUS} +@item +MirBSD +@end itemize @end itemize @@ -36488,6 +36498,40 @@ with a minimum of two The dynamic extension interface was completely redone (@pxref{Dynamic Extensions}). +@item +Support for Ultrix was removed. + +@end itemize + +Version 4.2 introduced the following changes: + +@itemize @bullet +@item +Changes to @code{ENVIRON} are reflected into @command{gawk}'s +environment and that of programs that it runs. +@xref{Auto-set}. + +@item +The @option{--pretty-print} option no longer runs the @command{awk} +program too. +@xref{Options}. + +@item +The @command{igawk} program and its manual page are no longer +installed when @command{gawk} is built. +@xref{Igawk Program}. + +@item +The @code{div()} function. +@xref{Numeric Functions}. + +@item +The maximum number of hexdecimal digits in @samp{\x} escapes +is now two. +@xref{Escape Sequences}. + +@item +Support for MirBSD was removed. @end itemize @c XXX ADD MORE STUFF HERE diff --git a/doc/gawktexi.in b/doc/gawktexi.in index ab1c0afc..8ce87b82 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -5089,13 +5089,12 @@ letters or numbers. @value{COMMONEXT} @quotation CAUTION In ISO C, the escape sequence continues until the first nonhexadecimal digit is seen. -@c FIXME: Add exact version here. For many years, @command{gawk} would continue incorporating hexadecimal digits into the value until a non-hexadecimal digit or the end of the string was encountered. However, using more than two hexadecimal digits produced undefined results. -As of @value{PVERSION} @strong{FIXME:} 4.3.0, only two digits +As of @value{PVERSION} 4.2, only two digits are processed. @end quotation @@ -34831,6 +34830,11 @@ The @code{isarray()} function to check if a variable is an array or not The @code{bindtextdomain()}, @code{dcgettext()} and @code{dcngettext()} functions for internationalization (@pxref{Programmer i18n}). + +@item +The @code{div()} function for doing integer +division and remainder +(@pxref{Numeric Functions}). @end itemize @item @@ -34964,8 +34968,14 @@ Ultrix @end itemize @item -@c FIXME: Verify the version here. -Support for MirBSD was removed at @command{gawk} @value{PVERSION} 4.2. +Support for the following systems was removed from the code +for @command{gawk} @value{PVERSION} 4.2: + +@c nested table +@itemize @value{MINUS} +@item +MirBSD +@end itemize @end itemize @@ -35579,6 +35589,40 @@ with a minimum of two The dynamic extension interface was completely redone (@pxref{Dynamic Extensions}). +@item +Support for Ultrix was removed. + +@end itemize + +Version 4.2 introduced the following changes: + +@itemize @bullet +@item +Changes to @code{ENVIRON} are reflected into @command{gawk}'s +environment and that of programs that it runs. +@xref{Auto-set}. + +@item +The @option{--pretty-print} option no longer runs the @command{awk} +program too. +@xref{Options}. + +@item +The @command{igawk} program and its manual page are no longer +installed when @command{gawk} is built. +@xref{Igawk Program}. + +@item +The @code{div()} function. +@xref{Numeric Functions}. + +@item +The maximum number of hexdecimal digits in @samp{\x} escapes +is now two. +@xref{Escape Sequences}. + +@item +Support for MirBSD was removed. @end itemize @c XXX ADD MORE STUFF HERE |