diff options
Diffstat (limited to 'doc/gawk.info')
| -rw-r--r-- | doc/gawk.info | 2097 |
1 files changed, 1326 insertions, 771 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 24bd51ad..8afb1e11 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -175,6 +175,7 @@ in (a) below. A copy of the license is included in the section entitled * Computed Regexps:: Using Dynamic Regexps. * GNU Regexp Operators:: Operators specific to GNU software. * Case-sensitivity:: How to do case-insensitive matching. +* Strong Regexp Constants:: Strongly typed regexp constants. * Regexp Summary:: Regular expressions summary. * Records:: Controlling how data is split into records. @@ -217,6 +218,7 @@ in (a) below. A copy of the license is included in the section entitled 'getline'. * Getline Summary:: Summary of 'getline' Variants. * Read Timeout:: Reading input with a timeout. +* Retrying Input:: Retrying input after certain errors. * Command-line directories:: What happens if you put a directory on the command line. * Input Summary:: Input summary. @@ -246,6 +248,7 @@ in (a) below. A copy of the license is included in the section entitled * Special Caveats:: Things to watch out for. * Close Files And Pipes:: Closing Input and Output Files and Pipes. +* Nonfatal:: Enabling Nonfatal Output. * Output Summary:: Output summary. * Output Exercises:: Exercises. * Values:: Constants, Variables, and Regular @@ -557,6 +560,7 @@ in (a) below. A copy of the license is included in the section entitled * Array Functions:: Functions for working with arrays. * Flattening Arrays:: How to flatten arrays. * Creating Arrays:: How to create and populate arrays. +* Redirection API:: How to access and manipulate redirections. * Extension API Variables:: Variables provided by the API. * Extension Versioning:: API Version information. * Extension API Informational Variables:: Variables providing information about @@ -615,6 +619,7 @@ in (a) below. A copy of the license is included in the section entitled * Unix Installation:: Installing 'gawk' under various versions of Unix. * Quick Installation:: Compiling 'gawk' under Unix. +* Shell Startup Files:: Shell convenience functions. * Additional Configuration Options:: Other compile-time options. * Configuration Philosophy:: How it's all supposed to work. * Non-Unix Installation:: Installation on Other Operating @@ -2631,10 +2636,8 @@ The following list describes options mandated by the POSIX standard: different file name for the output. No space is allowed between the '-o' and FILE, if FILE is supplied. - NOTE: Due to the way 'gawk' has evolved, with this option your - program still executes. This will change in the next major - release, such that 'gawk' will only pretty-print the program - and not run it. + NOTE: In the past, this option would also execute your + program. This is no longer the case. '-O' '--optimize' @@ -2662,9 +2665,6 @@ The following list describes options mandated by the POSIX standard: extensions in 'gawk' that are disabled by this option. Also, the following additional restrictions apply: - * Newlines do not act as whitespace to separate fields when 'FS' - is equal to a single space (*note Fields::). - * Newlines are not allowed after '?' or ':' (*note Conditional Exp::). @@ -2933,6 +2933,9 @@ Since '.' is included at the beginning, 'gawk' searches first in the current directory and then in '/usr/local/share/awk'. In practice, this means that you will rarely need to change the value of 'AWKPATH'. + *Note Shell Startup Files::, for information on functions that help +to manipulate the 'AWKPATH' variable. + 'gawk' places the value of the search path that it used into 'ENVIRON["AWKPATH"]'. This provides access to the actual search path value from within an 'awk' program. @@ -2972,6 +2975,9 @@ empty value, 'gawk' uses a default path; this is typically '/usr/local/lib/gawk', although it can vary depending upon how 'gawk' was built. + *Note Shell Startup Files::, for information on functions that help +to manipulate the 'AWKLIBPATH' variable. + 'gawk' places the value of the search path that it used into 'ENVIRON["AWKLIBPATH"]'. This provides access to the actual search path value from within an 'awk' program. @@ -2998,7 +3004,8 @@ used by regular users: 'GAWK_SOCK_RETRIES' Controls the number of times 'gawk' attempts to retry a two-way TCP/IP (socket) connection before giving up. *Note TCP/IP - Networking::. + Networking::. Note that when nonfatal I/O is enabled (*note + Nonfatal::), 'gawk' only tries to open a TCP/IP socket once. 'POSIXLY_CORRECT' Causes 'gawk' to switch to POSIX-compatibility mode, disabling all @@ -3043,13 +3050,6 @@ change. The variables are: supposed to be differences, but occasionally theory and practice don't coordinate with each other.) -'GAWK_NO_PP_RUN' - When 'gawk' is invoked with the '--pretty-print' option, it will - not run the program if this environment variable exists. - - CAUTION: This variable will not survive into the next major - release. - 'GAWK_STACKSIZE' This specifies the amount by which 'gawk' should grow its internal evaluation stack, when needed. @@ -3314,6 +3314,7 @@ you specify more complicated classes of strings. * Computed Regexps:: Using Dynamic Regexps. * GNU Regexp Operators:: Operators specific to GNU software. * Case-sensitivity:: How to do case-insensitive matching. +* Strong Regexp Constants:: Strongly typed regexp constants. * Regexp Summary:: Regular expressions summary. @@ -3440,15 +3441,18 @@ sequences apply to both string constants and regexp constants: '\xHH...' The hexadecimal value HH, where HH stands for a sequence of - hexadecimal digits ('0'-'9', and either 'A'-'F' or 'a'-'f'). Like - the same construct in ISO C, the escape sequence continues until - the first nonhexadecimal digit is seen. (c.e.) However, using - more than two hexadecimal digits produces undefined results. (The - '\x' escape sequence is not allowed in POSIX 'awk'.) - - CAUTION: The next major release of 'gawk' will change, such - that a maximum of two hexadecimal digits following the '\x' - will be used. + hexadecimal digits ('0'-'9', and either 'A'-'F' or 'a'-'f'). A + maximum of two digts are allowed after the '\x'. Any further + hexadecimal digits are treated as simple letters or numbers. + (c.e.) (The '\x' escape sequence is not allowed in POSIX awk.) + + CAUTION: In ISO C, the escape sequence continues until the + first nonhexadecimal digit is seen. For many years, '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 version 4.2, only two + digits are processed. '\/' A literal slash (necessary for regexp constants only). This @@ -4017,7 +4021,7 @@ No options default. -File: gawk.info, Node: Case-sensitivity, Next: Regexp Summary, Prev: GNU Regexp Operators, Up: Regexp +File: gawk.info, Node: Case-sensitivity, Next: Strong Regexp Constants, Prev: GNU Regexp Operators, Up: Regexp 3.8 Case Sensitivity in Matching ================================ @@ -4091,10 +4095,77 @@ and we don't recommend it. that 'gawk' does the right thing. -File: gawk.info, Node: Regexp Summary, Prev: Case-sensitivity, Up: Regexp +File: gawk.info, Node: Strong Regexp Constants, Next: Regexp Summary, Prev: Case-sensitivity, Up: Regexp -3.9 Summary -=========== +3.9 Strongly Typed Regexp Constants +=================================== + +This minor node describes a 'gawk'-specific feature. + + Regexp constants ('/.../') hold a strange position in the 'awk' +language. In most contexts, they act like an expression: '$0 ~ /.../'. +In other contexts, they denote only a regexp to be matched. In no case +are they really a "first class citizen" of the language. That is, you +cannot define a scalar variable whose type is "regexp" in the same sense +that you can define a variable to be a number or a string: + + num = 42 Numeric variable + str = "hi" String variable + re = /foo/ Wrong! re is the result of $0 ~ /foo/ + + For a number of more advanced use cases (described later on in this +Info file), it would be nice to have regexp constants that are "strongly +typed"; in other words, that denote a regexp useful for matching, and +not an expression. + + 'gawk' provides this feature. A strongly typed regexp constant looks +almost like a regular regexp constant, except that it is preceded by an +'@' sign: + + re = @/foo/ Regexp variable + + Strongly typed regexp constants _cannot_ be used eveywhere that a +regular regexp constant can, because this would make the language even +more confusing. Instead, you may use them only in certain contexts: + + * On the righthand side of the '~' and '!~' operators: 'some_var ~ + @/foo/' (*note Regexp Usage::). + + * In the 'case' part of a 'switch' statement (*note Switch + Statement::). + + * As an argument to one of the built-in functions that accept regexp + constants: 'gensub()', 'gsub()', 'match()', 'patsplit()', + 'split()', and 'sub()' (*note String Functions::). + + * As a parameter in a call to a user-defined function (*note + User-defined::). + + * On the righthand side of an assignment to a variable: 'some_var = + @/foo/'. In this case, the type of 'some_var' is regexp. + Additionally, 'some_var' can be used with '~' and '!~', passed to + one of the built-in functions listed above, or passed as a + parameter to a user-defined function. + + You may use the 'typeof()' built-in function (*note Type Functions::) +to determine if a variable or function parameter is a regexp variable. + + The true power of this feature comes from the ability to create +variables that have regexp type. Such variables can be passed on to +user-defined functions, without the confusing aspects of computed +regular expressions created from strings or string constants. They may +also be passed through indirect function calls (*note Indirect Calls::) +onto the built-in functions that accept regexp constants. + + When used in numeric conversions, strongly typed regexp variables +convert to zero. When used in string conversions, they convert to the +string value of the original regexp text. + + +File: gawk.info, Node: Regexp Summary, Prev: Strong Regexp Constants, Up: Regexp + +3.10 Summary +============ * Regular expressions describe sets of strings to be matched. In 'awk', regular expression constants are written enclosed between @@ -4127,6 +4198,9 @@ File: gawk.info, Node: Regexp Summary, Prev: Case-sensitivity, Up: Regexp sensitivity of regexp matching. In other 'awk' versions, use 'tolower()' or 'toupper()'. + * Strongly typed regexp constants ('@/.../') enable certain advanced + use cases to be described later on in the Info file. + File: gawk.info, Node: Reading Files, Next: Printing, Prev: Regexp, Up: Top @@ -4165,6 +4239,7 @@ be named on the 'awk' command line (*note Getline::). * Getline:: Reading files under explicit program control using the 'getline' function. * Read Timeout:: Reading input with a timeout. +* Retrying Input:: Retrying input after certain errors. * Command-line directories:: What happens if you put a directory on the command line. * Input Summary:: Input summary. @@ -4426,7 +4501,7 @@ When 'awk' reads an input record, the record is automatically "parsed" or separated by the 'awk' utility into chunks called "fields". By default, fields are separated by "whitespace", like words in a line. Whitespace in 'awk' means any string of one or more spaces, TABs, or -newlines;(1) other characters that are considered whitespace by other +newlines; other characters that are considered whitespace by other languages (such as formfeed, vertical tab, etc.) are _not_ considered whitespace by 'awk'. @@ -4478,11 +4553,6 @@ record: -| Julie F -| Samuel A - ---------- Footnotes ---------- - - (1) In POSIX 'awk', newlines are not considered whitespace for -separating fields. - File: gawk.info, Node: Nonconstant Fields, Next: Changing Fields, Prev: Fields, Up: Reading Files @@ -5428,6 +5498,11 @@ record, such as a file that cannot be opened, then 'getline' returns -1. In this case, 'gawk' sets the variable 'ERRNO' to a string describing the error that occurred. + If 'ERRNO' indicates that the I/O operation may be retried, and +'PROCINFO["INPUT", "RETRY"]' is set, then 'getline' returns -2 instead +of -1, and further calls to 'getline' may be attemped. *Note Retrying +Input::, for further information about this feature. + In the following examples, COMMAND stands for a string value that represents a shell command. @@ -5863,7 +5938,7 @@ VAR Table 4.1: 'getline' variants and what they set -File: gawk.info, Node: Read Timeout, Next: Command-line directories, Prev: Getline, Up: Reading Files +File: gawk.info, Node: Read Timeout, Next: Retrying Input, Prev: Getline, Up: Reading Files 4.10 Reading Input with a Timeout ================================= @@ -5942,7 +6017,8 @@ per-command or per-connection basis. 'gawk' considers a timeout event to be an error even though the attempt to read from the underlying device may succeed in a later attempt. This is a limitation, and it also means that you cannot use -this to multiplex input from two or more sources. +this to multiplex input from two or more sources. *Note Retrying +Input::, for a way to enable later I/O attempts to succeed. Assigning a timeout value prevents read operations from blocking indefinitely. But bear in mind that there are other ways 'gawk' can @@ -5956,9 +6032,36 @@ can block indefinitely until some other process opens it for writing. (1) This assumes that standard input is the keyboard. -File: gawk.info, Node: Command-line directories, Next: Input Summary, Prev: Read Timeout, Up: Reading Files +File: gawk.info, Node: Retrying Input, Next: Command-line directories, Prev: Read Timeout, Up: Reading Files + +4.11 Retrying Reads After Certain Input Errors +============================================== + +This minor node describes a feature that is specific to 'gawk'. + + When 'gawk' encounters an error while reading input, by default +'getline' returns -1, and subsequent attempts to read from that file +result in an end-of-file indication. However, you may optionally +instruct 'gawk' to allow I/O to be retried when certain errors are +encountered by setting a special element in the 'PROCINFO' array (*note +Auto-set::): + + PROCINFO["INPUT_NAME", "RETRY"] = 1 + + When this element exists, 'gawk' checks the value of the system (C +language) 'errno' variable when an I/O error occurs. If 'errno' +indicates a subsequent I/O attempt may succeed, 'getline' instead +returns -2 and further calls to 'getline' may succeed. This applies to +the 'errno' values 'EAGAIN', 'EWOULDBLOCK', 'EINTR', or 'ETIMEDOUT'. + + This feature is useful in conjunction with 'PROCINFO["INPUT_NAME", +"READ_TIMEOUT"]' or situations where a file descriptor has been +configured to behave in a non-blocking fashion. + + +File: gawk.info, Node: Command-line directories, Next: Input Summary, Prev: Retrying Input, Up: Reading Files -4.11 Directories on the Command Line +4.12 Directories on the Command Line ==================================== According to the POSIX standard, files named on the 'awk' command line @@ -5981,7 +6084,7 @@ usable data from an 'awk' program. File: gawk.info, Node: Input Summary, Next: Input Exercises, Prev: Command-line directories, Up: Reading Files -4.12 Summary +4.13 Summary ============ * Input is split into records based on the value of 'RS'. The @@ -6053,7 +6156,7 @@ File: gawk.info, Node: Input Summary, Next: Input Exercises, Prev: Command-li File: gawk.info, Node: Input Exercises, Prev: Input Summary, Up: Reading Files -4.13 Exercises +4.14 Exercises ============== 1. Using the 'FIELDWIDTHS' variable (*note Constant Size::), write a @@ -6103,6 +6206,7 @@ function. 'gawk' allows access to inherited file descriptors. * Close Files And Pipes:: Closing Input and Output Files and Pipes. +* Nonfatal:: Enabling Nonfatal Output. * Output Summary:: Output summary. * Output Exercises:: Exercises. @@ -7010,7 +7114,7 @@ that 'gawk' provides: behavior. -File: gawk.info, Node: Close Files And Pipes, Next: Output Summary, Prev: Special Files, Up: Printing +File: gawk.info, Node: Close Files And Pipes, Next: Nonfatal, Prev: Special Files, Up: Printing 5.9 Closing Input and Output Redirections ========================================= @@ -7178,9 +7282,68 @@ call. See the system manual pages for information on how to decode this value. -File: gawk.info, Node: Output Summary, Next: Output Exercises, Prev: Close Files And Pipes, Up: Printing +File: gawk.info, Node: Nonfatal, Next: Output Summary, Prev: Close Files And Pipes, Up: Printing + +5.10 Enabling Nonfatal Output +============================= + +This minor node describes a 'gawk'-specific feature. + + In standard 'awk', output with 'print' or 'printf' to a nonexistent +file, or some other I/O error (such as filling up the disk) is a fatal +error. + + $ gawk 'BEGIN { print "hi" > "/no/such/file" }' + error-> gawk: cmd. line:1: fatal: can't redirect to `/no/such/file' (No such file or directory) + + 'gawk' makes it possible to detect that an error has occurred, +allowing you to possibly recover from the error, or at least print an +error message of your choosing before exiting. You can do this in one +of two ways: + + * For all output files, by assigning any value to + 'PROCINFO["NONFATAL"]'. + + * On a per-file basis, by assigning any value to 'PROCINFO[FILENAME, + "NONFATAL"]'. Here, FILENAME is the name of the file to which you + wish output to be nonfatal. + + Once you have enabled nonfatal output, you must check 'ERRNO' after +every relevant 'print' or 'printf' statement to see if something went +wrong. It is also a good idea to initialize 'ERRNO' to zero before +attempting the output. For example: + + $ gawk ' + > BEGIN { + > PROCINFO["NONFATAL"] = 1 + > ERRNO = 0 + > print "hi" > "/no/such/file" + > if (ERRNO) { + > print("Output failed:", ERRNO) > "/dev/stderr" + > exit 1 + > } + > }' + error-> Output failed: No such file or directory + + Here, 'gawk' did not produce a fatal error; instead it let the 'awk' +program code detect the problem and handle it. + + This mechanism works also for standard output and standard error. +For standard output, you may use 'PROCINFO["-", "NONFATAL"]' or +'PROCINFO["/dev/stdout", "NONFATAL"]'. For standard error, use +'PROCINFO["/dev/stderr", "NONFATAL"]'. + + When attempting to open a TCP/IP socket (*note TCP/IP Networking::), +'gawk' tries multiple times. The 'GAWK_SOCK_RETRIES' environment +variable (*note Other Environment Variables::) allows you to override +'gawk''s builtin default number of attempts. However, once nonfatal I/O +is enabled for a given socket, 'gawk' only retries once, relying on +'awk'-level code to notice that there was a problem. + + +File: gawk.info, Node: Output Summary, Next: Output Exercises, Prev: Nonfatal, Up: Printing -5.10 Summary +5.11 Summary ============ * The 'print' statement prints comma-separated expressions. Each @@ -7202,10 +7365,15 @@ File: gawk.info, Node: Output Summary, Next: Output Exercises, Prev: Close Fi For coprocesses, it is possible to close only one direction of the communications. + * Normally errors with 'print' or 'printf' are fatal. 'gawk' lets + you make output errors be nonfatal either for all files or on a + per-file basis. You must then check for errors after every + relevant output statement. + File: gawk.info, Node: Output Exercises, Prev: Output Summary, Up: Printing -5.11 Exercises +5.12 Exercises ============== 1. Rewrite the program: @@ -10125,7 +10293,7 @@ each variable.) The default value is '" "', a string consisting of a single space. As a special exception, this value means that any sequence of - spaces, TABs, and/or newlines is a single separator.(1) It also + spaces, TABs, and/or newlines is a single separator. It also causes spaces, TABs, and newlines at the beginning and end of a record to be ignored. @@ -10222,10 +10390,6 @@ each variable.) Internationalization::). The default value of 'TEXTDOMAIN' is '"messages"'. - ---------- Footnotes ---------- - - (1) In POSIX 'awk', newline does not count as whitespace. - File: gawk.info, Node: Auto-set, Next: ARGC and ARGV, Prev: User-modified, Up: Built-in Variables @@ -10289,10 +10453,24 @@ they are not special: An associative array containing the values of the environment. The array indices are the environment variable names; the elements are the values of the particular environment variables. For example, - 'ENVIRON["HOME"]' might be '"/home/arnold"'. Changing this array - does not affect the environment passed on to any programs that - 'awk' may spawn via redirection or the 'system()' function. (In a - future version of 'gawk', it may do so.) + 'ENVIRON["HOME"]' might be '/home/arnold'. + + For POSIX 'awk', changing this array does not affect the + environment passed on to any programs that 'awk' may spawn via + redirection or the 'system()' function. + + However, beginning with version 4.2, if not in POSIX compatibility + mode, 'gawk' does update its own environment when 'ENVIRON' is + changed, thus changing the environment seen by programs that it + creates. You should therefore be especially careful if you modify + 'ENVIRON["PATH"]', which is the search path for finding executable + programs. + + This can also affect the running 'gawk' program, since some of the + built-in functions may pay attention to certain environment + variables. The most notable instance of this is 'mktime()' (*note + Time Functions::), which pays attention the value of the 'TZ' + environment variable on many systems. Some operating systems may not have environment variables. On such systems, the 'ENVIRON' array is empty (except for @@ -10315,6 +10493,11 @@ they are not special: 'getline' returning -1. You are, of course, free to clear it yourself before doing an I/O operation. + If the value of 'ERRNO' corresponds to a system error in the C + 'errno' variable, then 'PROCINFO["errno"]' will be set to the value + of 'errno'. For non-system errors, 'PROCINFO["errno"]' will be + zero. + 'FILENAME' The name of the current input file. When no data files are listed on the command line, 'awk' reads from the standard input and @@ -10363,6 +10546,10 @@ they are not special: 'PROCINFO["egid"]' The value of the 'getegid()' system call. + 'PROCINFO["errno"]' + The value of the C 'errno' variable when 'ERRNO' is set to the + associated error message. + 'PROCINFO["euid"]' The value of the 'geteuid()' system call. @@ -10461,6 +10648,14 @@ they are not special: The following elements allow you to change 'gawk''s behavior: + 'PROCINFO["NONFATAL"]' + If this element exists, then I/O errors for all output + redirections become nonfatal. *Note Nonfatal::,. + + 'PROCINFO["OUTPUT_NAME", "NONFATAL"]' + Make output errors for OUTPUT_NAME be nonfatal. *Note + Nonfatal::,. + 'PROCINFO["COMMAND", "pty"]' For two-way communication to COMMAND, use a pseudo-tty instead of setting up a two-way pipe. *Note Two-way I/O::, for more @@ -11863,6 +12058,21 @@ brackets ([ ]): truncated toward zero. For example, 'int(3)' is 3, 'int(3.9)' is 3, 'int(-3.9)' is -3, and 'int(-3)' is -3 as well. +'intdiv(NUMERATOR, DENOMINATOR, RESULT)' + Perform integer division, similar to the standard C function of the + same name. First, truncate 'numerator' and 'denominator' towards + zero, creating integer values. Clear the 'result' array, and then + set 'result["quotient"]' to the result of 'numerator / + denominator', truncated towards zero to an integer, and set + 'result["remainder"]' to the result of 'numerator % denominator', + truncated towards zero to an integer. This function is primarily + intended for use with arbitrary length integers; it avoids creating + MPFR arbitrary precision floating-point values (*note Arbitrary + Precision Integers::). + + This function is a 'gawk' extension. It is not available in + compatibility mode (*note Options::). + 'log(X)' Return the natural logarithm of X, if X is positive; otherwise, return 'NaN' ("not a number") on IEEE 754 systems. Additionally, @@ -13300,14 +13510,56 @@ File: gawk.info, Node: Type Functions, Next: I18N Functions, Prev: Bitwise Fu 9.1.7 Getting Type Information ------------------------------ -'gawk' provides a single function that lets you distinguish an array -from a scalar variable. This is necessary for writing code that -traverses every element of an array of arrays (*note Arrays of -Arrays::). +'gawk' provides two functions that lets you distinguish the type of a +variable. This is necessary for writing code that traverses every +element of an array of arrays (*note Arrays of Arrays::), and in other +contexts. 'isarray(X)' Return a true value if X is an array. Otherwise, return false. +'typeof(X)' + Return one of the following strings, depending upon the type of X: + + '"array"' + X is an array. + + '"regexp"' + X is a strongly typed regexp (*note Strong Regexp + Constants::). + + '"number"' + X is a number. + + '"string"' + X is a string. + + '"strnum"' + X is a string that might be a number, such as a field or the + result of calling 'split()'. (I.e., X has the STRNUM + attribute; *note Variable Typing::.) + + '"unassigned"' + X is a scalar variable that has not been assigned a value yet. + For example: + + BEGIN { + a[1] # creates a[1] but it has no assigned value + print typeof(a[1]) # scalar_u + } + + '"untyped"' + X has not yet been used yet at all; it can become a scalar or + an array. For example: + + BEGIN { + print typeof(x) # x never used --> untyped + mk_arr(x) + print typeof(x) # x now an array --> array + } + + function mk_arr(a) { a[1] = 1 } + 'isarray()' is meant for use in two circumstances. The first is when traversing a multidimensional array: you can test if an element is itself an array or not. The second is inside the body of a user-defined @@ -13321,6 +13573,14 @@ parameter is an array or not. that has not been previously used to 'isarray()', 'gawk' ends up turning it into a scalar. + The 'typeof()' function is general; it allows you to determine if a +variable or function parameter is a scalar, an array, or a strongly +typed regexp. + + 'isarray()' is deprecated; you should use 'typeof()' instead. You +should replace any existing uses of 'isarray(var)' in your code with +'typeof(var) == "array"'. + File: gawk.info, Node: I18N Functions, Prev: Type Functions, Up: Built-in @@ -19886,8 +20146,7 @@ output. They are as follows: you typed when you wrote it. This is because 'gawk' creates the profiled version by "pretty-printing" its internal representation of the program. The advantage to this is that 'gawk' can produce a standard -representation. The disadvantage is that all source code comments are -lost. Also, things such as: +representation. Also, things such as: /foo/ @@ -19946,8 +20205,24 @@ the 'Ctrl-\' key. called this way, 'gawk' "pretty-prints" the program into 'awkprof.out', without any execution counts. - NOTE: The '--pretty-print' option still runs your program. This - will change in the next major release. + NOTE: Once upon a time, the '--pretty-print' option would also run + your program. This is is no longer the case. + + There is a significant difference between the output created when +profiling, and that created when pretty-printing. Pretty-printed output +preserves the original comments that were in the program, although their +placement may not correspond exactly to their original locations in the +source code. + + However, as a deliberate design decision, profiling output _omits_ +the original program's comments. This allows you to focus on the +execution count data and helps you avoid the temptation to use the +profiler for pretty-printing. + + Additionally, pretty-printed output does not have the leading +indentation that the profiling output does. This makes it easy to +pretty-print your code once development is completed, and then use the +result as the final version of your program. File: gawk.info, Node: Advanced Features Summary, Prev: Profiling, Up: Advanced Features @@ -19988,8 +20263,7 @@ File: gawk.info, Node: Advanced Features Summary, Prev: Profiling, Up: Advanc 'USR1' signal while profiling causes 'gawk' to dump the profile and keep going, including a function call stack. - * You can also just "pretty-print" the program. This currently also - runs the program, but that will change in the next major release. + * You can also just "pretty-print" the program. File: gawk.info, Node: Internationalization, Next: Debugger, Prev: Advanced Features, Up: Top @@ -21667,6 +21941,62 @@ some limitations. A few that it's worth being aware of are: * The 'gawk' debugger only accepts source code supplied with the '-f' option. + One other point is worth disucssing. Conventional debuggers run in a +separate process (and thus address space) from the programs that they +debug (the "debuggee", if you will). + + The 'gawk' debugger is different; it is an integrated part of 'gawk' +itself. This makes it possible, in rare cases, for 'gawk' to become an +excellent demonstrator of Heisenburg Uncertainty physics, where the mere +act of observing something can change it. Consider the following:(1) + + $ cat test.awk + -| { print typeof($1), typeof($2) } + $ cat test.data + -| abc 123 + $ gawk -f test.awk test.data + -| strnum strnum + + This is all as expected: field data has the STRNUM attribute (*note +Variable Typing::). Now watch what happens when we run this program +under the debugger: + + $ gawk -D -f test.awk test.data + gawk> w $1 Set watchpoint on $1 + -| Watchpoint 1: $1 + gawk> w $2 Set watchpoint on $2 + -| Watchpoint 2: $2 + gawk> r Start the program + -| Starting program: + -| Stopping in Rule ... + -| Watchpoint 1: $1 Watchpoint fires + -| Old value: "" + -| New value: "abc" + -| main() at `test.awk':1 + -| 1 { print typeof($1), typeof($2) } + gawk> n Keep going ... + -| Watchpoint 2: $2 Watchpoint fires + -| Old value: "" + -| New value: "123" + -| main() at `test.awk':1 + -| 1 { print typeof($1), typeof($2) } + gawk> n Get result from typeof() + -| strnum string Result for $2 isn't right + -| Program exited normally with exit value: 0 + gawk> quit + + In this case, the act of comparing the new value of '$2' with the old +one caused 'gawk' to evaluate it and determine that it is indeed a +string, and this is reflected in the result of 'typeof()'. + + Cases like this where the debugger is not transparent to the +program's execution should be rare. If you encounter one, please report +it (*note Bugs::). + + ---------- Footnotes ---------- + + (1) Thanks to Hermann Peifer for this example. + File: gawk.info, Node: Debugging Summary, Prev: Limitations, Up: Debugger @@ -21695,6 +22025,9 @@ File: gawk.info, Node: Debugging Summary, Prev: Limitations, Up: Debugger it is used by the debugger to provide command-line history and editing. + * Usually, the debugger does not not affect the program being + debugged, but occasionally it can. + File: gawk.info, Node: Arbitrary Precision Arithmetic, Next: Dynamic Extensions, Prev: Debugger, Up: Top @@ -22428,6 +22761,62 @@ the following: gawk -M 'BEGIN { n = 13; print n % 2 }' + When dividing two arbitrary precision integers with either '/' or +'%', the result is typically an arbitrary precision floating point value +(unless the denominator evenly divides into the numerator). In order to +do integer division or remainder with arbitrary precision integers, use +the built-in 'intdiv()' function (*note Numeric Functions::). + + You can simulate the 'intdiv()' function in standard 'awk' using this +user-defined function: + + # intdiv --- do integer division + + function intdiv(numerator, denominator, result) + { + split("", result) + + numerator = int(numerator) + denominator = int(denominator) + result["quotient"] = int(numerator / denominator) + result["remainder"] = int(numerator % denominator) + + return 0.0 + } + + The following example program, contributed by Katie Wasserman, uses +'intdiv()' to compute the digits of pi to as many places as you choose +to set: + + # pi.awk --- compute the digits of pi + + BEGIN { + digits = 100000 + two = 2 * 10 ^ digits + pi = two + for (m = digits * 4; m > 0; --m) { + d = m * 2 + 1 + x = pi * m + intdiv(x, d, result) + pi = result["quotient"] + pi = pi + two + } + print pi + } + + When asked about the algorithm used, Katie replied: + + It's not that well known but it's not that obscure either. It's + Euler's modification to Newton's method for calculating pi. Take a + look at lines (23) - (25) here: + <http://mathworld.wolfram.com/PiFormulas.html>. + + The algorithm I wrote simply expands the multiply by 2 and works + from the innermost expression outwards. I used this to program HP + calculators because it's quite easy to modify for tiny memory + devices with smallish word sizes. See + <http://www.hpmuseum.org/cgi-sys/cgiwrap/hpmuseum/articles.cgi?read=899>. + ---------- Footnotes ---------- (1) Weisstein, Eric W. 'Sylvester's Sequence'. From MathWorld--A @@ -22790,6 +23179,7 @@ API in detail. * Symbol Table Access:: Functions for accessing global variables. * Array Manipulation:: Functions for working with arrays. +* Redirection API:: How to access and manipulate redirections. * Extension API Variables:: Variables provided by the API. * Extension API Boilerplate:: Boilerplate code for using the API. @@ -22845,6 +23235,8 @@ operations: - Flattening an array for easy C-style looping over all its indices and elements + * Accessing and manipulating redirections. + Some points about using the API: * The following types, macros, and/or functions are referenced in @@ -24050,7 +24442,7 @@ using 'release_value()'. 'double' to store. -File: gawk.info, Node: Array Manipulation, Next: Extension API Variables, Prev: Symbol Table Access, Up: Extension API Description +File: gawk.info, Node: Array Manipulation, Next: Redirection API, Prev: Symbol Table Access, Up: Extension API Description 16.4.11 Array Manipulation -------------------------- @@ -24534,9 +24926,78 @@ array: environment variable.) -File: gawk.info, Node: Extension API Variables, Next: Extension API Boilerplate, Prev: Array Manipulation, Up: Extension API Description +File: gawk.info, Node: Redirection API, Next: Extension API Variables, Prev: Array Manipulation, Up: Extension API Description + +16.4.12 Accessing and Manipulating Redirections +----------------------------------------------- + +The following function allows extensions to access and manipulate +redirections. + +'awk_bool_t get_file(const char *name,' +' size_t name_len,' +' const char *filetype,' +' int fd,' +' const awk_input_buf_t **ibufp,' +' const awk_output_buf_t **obufp);' + Look up a file in 'gawk''s internal redirection table. If 'name' + is 'NULL' or 'name_len' is zero, return data for the currently open + input file corresponding to 'FILENAME'. (This does not access the + 'filetype' argument, so that may be undefined). If the file is not + already open, attempt to open it. The 'filetype' argument must be + zero-terminated and should be one of: + + '">"' + A file opened for output. + + '">>"' + A file opened for append. + + '"<"' + A file opened for input. + + '"|>"' + A pipe opened for output. + + '"|<"' + A pipe opened for input. + + '"|&"' + A two-way coprocess. + + On error, return a 'false' value. Otherwise, return 'true', and + return additional information about the redirection in the 'ibufp' + and 'obufp' pointers. For input redirections, the '*ibufp' value + should be non-'NULL', and '*obufp' should be 'NULL'. For output + redirections, the '*obufp' value should be non-'NULL', and '*ibufp' + should be 'NULL'. For two-way coprocesses, both values should be + non-'NULL'. + + In the usual case, the extension is interested in '(*ibufp)->fd' + and/or 'fileno((*obufp)->fp)'. If the file is not already open, + and the 'fd' argument is non-negative, 'gawk' will use that file + descriptor instead of opening the file in the usual way. If 'fd' + is non-negative, but the file exists already, 'gawk' ignores 'fd' + and returns the existing file. It is the caller's responsibility + to notice that neither the 'fd' in the returned 'awk_input_buf_t' + nor the 'fd' in the returned 'awk_output_buf_t' matches the + requested value. -16.4.12 API Variables + Note that supplying a file descriptor is currently _not_ supported + for pipes. However, supplying a file descriptor should work for + input, output, append, and two-way (coprocess) sockets. If + 'filetype' is two-way, 'gawk' assumes that it is a socket! Note + that in the two-way case, the input and output file descriptors may + differ. To check for success, you must check whether either + matches. + + It is anticipated that this API function will be used to implement +I/O multiplexing and a socket library. + + +File: gawk.info, Node: Extension API Variables, Next: Extension API Boilerplate, Prev: Redirection API, Up: Extension API Description + +16.4.13 API Variables --------------------- The API provides two sets of variables. The first provides information @@ -24553,7 +25014,7 @@ information about how 'gawk' was invoked. File: gawk.info, Node: Extension Versioning, Next: Extension API Informational Variables, Up: Extension API Variables -16.4.12.1 API Version Constants and Variables +16.4.13.1 API Version Constants and Variables ............................................. The API provides both a "major" and a "minor" version number. The API @@ -24602,7 +25063,7 @@ Boilerplate::). File: gawk.info, Node: Extension API Informational Variables, Prev: Extension Versioning, Up: Extension API Variables -16.4.12.2 Informational Variables +16.4.13.2 Informational Variables ................................. The API provides access to several variables that describe whether the @@ -24637,7 +25098,7 @@ change during execution. File: gawk.info, Node: Extension API Boilerplate, Prev: Extension API Variables, Up: Extension API Description -16.4.13 Boilerplate Code +16.4.14 Boilerplate Code ------------------------ As mentioned earlier (*note Extension Mechanism Outline::), the function @@ -25965,15 +26426,17 @@ project. * GD graphics library extension + * MPFR library extension (this provides access to a number of MPFR + functions that 'gawk''s native MPFR support does not) + * PDF extension * PostgreSQL extension - * MPFR library extension (this provides access to a number of MPFR - functions that 'gawk''s native MPFR support does not) - * Redis extension + * Select extension + * XML parser extension, using the Expat (http://expat.sourceforge.net) XML parsing library @@ -26386,6 +26849,9 @@ current version of 'gawk'. - Directories on the command line produce a warning and are skipped (*note Command-line directories::) + - Output with 'print' and 'printf' need not be fatal (*note + Nonfatal::) + * New keywords: - The 'BEGINFILE' and 'ENDFILE' special patterns (*note @@ -26435,6 +26901,9 @@ current version of 'gawk'. - The 'bindtextdomain()', 'dcgettext()', and 'dcngettext()' functions for internationalization (*note Programmer i18n::) + - The 'intdiv()' 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 @@ -26488,6 +26957,11 @@ current version of 'gawk'. - Ultrix + * Support for the following systems was removed from the code for + 'gawk' version 4.2: + + - MirBSD + File: gawk.info, Node: Feature History, Next: Common Extensions, Prev: POSIX/GNU, Up: Language History @@ -26879,6 +27353,34 @@ POSIX 'awk', in the order they were added to 'gawk'. * 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 'intdiv()' function. *Note Numeric Functions::. + + * The maximum number of hexadecimal digits in '\x' escapes is now + two. *Note Escape Sequences::. + + * Nonfatal output with 'print' and 'printf'. *Note Nonfatal::. + + * For many years, POSIX specified that default field splitting only + allowed spaces and tabs to separate fields, and this was how 'gawk' + behaved with '--posix'. As of 2013, the standard restored + historical behavior, and now default field splitting with '--posix' + also allows newlines to separate fields. + + * Support for MirBSD was removed. + + * Support for GNU/Linux on Alpha was removed. + File: gawk.info, Node: Common Extensions, Next: Ranges and Locales, Prev: Feature History, Up: Language History @@ -27397,7 +27899,9 @@ Various '.c', '.y', and '.h' files 'doc/igawk.1' The 'troff' source for a manual page describing the 'igawk' program - presented in *note Igawk Program::. + presented in *note Igawk Program::. (Since 'gawk' can do its own + '@include' processing, neither 'igawk' nor 'igawk.1' are + installed.) 'doc/Makefile.in' The input file used during the configuration process to generate @@ -27439,17 +27943,22 @@ Various '.c', '.y', and '.h' files contains a 'Makefile.in' file, which 'configure' uses to generate a 'Makefile'. 'Makefile.am' is used by GNU Automake to create 'Makefile.in'. The library functions from *note Library - Functions::, and the 'igawk' program from *note Igawk Program::, - are included as ready-to-use files in the 'gawk' distribution. - They are installed as part of the installation process. The rest - of the programs in this Info file are available in appropriate - subdirectories of 'awklib/eg'. + Functions::, are included as ready-to-use files in the 'gawk' + distribution. They are installed as part of the installation + process. The rest of the programs in this Info file are available + in appropriate subdirectories of 'awklib/eg'. 'extension/*' The source code, manual pages, and infrastructure files for the sample extensions included with 'gawk'. *Note Dynamic Extensions::, for more information. +'extras/*' + Additional non-essential files. Currently, this directory contains + some shell startup files to be installed in '/etc/profile.d' to aid + in manipulating the 'AWKPATH' and 'AWKLIBPATH' environment + variables. *Note Shell Startup Files::, for more information. + 'posix/*' Files needed for building 'gawk' on POSIX-compliant systems. @@ -27480,11 +27989,12 @@ for your system yourself. * Menu: * Quick Installation:: Compiling 'gawk' under Unix. +* Shell Startup Files:: Shell convenience functions. * Additional Configuration Options:: Other compile-time options. * Configuration Philosophy:: How it's all supposed to work. -File: gawk.info, Node: Quick Installation, Next: Additional Configuration Options, Up: Unix Installation +File: gawk.info, Node: Quick Installation, Next: Shell Startup Files, Up: Unix Installation B.2.1 Compiling 'gawk' for Unix-Like Systems -------------------------------------------- @@ -27539,9 +28049,42 @@ will be asked for your password, and you will have to have been set up previously as a user who is allowed to run the 'sudo' command. -File: gawk.info, Node: Additional Configuration Options, Next: Configuration Philosophy, Prev: Quick Installation, Up: Unix Installation +File: gawk.info, Node: Shell Startup Files, Next: Additional Configuration Options, Prev: Quick Installation, Up: Unix Installation + +B.2.2 Shell Startup Files +------------------------- + +The distribution contains shell startup files 'gawk.sh' and 'gawk.csh' +containing functions to aid in manipulating the 'AWKPATH' and +'AWKLIBPATH' environment variables. On a Fedora system, these files +should be installed in '/etc/profile.d'; on other platforms, the +appropriate location may be different. + +'gawkpath_default' + Reset the 'AWKPATH' environment variable to its default value. + +'gawkpath_prepend' + Add the argument to the front of the 'AWKPATH' environment + variable. + +'gawkpath_append' + Add the argument to the end of the 'AWKPATH' environment variable. -B.2.2 Additional Configuration Options +'gawklibpath_default' + Reset the 'AWKLIBPATH' environment variable to its default value. + +'gawklibpath_prepend' + Add the argument to the front of the 'AWKLIBPATH' environment + variable. + +'gawklibpath_append' + Add the argument to the end of the 'AWKLIBPATH' environment + variable. + + +File: gawk.info, Node: Additional Configuration Options, Next: Configuration Philosophy, Prev: Shell Startup Files, Up: Unix Installation + +B.2.3 Additional Configuration Options -------------------------------------- There are several additional options you may use on the 'configure' @@ -27585,7 +28128,7 @@ supplied by 'configure'. File: gawk.info, Node: Configuration Philosophy, Prev: Additional Configuration Options, Up: Unix Installation -B.2.3 The Configuration Process +B.2.4 The Configuration Process ------------------------------- This minor node is of interest only if you know something about using @@ -31576,20 +32119,20 @@ Index * --include option: Options. (line 159) * --lint option: Command Line. (line 20) * --lint option <1>: Options. (line 184) -* --lint-old option: Options. (line 294) +* --lint-old option: Options. (line 289) * --load option: Options. (line 172) * --non-decimal-data option: Options. (line 209) * --non-decimal-data option <1>: Nondecimal Data. (line 6) * --non-decimal-data option, strtonum() function and: Nondecimal Data. (line 35) -* --optimize option: Options. (line 236) -* --posix option: Options. (line 254) -* --posix option, --traditional option and: Options. (line 272) +* --optimize option: Options. (line 234) +* --posix option: Options. (line 252) +* --posix option, --traditional option and: Options. (line 267) * --pretty-print option: Options. (line 223) -* --profile option: Options. (line 242) +* --profile option: Options. (line 240) * --profile option <1>: Profiling. (line 12) -* --re-interval option: Options. (line 278) -* --sandbox option: Options. (line 285) +* --re-interval option: Options. (line 273) +* --sandbox option: Options. (line 280) * --sandbox option, disabling system() function: I/O Functions. (line 129) * --sandbox option, input redirection with getline: Getline. (line 19) @@ -31597,9 +32140,9 @@ Index (line 6) * --source option: Options. (line 117) * --traditional option: Options. (line 82) -* --traditional option, --posix option and: Options. (line 272) +* --traditional option, --posix option and: Options. (line 267) * --use-lc-numeric option: Options. (line 218) -* --version option: Options. (line 299) +* --version option: Options. (line 294) * --with-whiny-user-strftime configuration option: Additional Configuration Options. (line 37) * -b option: Options. (line 69) @@ -31609,31 +32152,31 @@ Index * -D option: Options. (line 108) * -e option: Options. (line 117) * -E option: Options. (line 125) -* -e option <1>: Options. (line 335) +* -e option <1>: Options. (line 330) * -f option: Long. (line 12) * -F option: Options. (line 21) * -f option <1>: Options. (line 25) -* -F option, -Ft sets FS to TAB: Options. (line 307) +* -F option, -Ft sets FS to TAB: Options. (line 302) * -F option, command-line: Command Line Field Separator. (line 6) -* -f option, multiple uses: Options. (line 312) +* -f option, multiple uses: Options. (line 307) * -g option: Options. (line 147) * -h option: Options. (line 154) * -i option: Options. (line 159) * -l option: Options. (line 172) * -l option <1>: Options. (line 184) -* -L option: Options. (line 294) +* -L option: Options. (line 289) * -M option: Options. (line 203) * -n option: Options. (line 209) * -N option: Options. (line 218) * -o option: Options. (line 223) -* -O option: Options. (line 236) -* -p option: Options. (line 242) -* -P option: Options. (line 254) -* -r option: Options. (line 278) -* -S option: Options. (line 285) +* -O option: Options. (line 234) +* -p option: Options. (line 240) +* -P option: Options. (line 252) +* -r option: Options. (line 273) +* -S option: Options. (line 280) * -v option: Options. (line 32) -* -V option: Options. (line 299) +* -V option: Options. (line 294) * -v option <1>: Assignment Options. (line 12) * -W option: Options. (line 47) * . (period), regexp operator: Regexp Operators. (line 44) @@ -31706,16 +32249,16 @@ Index (line 6) * \ (backslash), in bracket expressions: Bracket Expressions. (line 17) * \ (backslash), in escape sequences: Escape Sequences. (line 6) -* \ (backslash), in escape sequences <1>: Escape Sequences. (line 100) +* \ (backslash), in escape sequences <1>: Escape Sequences. (line 103) * \ (backslash), in escape sequences, POSIX and: Escape Sequences. - (line 105) + (line 108) * \ (backslash), in regexp constants: Computed Regexps. (line 30) * \ (backslash), in shell commands: Quoting. (line 48) * \ (backslash), regexp operator: Regexp Operators. (line 18) -* \ (backslash), \" escape sequence: Escape Sequences. (line 82) +* \ (backslash), \" escape sequence: Escape Sequences. (line 85) * \ (backslash), \' operator (gawk): GNU Regexp Operators. (line 59) -* \ (backslash), \/ escape sequence: Escape Sequences. (line 73) +* \ (backslash), \/ escape sequence: Escape Sequences. (line 76) * \ (backslash), \< operator (gawk): GNU Regexp Operators. (line 33) * \ (backslash), \> operator (gawk): GNU Regexp Operators. @@ -31932,7 +32475,7 @@ Index * awf (amazingly workable formatter) program: Glossary. (line 24) * awk debugging, enabling: Options. (line 108) * awk language, POSIX version: Assignment Ops. (line 138) -* awk profiling, enabling: Options. (line 242) +* awk profiling, enabling: Options. (line 240) * awk programs: Getting Started. (line 12) * awk programs <1>: Executable Scripts. (line 6) * awk programs <2>: Two Rules. (line 6) @@ -32003,16 +32546,16 @@ Index (line 6) * backslash (\), in bracket expressions: Bracket Expressions. (line 17) * backslash (\), in escape sequences: Escape Sequences. (line 6) -* backslash (\), in escape sequences <1>: Escape Sequences. (line 100) +* backslash (\), in escape sequences <1>: Escape Sequences. (line 103) * backslash (\), in escape sequences, POSIX and: Escape Sequences. - (line 105) + (line 108) * backslash (\), in regexp constants: Computed Regexps. (line 30) * backslash (\), in shell commands: Quoting. (line 48) * backslash (\), regexp operator: Regexp Operators. (line 18) -* backslash (\), \" escape sequence: Escape Sequences. (line 82) +* backslash (\), \" escape sequence: Escape Sequences. (line 85) * backslash (\), \' operator (gawk): GNU Regexp Operators. (line 59) -* backslash (\), \/ escape sequence: Escape Sequences. (line 73) +* backslash (\), \/ escape sequence: Escape Sequences. (line 76) * backslash (\), \< operator (gawk): GNU Regexp Operators. (line 33) * backslash (\), \> operator (gawk): GNU Regexp Operators. @@ -32131,7 +32674,7 @@ Index * Brennan, Michael <5>: Other Versions. (line 6) * Brennan, Michael <6>: Other Versions. (line 48) * Brian Kernighan's awk: When. (line 21) -* Brian Kernighan's awk <1>: Escape Sequences. (line 109) +* Brian Kernighan's awk <1>: Escape Sequences. (line 112) * Brian Kernighan's awk <2>: GNU Regexp Operators. (line 85) * Brian Kernighan's awk <3>: Regexp Field Splitting. @@ -32339,7 +32882,7 @@ Index * cosine: Numeric Functions. (line 16) * counting: Wc Program. (line 6) * csh utility: Statements/Lines. (line 43) -* csh utility, POSIXLY_CORRECT environment variable: Options. (line 353) +* csh utility, POSIXLY_CORRECT environment variable: Options. (line 348) * csh utility, |& operator, comparison with: Two-way I/O. (line 27) * ctime() user-defined function: Function Example. (line 74) * currency symbols, localization: Explaining gettext. (line 104) @@ -32369,12 +32912,12 @@ Index * dark corner, CONVFMT variable: Strings And Numbers. (line 39) * dark corner, escape sequences: Other Arguments. (line 38) * dark corner, escape sequences, for metacharacters: Escape Sequences. - (line 141) + (line 144) * dark corner, exit statement: Exit Statement. (line 30) * dark corner, field separators: Full Line Fields. (line 22) * dark corner, FILENAME variable: Getline Notes. (line 19) -* dark corner, FILENAME variable <1>: Auto-set. (line 89) -* dark corner, FNR/NR variables: Auto-set. (line 313) +* dark corner, FILENAME variable <1>: Auto-set. (line 108) +* dark corner, FNR/NR variables: Auto-set. (line 344) * dark corner, format-control characters: Control Letters. (line 18) * dark corner, format-control characters <1>: Control Letters. (line 93) @@ -32528,7 +33071,7 @@ Index * debugger, read commands from a file: Debugger Info. (line 97) * debugging awk programs: Debugger. (line 6) * debugging gawk, bug reports: Bugs. (line 9) -* decimal point character, locale specific: Options. (line 269) +* decimal point character, locale specific: Options. (line 264) * decrement operators: Increment Ops. (line 35) * default keyword: Switch Statement. (line 6) * Deifik, Scott: Acknowledgments. (line 60) @@ -32569,12 +33112,12 @@ Index (line 132) * differences in awk and gawk, command-line directories: Command-line directories. (line 6) -* differences in awk and gawk, ERRNO variable: Auto-set. (line 73) +* differences in awk and gawk, ERRNO variable: Auto-set. (line 87) * differences in awk and gawk, error messages: Special FD. (line 19) * differences in awk and gawk, FIELDWIDTHS variable: User-modified. (line 37) * differences in awk and gawk, FPAT variable: User-modified. (line 43) -* differences in awk and gawk, FUNCTAB variable: Auto-set. (line 115) +* differences in awk and gawk, FUNCTAB variable: Auto-set. (line 134) * differences in awk and gawk, function arguments (gawk): Calling Built-in. (line 16) * differences in awk and gawk, getline command: Getline. (line 19) @@ -32597,7 +33140,7 @@ Index (line 262) * differences in awk and gawk, print/printf statements: Format Modifiers. (line 13) -* differences in awk and gawk, PROCINFO array: Auto-set. (line 129) +* differences in awk and gawk, PROCINFO array: Auto-set. (line 148) * differences in awk and gawk, read timeouts: Read Timeout. (line 6) * differences in awk and gawk, record separators: awk split records. (line 124) @@ -32605,9 +33148,11 @@ Index (line 43) * differences in awk and gawk, regular expressions: Case-sensitivity. (line 26) +* differences in awk and gawk, retrying input: Retrying Input. + (line 6) * differences in awk and gawk, RS/RT variables: gawk split records. (line 58) -* differences in awk and gawk, RT variable: Auto-set. (line 264) +* differences in awk and gawk, RT variable: Auto-set. (line 295) * differences in awk and gawk, single-character fields: Single Character Fields. (line 6) * differences in awk and gawk, split() function: String Functions. @@ -32615,7 +33160,7 @@ Index * differences in awk and gawk, strings: Scalar Constants. (line 20) * differences in awk and gawk, strings, storing: gawk split records. (line 76) -* differences in awk and gawk, SYMTAB variable: Auto-set. (line 268) +* differences in awk and gawk, SYMTAB variable: Auto-set. (line 299) * differences in awk and gawk, TEXTDOMAIN variable: User-modified. (line 152) * differences in awk and gawk, trunc-mod operation: Arithmetic Ops. @@ -32651,12 +33196,12 @@ Index * dump debugger command: Miscellaneous Debugger Commands. (line 9) * dupword.awk program: Dupword Program. (line 31) -* dynamic profiling: Profiling. (line 178) +* dynamic profiling: Profiling. (line 177) * dynamically loaded extensions: Dynamic Extensions. (line 6) * e debugger command (alias for enable): Breakpoint Control. (line 73) * EBCDIC: Ordinal Functions. (line 45) -* effective group ID of gawk user: Auto-set. (line 134) -* effective user ID of gawk user: Auto-set. (line 138) +* effective group ID of gawk user: Auto-set. (line 153) +* effective user ID of gawk user: Auto-set. (line 161) * egrep utility: Bracket Expressions. (line 26) * egrep utility <1>: Egrep Program. (line 6) * egrep.awk program: Egrep Program. (line 53) @@ -32710,14 +33255,14 @@ Index (line 11) * equals sign (=), == operator <1>: Precedence. (line 64) * EREs (Extended Regular Expressions): Bracket Expressions. (line 26) -* ERRNO variable: Auto-set. (line 73) +* ERRNO variable: Auto-set. (line 87) * ERRNO variable <1>: TCP/IP Networking. (line 54) * ERRNO variable, with BEGINFILE pattern: BEGINFILE/ENDFILE. (line 26) * ERRNO variable, with close() function: Close Files And Pipes. (line 140) * ERRNO variable, with getline command: Getline. (line 19) * error handling: Special FD. (line 19) -* error handling, ERRNO variable and: Auto-set. (line 73) +* error handling, ERRNO variable and: Auto-set. (line 87) * error output: Special FD. (line 6) * escape processing, gsub()/gensub()/sub() functions: Gory Details. (line 6) @@ -32758,7 +33303,7 @@ Index (line 102) * exp: Numeric Functions. (line 19) * expand utility: Very Simple. (line 73) -* Expat XML parser library: gawkextlib. (line 35) +* Expat XML parser library: gawkextlib. (line 37) * exponent: Numeric Functions. (line 19) * expressions: Expressions. (line 6) * expressions, as patterns: Expression Patterns. (line 6) @@ -32777,7 +33322,7 @@ Index (line 6) * extension API version: Extension Versioning. (line 6) -* extension API, version number: Auto-set. (line 223) +* extension API, version number: Auto-set. (line 246) * extension example: Extension Example. (line 6) * extension registration: Registration Functions. (line 6) @@ -32833,7 +33378,6 @@ Index * field separators, choice of: Field Separators. (line 50) * field separators, FIELDWIDTHS variable and: User-modified. (line 37) * field separators, FPAT variable and: User-modified. (line 43) -* field separators, POSIX and: Fields. (line 6) * field separators, regular expressions as: Field Separators. (line 50) * field separators, regular expressions as <1>: Regexp Field Splitting. (line 6) @@ -32861,7 +33405,7 @@ Index * file names, in compatibility mode: Special Caveats. (line 9) * file names, standard streams in gawk: Special FD. (line 48) * FILENAME variable: Reading Files. (line 6) -* FILENAME variable <1>: Auto-set. (line 89) +* FILENAME variable <1>: Auto-set. (line 108) * FILENAME variable, getline, setting with: Getline Notes. (line 19) * filenames, assignments as: Ignoring Assigns. (line 6) * files, .gmo: Explaining gettext. (line 42) @@ -32929,8 +33473,8 @@ Index * fnmatch() extension function: Extension Sample Fnmatch. (line 12) * FNR variable: Records. (line 6) -* FNR variable <1>: Auto-set. (line 99) -* FNR variable, changing: Auto-set. (line 313) +* FNR variable <1>: Auto-set. (line 118) +* FNR variable, changing: Auto-set. (line 344) * for statement: For Statement. (line 6) * for statement, looping over arrays: Scanning an Array. (line 20) * fork() extension function: Extension Sample Fork. @@ -32968,7 +33512,7 @@ Index * FS variable, --field-separator option and: Options. (line 21) * FS variable, as null string: Single Character Fields. (line 20) -* FS variable, as TAB character: Options. (line 266) +* FS variable, as TAB character: Options. (line 261) * FS variable, changing value of: Field Separators. (line 34) * FS variable, running awk programs and: Cut Program. (line 63) * FS variable, setting from command line: Command Line Field Separator. @@ -32982,7 +33526,7 @@ Index * FSF (Free Software Foundation) <3>: Glossary. (line 405) * fts() extension function: Extension Sample File Functions. (line 60) -* FUNCTAB array: Auto-set. (line 115) +* FUNCTAB array: Auto-set. (line 134) * function calls: Function Calls. (line 6) * function calls, indirect: Indirect Calls. (line 6) * function calls, indirect, @-notation for: Indirect Calls. (line 47) @@ -33033,8 +33577,8 @@ Index * G., Daniel Richard: Acknowledgments. (line 60) * G., Daniel Richard <1>: Bugs. (line 73) * Garfinkle, Scott: Contributors. (line 35) -* gawk program, dynamic profiling: Profiling. (line 178) -* gawk version: Auto-set. (line 198) +* gawk program, dynamic profiling: Profiling. (line 177) +* gawk version: Auto-set. (line 221) * gawk, ARGIND variable in: Other Arguments. (line 15) * gawk, awk and: Preface. (line 21) * gawk, awk and <1>: This Manual. (line 14) @@ -33055,10 +33599,10 @@ Index * gawk, ERRNO variable in <1>: Close Files And Pipes. (line 140) * gawk, ERRNO variable in <2>: BEGINFILE/ENDFILE. (line 26) -* gawk, ERRNO variable in <3>: Auto-set. (line 73) +* gawk, ERRNO variable in <3>: Auto-set. (line 87) * gawk, ERRNO variable in <4>: TCP/IP Networking. (line 54) -* gawk, escape sequences: Escape Sequences. (line 118) -* gawk, extensions, disabling: Options. (line 254) +* gawk, escape sequences: Escape Sequences. (line 121) +* gawk, extensions, disabling: Options. (line 252) * gawk, features, adding: Adding Code. (line 6) * gawk, features, advanced: Advanced Features. (line 6) * gawk, field separators and: User-modified. (line 71) @@ -33070,7 +33614,7 @@ Index * gawk, FPAT variable in: Splitting By Content. (line 25) * gawk, FPAT variable in <1>: User-modified. (line 43) -* gawk, FUNCTAB array in: Auto-set. (line 115) +* gawk, FUNCTAB array in: Auto-set. (line 134) * gawk, function arguments and: Calling Built-in. (line 16) * gawk, hexadecimal numbers and: Nondecimal-numbers. (line 41) * gawk, IGNORECASE variable in: Case-sensitivity. (line 26) @@ -33100,7 +33644,7 @@ Index * gawk, octal numbers and: Nondecimal-numbers. (line 41) * gawk, OS/2 version of: PC Using. (line 17) * gawk, predefined variables and: Built-in Variables. (line 14) -* gawk, PROCINFO array in: Auto-set. (line 129) +* gawk, PROCINFO array in: Auto-set. (line 148) * gawk, PROCINFO array in <1>: Time Functions. (line 47) * gawk, PROCINFO array in <2>: Two-way I/O. (line 99) * gawk, regexp constants and: Using Constant Regexps. @@ -33112,21 +33656,27 @@ Index * gawk, regular expressions, precedence: Regexp Operators. (line 161) * gawk, RT variable in: awk split records. (line 124) * gawk, RT variable in <1>: Multiple Line. (line 130) -* gawk, RT variable in <2>: Auto-set. (line 264) +* gawk, RT variable in <2>: Auto-set. (line 295) * gawk, See Also awk: Preface. (line 34) * gawk, source code, obtaining: Getting. (line 6) * gawk, splitting fields and: Constant Size. (line 86) * gawk, string-translation functions: I18N Functions. (line 6) -* gawk, SYMTAB array in: Auto-set. (line 268) +* gawk, SYMTAB array in: Auto-set. (line 299) * gawk, TEXTDOMAIN variable in: User-modified. (line 152) * gawk, timestamps: Time Functions. (line 6) * gawk, uses for: Preface. (line 34) -* gawk, versions of, information about, printing: Options. (line 299) +* gawk, versions of, information about, printing: Options. (line 294) * gawk, VMS version of: VMS Installation. (line 6) * gawk, word-boundary operator: GNU Regexp Operators. (line 66) * gawkextlib: gawkextlib. (line 6) * gawkextlib project: gawkextlib. (line 6) +* gawklibpath_append shell function: Shell Startup Files. (line 29) +* gawklibpath_default shell function: Shell Startup Files. (line 22) +* gawklibpath_prepend shell function: Shell Startup Files. (line 25) +* gawkpath_append shell function: Shell Startup Files. (line 19) +* gawkpath_default shell function: Shell Startup Files. (line 12) +* gawkpath_prepend shell function: Shell Startup Files. (line 15) * General Public License (GPL): Glossary. (line 396) * General Public License, See GPL: Manual History. (line 11) * generate time values: Time Functions. (line 25) @@ -33180,7 +33730,7 @@ Index * gettext() function (C library): Explaining gettext. (line 63) * gettimeofday() extension function: Extension Sample Time. (line 12) -* git utility: gawkextlib. (line 29) +* git utility: gawkextlib. (line 31) * git utility <1>: Other Versions. (line 29) * git utility <2>: Accessing The Source. (line 10) @@ -33208,7 +33758,7 @@ Index * Grigera, Juan: Contributors. (line 58) * group database, reading: Group Functions. (line 6) * group file: Group Functions. (line 6) -* group ID of gawk user: Auto-set. (line 147) +* group ID of gawk user: Auto-set. (line 170) * groups, information about: Group Functions. (line 6) * gsub: Using Constant Regexps. (line 43) @@ -33230,7 +33780,7 @@ Index * history expansion, in debugger: Readline Support. (line 6) * histsort.awk program: History Sorting. (line 25) * Hughes, Phil: Acknowledgments. (line 43) -* HUP signal, for dynamic profiling: Profiling. (line 210) +* HUP signal, for dynamic profiling: Profiling. (line 209) * hyphen (-), - operator: Precedence. (line 51) * hyphen (-), - operator <1>: Precedence. (line 57) * hyphen (-), -- operator: Increment Ops. (line 48) @@ -33312,7 +33862,9 @@ Index * installing gawk: Installation. (line 6) * instruction tracing, in debugger: Debugger Info. (line 90) * int: Numeric Functions. (line 24) -* INT signal (MS-Windows): Profiling. (line 213) +* INT signal (MS-Windows): Profiling. (line 212) +* intdiv: Numeric Functions. (line 29) +* intdiv <1>: Numeric Functions. (line 29) * integer array indices: Numeric Array Subscripts. (line 31) * integers, arbitrary precision: Arbitrary Precision Integers. @@ -33368,7 +33920,7 @@ Index * Kernighan, Brian <8>: Other Versions. (line 13) * Kernighan, Brian <9>: Basic Data Typing. (line 54) * Kernighan, Brian <10>: Glossary. (line 206) -* kill command, dynamic profiling: Profiling. (line 187) +* kill command, dynamic profiling: Profiling. (line 186) * Knights, jedi: Undocumented. (line 6) * Kwok, Conrad: Contributors. (line 35) * l debugger command (alias for list): Miscellaneous Debugger Commands. @@ -33440,7 +33992,7 @@ Index * lint checking, empty programs: Command Line. (line 16) * lint checking, issuing warnings: Options. (line 184) * lint checking, POSIXLY_CORRECT environment variable: Options. - (line 338) + (line 333) * lint checking, undefined functions: Pass By Value/Reference. (line 85) * LINT variable: User-modified. (line 87) @@ -33456,14 +34008,14 @@ Index * loading, extensions: Options. (line 172) * local variables, in a function: Variable Scope. (line 6) * locale categories: Explaining gettext. (line 81) -* locale decimal point character: Options. (line 269) +* locale decimal point character: Options. (line 264) * locale, definition of: Locales. (line 6) * localization: I18N and L10N. (line 6) * localization, See internationalization, localization: I18N and L10N. (line 6) -* log: Numeric Functions. (line 29) +* log: Numeric Functions. (line 44) * log files, timestamps in: Time Functions. (line 6) -* logarithm: Numeric Functions. (line 29) +* logarithm: Numeric Functions. (line 44) * logical false/true: Truth Values. (line 6) * logical operators, See Boolean expressions: Boolean Ops. (line 6) * login information: Passwd Functions. (line 16) @@ -33500,12 +34052,12 @@ Index (line 9) * matching, leftmost longest: Multiple Line. (line 26) * matching, null strings: String Functions. (line 537) -* mawk utility: Escape Sequences. (line 118) +* mawk utility: Escape Sequences. (line 121) * mawk utility <1>: Getline/Pipe. (line 62) * mawk utility <2>: Concatenation. (line 36) * mawk utility <3>: Nextfile Statement. (line 47) * mawk utility <4>: Other Versions. (line 48) -* maximum precision supported by MPFR library: Auto-set. (line 212) +* maximum precision supported by MPFR library: Auto-set. (line 235) * McIlroy, Doug: Glossary. (line 257) * McPhee, Patrick: Contributors. (line 101) * message object files: Explaining gettext. (line 42) @@ -33517,8 +34069,8 @@ Index (line 48) * messages from extensions: Printing Messages. (line 6) * metacharacters in regular expressions: Regexp Operators. (line 6) -* metacharacters, escape sequences for: Escape Sequences. (line 137) -* minimum precision required by MPFR library: Auto-set. (line 215) +* metacharacters, escape sequences for: Escape Sequences. (line 140) +* minimum precision required by MPFR library: Auto-set. (line 238) * mktime: Time Functions. (line 25) * modifiers, in format specifiers: Format Modifiers. (line 6) * monetary information, localization: Explaining gettext. (line 104) @@ -33538,10 +34090,8 @@ Index * networks, programming: TCP/IP Networking. (line 6) * networks, support for: Special Network. (line 6) * newlines: Statements/Lines. (line 6) -* newlines <1>: Options. (line 260) +* newlines <1>: Options. (line 258) * newlines <2>: Boolean Ops. (line 69) -* newlines, as field separators: Default Field Splitting. - (line 6) * newlines, as record separators: awk split records. (line 12) * newlines, in dynamic regexps: Computed Regexps. (line 60) * newlines, in regexp constants: Computed Regexps. (line 70) @@ -33568,7 +34118,7 @@ Index * nexti debugger command: Debugger Execution Control. (line 49) * NF variable: Fields. (line 33) -* NF variable <1>: Auto-set. (line 104) +* NF variable <1>: Auto-set. (line 123) * NF variable, decrementing: Changing Fields. (line 107) * ni debugger command (alias for nexti): Debugger Execution Control. (line 49) @@ -33577,8 +34127,8 @@ Index (line 23) * not Boolean-logic operator: Boolean Ops. (line 6) * NR variable: Records. (line 6) -* NR variable <1>: Auto-set. (line 124) -* NR variable, changing: Auto-set. (line 313) +* NR variable <1>: Auto-set. (line 143) +* NR variable, changing: Auto-set. (line 344) * null strings: awk split records. (line 114) * null strings <1>: Regexp Field Splitting. (line 43) @@ -33698,7 +34248,7 @@ Index * p debugger command (alias for print): Viewing And Changing Data. (line 35) * Papadopoulos, Panos: Contributors. (line 129) -* parent process ID of gawk process: Auto-set. (line 187) +* parent process ID of gawk process: Auto-set. (line 210) * parentheses (), in a profile: Profiling. (line 146) * parentheses (), regexp operator: Regexp Operators. (line 81) * password file: Passwd Functions. (line 16) @@ -33742,14 +34292,14 @@ Index * plus sign (+), += operator <1>: Precedence. (line 94) * plus sign (+), regexp operator: Regexp Operators. (line 105) * pointers to functions: Indirect Calls. (line 6) -* portability: Escape Sequences. (line 100) +* portability: Escape Sequences. (line 103) * portability, #! (executable scripts): Executable Scripts. (line 33) * portability, ** operator and: Arithmetic Ops. (line 81) * portability, **= operator and: Assignment Ops. (line 144) * portability, ARGV variable: Executable Scripts. (line 59) * portability, backslash continuation and: Statements/Lines. (line 30) * portability, backslash in escape sequences: Escape Sequences. - (line 105) + (line 108) * portability, close() function and: Close Files And Pipes. (line 81) * portability, data files as single record: gawk split records. @@ -33767,7 +34317,7 @@ Index * portability, NF variable, decrementing: Changing Fields. (line 115) * portability, operators: Increment Ops. (line 60) * portability, operators, not in POSIX awk: Precedence. (line 97) -* portability, POSIXLY_CORRECT environment variable: Options. (line 358) +* portability, POSIXLY_CORRECT environment variable: Options. (line 353) * portability, substr() function: String Functions. (line 513) * portable object files: Explaining gettext. (line 37) * portable object files <1>: Translator i18n. (line 6) @@ -33788,7 +34338,7 @@ Index * POSIX awk, < operator and: Getline/File. (line 26) * POSIX awk, arithmetic operators and: Arithmetic Ops. (line 30) * POSIX awk, backslashes in string constants: Escape Sequences. - (line 105) + (line 108) * POSIX awk, BEGIN/END patterns: I/O And BEGIN/END. (line 15) * POSIX awk, bracket expressions and: Bracket Expressions. (line 26) * POSIX awk, bracket expressions and, character classes: Bracket Expressions. @@ -33800,9 +34350,7 @@ Index * POSIX awk, continue statement and: Continue Statement. (line 44) * POSIX awk, CONVFMT variable and: User-modified. (line 30) * POSIX awk, date utility and: Time Functions. (line 253) -* POSIX awk, field separators and: Fields. (line 6) -* POSIX awk, field separators and <1>: Full Line Fields. (line 16) -* POSIX awk, FS variable and: User-modified. (line 60) +* POSIX awk, field separators and: Full Line Fields. (line 16) * POSIX awk, function keyword in: Definition Syntax. (line 99) * POSIX awk, functions and, gsub()/sub(): Gory Details. (line 90) * POSIX awk, functions and, length(): String Functions. (line 179) @@ -33817,12 +34365,12 @@ Index * POSIX awk, regular expressions and: Regexp Operators. (line 161) * POSIX awk, timestamps and: Time Functions. (line 6) * POSIX awk, | I/O operator and: Getline/Pipe. (line 56) -* POSIX mode: Options. (line 254) -* POSIX mode <1>: Options. (line 338) +* POSIX mode: Options. (line 252) +* POSIX mode <1>: Options. (line 333) * POSIX, awk and: Preface. (line 21) * POSIX, gawk extensions not included in: POSIX/GNU. (line 6) * POSIX, programs, implementing in awk: Clones. (line 6) -* POSIXLY_CORRECT environment variable: Options. (line 338) +* POSIXLY_CORRECT environment variable: Options. (line 333) * PREC variable: User-modified. (line 124) * precedence: Increment Ops. (line 60) * precedence <1>: Precedence. (line 6) @@ -33869,11 +34417,11 @@ Index * printing, unduplicated lines of text: Uniq Program. (line 6) * printing, user information: Id Program. (line 6) * private variables: Library Names. (line 11) -* process group ID of gawk process: Auto-set. (line 181) -* process ID of gawk process: Auto-set. (line 184) +* process group ID of gawk process: Auto-set. (line 204) +* process ID of gawk process: Auto-set. (line 207) * processes, two-way communications with: Two-way I/O. (line 6) * processing data: Basic High Level. (line 6) -* PROCINFO array: Auto-set. (line 129) +* PROCINFO array: Auto-set. (line 148) * PROCINFO array <1>: Time Functions. (line 47) * PROCINFO array <2>: Passwd Functions. (line 6) * PROCINFO array, and communications via ptys: Two-way I/O. (line 99) @@ -33884,8 +34432,8 @@ Index * PROCINFO, values of sorted_in: Controlling Scanning. (line 26) * profiling awk programs: Profiling. (line 6) -* profiling awk programs, dynamically: Profiling. (line 178) -* program identifiers: Auto-set. (line 150) +* profiling awk programs, dynamically: Profiling. (line 177) +* program identifiers: Auto-set. (line 173) * program, definition of: Getting Started. (line 21) * programming conventions, --non-decimal-data option: Nondecimal Data. (line 35) @@ -33921,7 +34469,7 @@ Index * QuikTrim Awk: Other Versions. (line 139) * quit debugger command: Miscellaneous Debugger Commands. (line 102) -* QUIT signal (MS-Windows): Profiling. (line 213) +* QUIT signal (MS-Windows): Profiling. (line 212) * quoting in gawk command lines: Long. (line 26) * quoting in gawk command lines, tricks for: Quoting. (line 91) * quoting, for small awk programs: Comments. (line 27) @@ -33930,12 +34478,12 @@ Index * Rakitzis, Byron: History Sorting. (line 25) * Ramey, Chet: Acknowledgments. (line 60) * Ramey, Chet <1>: General Data Types. (line 6) -* rand: Numeric Functions. (line 34) +* rand: Numeric Functions. (line 49) * random numbers, Cliff: Cliff Random Function. (line 6) * random numbers, rand()/srand() functions: Numeric Functions. - (line 34) -* random numbers, seed of: Numeric Functions. (line 64) + (line 49) +* random numbers, seed of: Numeric Functions. (line 79) * range expressions (regexps): Bracket Expressions. (line 6) * range patterns: Ranges. (line 6) * range patterns, line continuation and: Ranges. (line 64) @@ -34005,7 +34553,7 @@ Index (line 60) * regular expressions, gawk, command-line options: GNU Regexp Operators. (line 73) -* regular expressions, interval expressions and: Options. (line 278) +* regular expressions, interval expressions and: Options. (line 273) * regular expressions, leftmost longest match: Leftmost Longest. (line 6) * regular expressions, operators: Regexp Usage. (line 19) @@ -34022,6 +34570,7 @@ Index * relational operators, See comparison operators: Typing and Comparison. (line 9) * replace in string: String Functions. (line 409) +* retrying input: Retrying Input. (line 6) * return debugger command: Debugger Execution Control. (line 54) * return statement, user-defined functions: Return Statement. (line 6) @@ -34045,7 +34594,7 @@ Index * right shift: Bitwise Functions. (line 54) * right shift, bitwise: Bitwise Functions. (line 32) * Ritchie, Dennis: Basic Data Typing. (line 54) -* RLENGTH variable: Auto-set. (line 251) +* RLENGTH variable: Auto-set. (line 282) * RLENGTH variable, match() function and: String Functions. (line 227) * Robbins, Arnold: Command Line Field Separator. (line 71) @@ -34071,11 +34620,11 @@ Index * RS variable <1>: User-modified. (line 133) * RS variable, multiline records and: Multiple Line. (line 17) * rshift: Bitwise Functions. (line 54) -* RSTART variable: Auto-set. (line 257) +* RSTART variable: Auto-set. (line 288) * RSTART variable, match() function and: String Functions. (line 227) * RT variable: awk split records. (line 124) * RT variable <1>: Multiple Line. (line 130) -* RT variable <2>: Auto-set. (line 264) +* RT variable <2>: Auto-set. (line 295) * Rubin, Paul: History. (line 30) * Rubin, Paul <1>: Contributors. (line 16) * rule, definition of: Getting Started. (line 21) @@ -34086,14 +34635,14 @@ Index (line 68) * sample debugging session: Sample Debugging Session. (line 6) -* sandbox mode: Options. (line 285) +* sandbox mode: Options. (line 280) * save debugger options: Debugger Info. (line 85) * scalar or array: Type Functions. (line 11) * scalar values: Basic Data Typing. (line 13) * scanning arrays: Scanning an Array. (line 6) * scanning multidimensional arrays: Multiscanning. (line 11) * Schorr, Andrew: Acknowledgments. (line 60) -* Schorr, Andrew <1>: Auto-set. (line 296) +* Schorr, Andrew <1>: Auto-set. (line 327) * Schorr, Andrew <2>: Contributors. (line 134) * Schreiber, Bert: Acknowledgments. (line 38) * Schreiber, Rita: Acknowledgments. (line 38) @@ -34112,7 +34661,7 @@ Index * sed utility: Full Line Fields. (line 22) * sed utility <1>: Simple Sed. (line 6) * sed utility <2>: Glossary. (line 16) -* seeding random number generator: Numeric Functions. (line 64) +* seeding random number generator: Numeric Functions. (line 79) * semicolon (;), AWKPATH variable and: PC Using. (line 10) * semicolon (;), separating statements in actions: Statements/Lines. (line 90) @@ -34124,7 +34673,6 @@ Index * separators, field <1>: User-modified. (line 113) * separators, field, FIELDWIDTHS variable and: User-modified. (line 37) * separators, field, FPAT variable and: User-modified. (line 43) -* separators, field, POSIX and: Fields. (line 6) * separators, for records: awk split records. (line 6) * separators, for records <1>: awk split records. (line 85) * separators, for records <2>: User-modified. (line 133) @@ -34176,14 +34724,14 @@ Index * sidebar, A Constant's Base Does Not Affect Its Value: Nondecimal-numbers. (line 63) * sidebar, Backslash Before Regular Characters: Escape Sequences. - (line 103) + (line 106) * sidebar, Changing FS Does Not Affect the Fields: Full Line Fields. (line 14) -* sidebar, Changing NR and FNR: Auto-set. (line 311) +* sidebar, Changing NR and FNR: Auto-set. (line 342) * sidebar, Controlling Output Buffering with system(): I/O Functions. (line 137) * sidebar, Escape Sequences for Metacharacters: Escape Sequences. - (line 135) + (line 138) * sidebar, FS and IGNORECASE: Field Splitting Summary. (line 37) * sidebar, Interactive Versus Noninteractive Buffering: I/O Functions. @@ -34205,19 +34753,19 @@ Index (line 130) * sidebar, Using \n in Bracket Expressions of Dynamic Regexps: Computed Regexps. (line 58) -* SIGHUP signal, for dynamic profiling: Profiling. (line 210) -* SIGINT signal (MS-Windows): Profiling. (line 213) -* signals, HUP/SIGHUP, for profiling: Profiling. (line 210) -* signals, INT/SIGINT (MS-Windows): Profiling. (line 213) -* signals, QUIT/SIGQUIT (MS-Windows): Profiling. (line 213) -* signals, USR1/SIGUSR1, for profiling: Profiling. (line 187) +* SIGHUP signal, for dynamic profiling: Profiling. (line 209) +* SIGINT signal (MS-Windows): Profiling. (line 212) +* signals, HUP/SIGHUP, for profiling: Profiling. (line 209) +* signals, INT/SIGINT (MS-Windows): Profiling. (line 212) +* signals, QUIT/SIGQUIT (MS-Windows): Profiling. (line 212) +* signals, USR1/SIGUSR1, for profiling: Profiling. (line 186) * signature program: Signature Program. (line 6) -* SIGQUIT signal (MS-Windows): Profiling. (line 213) -* SIGUSR1 signal, for dynamic profiling: Profiling. (line 187) +* SIGQUIT signal (MS-Windows): Profiling. (line 212) +* SIGUSR1 signal, for dynamic profiling: Profiling. (line 186) * silent debugger command: Debugger Execution Control. (line 10) -* sin: Numeric Functions. (line 75) -* sine: Numeric Functions. (line 75) +* sin: Numeric Functions. (line 90) +* sine: Numeric Functions. (line 90) * single quote ('): One-shot. (line 15) * single quote (') in gawk command lines: Long. (line 35) * single quote ('), in shell commands: Quoting. (line 48) @@ -34267,10 +34815,10 @@ Index * sprintf() function, OFMT variable and: User-modified. (line 113) * sprintf() function, print/printf statements and: Round Function. (line 6) -* sqrt: Numeric Functions. (line 78) +* sqrt: Numeric Functions. (line 93) * square brackets ([]), regexp operator: Regexp Operators. (line 56) -* square root: Numeric Functions. (line 78) -* srand: Numeric Functions. (line 82) +* square root: Numeric Functions. (line 93) +* srand: Numeric Functions. (line 97) * stack frame: Debugging Terms. (line 10) * Stallman, Richard: Manual History. (line 6) * Stallman, Richard <1>: Acknowledgments. (line 18) @@ -34342,9 +34890,9 @@ Index * substr: String Functions. (line 482) * substring: String Functions. (line 482) * Sumner, Andrew: Other Versions. (line 68) -* supplementary groups of gawk process: Auto-set. (line 228) +* supplementary groups of gawk process: Auto-set. (line 251) * switch statement: Switch Statement. (line 6) -* SYMTAB array: Auto-set. (line 268) +* SYMTAB array: Auto-set. (line 299) * syntactic ambiguity: /= operator vs. /=.../ regexp constant: Assignment Ops. (line 149) * system: I/O Functions. (line 107) @@ -34414,7 +34962,7 @@ Index (line 37) * troubleshooting, awk uses FS not IFS: Field Separators. (line 29) * troubleshooting, backslash before nonspecial character: Escape Sequences. - (line 105) + (line 108) * troubleshooting, division: Arithmetic Ops. (line 44) * troubleshooting, fatal errors, field widths, specifying: Constant Size. (line 22) @@ -34448,6 +34996,8 @@ Index * trunc-mod operation: Arithmetic Ops. (line 66) * truth values: Truth Values. (line 6) * type conversion: Strings And Numbers. (line 21) +* type, of variable: Type Functions. (line 14) +* typeof: Type Functions. (line 14) * u debugger command (alias for until): Debugger Execution Control. (line 82) * unassigned array elements: Reference to Elements. @@ -34470,7 +35020,7 @@ Index * uniq.awk program: Uniq Program. (line 65) * Unix: Glossary. (line 748) * Unix awk, backslashes in escape sequences: Escape Sequences. - (line 118) + (line 121) * Unix awk, close() function and: Close Files And Pipes. (line 132) * Unix awk, password files, field separators and: Command Line Field Separator. @@ -34490,10 +35040,11 @@ Index * user-modifiable variables: User-modified. (line 6) * users, information about, printing: Id Program. (line 6) * users, information about, retrieving: Passwd Functions. (line 16) -* USR1 signal, for dynamic profiling: Profiling. (line 187) +* USR1 signal, for dynamic profiling: Profiling. (line 186) * values, numeric: Basic Data Typing. (line 13) * values, string: Basic Data Typing. (line 13) * variable assignments and input files: Other Arguments. (line 26) +* variable type: Type Functions. (line 14) * variable typing: Typing and Comparison. (line 9) * variables: Other Features. (line 6) @@ -34524,10 +35075,10 @@ Index * variables, uninitialized, as array subscripts: Uninitialized Subscripts. (line 6) * variables, user-defined: Variables. (line 6) -* version of gawk: Auto-set. (line 198) -* version of gawk extension API: Auto-set. (line 223) -* version of GNU MP library: Auto-set. (line 206) -* version of GNU MPFR library: Auto-set. (line 208) +* version of gawk: Auto-set. (line 221) +* version of gawk extension API: Auto-set. (line 246) +* version of GNU MP library: Auto-set. (line 229) +* version of GNU MPFR library: Auto-set. (line 231) * vertical bar (|): Regexp Operators. (line 70) * vertical bar (|), | operator (I/O): Getline/Pipe. (line 10) * vertical bar (|), | operator (I/O) <1>: Precedence. (line 64) @@ -34564,7 +35115,7 @@ Index * whitespace, as field separators: Default Field Splitting. (line 6) * whitespace, functions, calling: Calling Built-in. (line 10) -* whitespace, newlines as: Options. (line 260) +* whitespace, newlines as: Options. (line 258) * Williams, Kent: Contributors. (line 35) * Woehlke, Matthew: Contributors. (line 80) * Woods, John: Contributors. (line 28) @@ -34594,559 +35145,563 @@ Index Tag Table: Node: Top1203 -Node: Foreword342141 -Node: Foreword446583 -Node: Preface48115 -Ref: Preface-Footnote-150987 -Ref: Preface-Footnote-251094 -Ref: Preface-Footnote-351328 -Node: History51470 -Node: Names53823 -Ref: Names-Footnote-154917 -Node: This Manual55064 -Ref: This Manual-Footnote-161546 -Node: Conventions61646 -Node: Manual History64001 -Ref: Manual History-Footnote-166997 -Ref: Manual History-Footnote-267038 -Node: How To Contribute67112 -Node: Acknowledgments68241 -Node: Getting Started73128 -Node: Running gawk75567 -Node: One-shot76757 -Node: Read Terminal78020 -Node: Long80052 -Node: Executable Scripts81565 -Ref: Executable Scripts-Footnote-184360 -Node: Comments84463 -Node: Quoting86947 -Node: DOS Quoting92465 -Node: Sample Data Files93140 -Node: Very Simple95735 -Node: Two Rules100637 -Node: More Complex102523 -Node: Statements/Lines105386 -Ref: Statements/Lines-Footnote-1109845 -Node: Other Features110110 -Node: When111047 -Ref: When-Footnote-1112801 -Node: Intro Summary112866 -Node: Invoking Gawk113750 -Node: Command Line115264 -Node: Options116062 -Ref: Options-Footnote-1131970 -Ref: Options-Footnote-2132200 -Node: Other Arguments132225 -Node: Naming Standard Input135172 -Node: Environment Variables136265 -Node: AWKPATH Variable136823 -Ref: AWKPATH Variable-Footnote-1140124 -Ref: AWKPATH Variable-Footnote-2140169 -Node: AWKLIBPATH Variable140430 -Node: Other Environment Variables141574 -Node: Exit Status145339 -Node: Include Files146016 -Node: Loading Shared Libraries149611 -Node: Obsolete151039 -Node: Undocumented151731 -Node: Invoking Summary152028 -Node: Regexp153688 -Node: Regexp Usage155142 -Node: Escape Sequences157179 -Node: Regexp Operators163194 -Ref: Regexp Operators-Footnote-1170611 -Ref: Regexp Operators-Footnote-2170758 -Node: Bracket Expressions170856 -Ref: table-char-classes172879 -Node: Leftmost Longest176016 -Node: Computed Regexps177319 -Node: GNU Regexp Operators180746 -Node: Case-sensitivity184425 -Ref: Case-sensitivity-Footnote-1187312 -Ref: Case-sensitivity-Footnote-2187547 -Node: Regexp Summary187655 -Node: Reading Files189121 -Node: Records191215 -Node: awk split records191948 -Node: gawk split records196880 -Ref: gawk split records-Footnote-1201424 -Node: Fields201461 -Ref: Fields-Footnote-1204241 -Node: Nonconstant Fields204327 -Ref: Nonconstant Fields-Footnote-1206563 -Node: Changing Fields206767 -Node: Field Separators212697 -Node: Default Field Splitting215395 -Node: Regexp Field Splitting216513 -Node: Single Character Fields219866 -Node: Command Line Field Separator220926 -Node: Full Line Fields224144 -Ref: Full Line Fields-Footnote-1225666 -Ref: Full Line Fields-Footnote-2225712 -Node: Field Splitting Summary225813 -Node: Constant Size227887 -Node: Splitting By Content232466 -Ref: Splitting By Content-Footnote-1236437 -Node: Multiple Line236600 -Ref: Multiple Line-Footnote-1242483 -Node: Getline242662 -Node: Plain Getline244866 -Node: Getline/Variable247505 -Node: Getline/File248654 -Node: Getline/Variable/File250040 -Ref: Getline/Variable/File-Footnote-1251644 -Node: Getline/Pipe251732 -Node: Getline/Variable/Pipe254437 -Node: Getline/Coprocess255570 -Node: Getline/Variable/Coprocess256835 -Node: Getline Notes257575 -Node: Getline Summary260370 -Ref: table-getline-variants260792 -Node: Read Timeout261540 -Ref: Read Timeout-Footnote-1265381 -Node: Command-line directories265439 -Node: Input Summary266344 -Node: Input Exercises269516 -Node: Printing270244 -Node: Print272021 -Node: Print Examples273478 -Node: Output Separators276258 -Node: OFMT278275 -Node: Printf279631 -Node: Basic Printf280416 -Node: Control Letters281990 -Node: Format Modifiers285978 -Node: Printf Examples291993 -Node: Redirection294479 -Node: Special FD301322 -Ref: Special FD-Footnote-1304490 -Node: Special Files304564 -Node: Other Inherited Files305181 -Node: Special Network306182 -Node: Special Caveats307042 -Node: Close Files And Pipes307991 -Ref: Close Files And Pipes-Footnote-1315184 -Ref: Close Files And Pipes-Footnote-2315332 -Node: Output Summary315483 -Node: Output Exercises316481 -Node: Expressions317160 -Node: Values318348 -Node: Constants319026 -Node: Scalar Constants319717 -Ref: Scalar Constants-Footnote-1320581 -Node: Nondecimal-numbers320831 -Node: Regexp Constants323845 -Node: Using Constant Regexps324371 -Node: Variables327534 -Node: Using Variables328191 -Node: Assignment Options330102 -Node: Conversion331976 -Node: Strings And Numbers332500 -Ref: Strings And Numbers-Footnote-1335564 -Node: Locale influences conversions335673 -Ref: table-locale-affects338431 -Node: All Operators339049 -Node: Arithmetic Ops339678 -Node: Concatenation342184 -Ref: Concatenation-Footnote-1345031 -Node: Assignment Ops345138 -Ref: table-assign-ops350130 -Node: Increment Ops351443 -Node: Truth Values and Conditions354903 -Node: Truth Values355977 -Node: Typing and Comparison357025 -Node: Variable Typing357845 -Node: Comparison Operators361469 -Ref: table-relational-ops361888 -Node: POSIX String Comparison365383 -Ref: POSIX String Comparison-Footnote-1366457 -Node: Boolean Ops366596 -Ref: Boolean Ops-Footnote-1371078 -Node: Conditional Exp371170 -Node: Function Calls372906 -Node: Precedence376786 -Node: Locales380445 -Node: Expressions Summary382077 -Node: Patterns and Actions384650 -Node: Pattern Overview385770 -Node: Regexp Patterns387447 -Node: Expression Patterns387989 -Node: Ranges391770 -Node: BEGIN/END394878 -Node: Using BEGIN/END395639 -Ref: Using BEGIN/END-Footnote-1398376 -Node: I/O And BEGIN/END398482 -Node: BEGINFILE/ENDFILE400798 -Node: Empty403705 -Node: Using Shell Variables404022 -Node: Action Overview406296 -Node: Statements408621 -Node: If Statement410469 -Node: While Statement411964 -Node: Do Statement413992 -Node: For Statement415140 -Node: Switch Statement418299 -Node: Break Statement420685 -Node: Continue Statement422777 -Node: Next Statement424604 -Node: Nextfile Statement426987 -Node: Exit Statement429639 -Node: Built-in Variables432044 -Node: User-modified433177 -Ref: User-modified-Footnote-1440804 -Node: Auto-set440866 -Ref: Auto-set-Footnote-1453960 -Ref: Auto-set-Footnote-2454166 -Node: ARGC and ARGV454222 -Node: Pattern Action Summary458441 -Node: Arrays460871 -Node: Array Basics462200 -Node: Array Intro463044 -Ref: figure-array-elements465019 -Ref: Array Intro-Footnote-1467723 -Node: Reference to Elements467851 -Node: Assigning Elements470315 -Node: Array Example470806 -Node: Scanning an Array472565 -Node: Controlling Scanning475589 -Ref: Controlling Scanning-Footnote-1480988 -Node: Numeric Array Subscripts481304 -Node: Uninitialized Subscripts483488 -Node: Delete485107 -Ref: Delete-Footnote-1487859 -Node: Multidimensional487916 -Node: Multiscanning491011 -Node: Arrays of Arrays492602 -Node: Arrays Summary497370 -Node: Functions499463 -Node: Built-in500501 -Node: Calling Built-in501579 -Node: Numeric Functions503575 -Ref: Numeric Functions-Footnote-1507603 -Ref: Numeric Functions-Footnote-2507960 -Ref: Numeric Functions-Footnote-3508008 -Node: String Functions508280 -Ref: String Functions-Footnote-1531788 -Ref: String Functions-Footnote-2531917 -Ref: String Functions-Footnote-3532165 -Node: Gory Details532252 -Ref: table-sub-escapes534043 -Ref: table-sub-proposed535562 -Ref: table-posix-sub536925 -Ref: table-gensub-escapes538466 -Ref: Gory Details-Footnote-1539289 -Node: I/O Functions539440 -Ref: I/O Functions-Footnote-1546661 -Node: Time Functions546809 -Ref: Time Functions-Footnote-1557314 -Ref: Time Functions-Footnote-2557382 -Ref: Time Functions-Footnote-3557540 -Ref: Time Functions-Footnote-4557651 -Ref: Time Functions-Footnote-5557763 -Ref: Time Functions-Footnote-6557990 -Node: Bitwise Functions558256 -Ref: table-bitwise-ops558850 -Ref: Bitwise Functions-Footnote-1563188 -Node: Type Functions563361 -Node: I18N Functions564517 -Node: User-defined566168 -Node: Definition Syntax566973 -Ref: Definition Syntax-Footnote-1572660 -Node: Function Example572731 -Ref: Function Example-Footnote-1575653 -Node: Function Caveats575675 -Node: Calling A Function576193 -Node: Variable Scope577151 -Node: Pass By Value/Reference580145 -Node: Return Statement583644 -Node: Dynamic Typing586623 -Node: Indirect Calls587553 -Ref: Indirect Calls-Footnote-1597804 -Node: Functions Summary597932 -Node: Library Functions600637 -Ref: Library Functions-Footnote-1604246 -Ref: Library Functions-Footnote-2604389 -Node: Library Names604560 -Ref: Library Names-Footnote-1608021 -Ref: Library Names-Footnote-2608244 -Node: General Functions608330 -Node: Strtonum Function609433 -Node: Assert Function612455 -Node: Round Function615781 -Node: Cliff Random Function617322 -Node: Ordinal Functions618338 -Ref: Ordinal Functions-Footnote-1621401 -Ref: Ordinal Functions-Footnote-2621653 -Node: Join Function621863 -Ref: Join Function-Footnote-1623633 -Node: Getlocaltime Function623833 -Node: Readfile Function627577 -Node: Shell Quoting629551 -Node: Data File Management630952 -Node: Filetrans Function631584 -Node: Rewind Function635681 -Node: File Checking637067 -Ref: File Checking-Footnote-1638401 -Node: Empty Files638602 -Node: Ignoring Assigns640581 -Node: Getopt Function642131 -Ref: Getopt Function-Footnote-1653601 -Node: Passwd Functions653801 -Ref: Passwd Functions-Footnote-1662642 -Node: Group Functions662730 -Ref: Group Functions-Footnote-1670629 -Node: Walking Arrays670836 -Node: Library Functions Summary673846 -Node: Library Exercises675252 -Node: Sample Programs675717 -Node: Running Examples676487 -Node: Clones677215 -Node: Cut Program678439 -Node: Egrep Program688160 -Ref: Egrep Program-Footnote-1695672 -Node: Id Program695782 -Node: Split Program699462 -Ref: Split Program-Footnote-1702921 -Node: Tee Program703050 -Node: Uniq Program705840 -Node: Wc Program713266 -Ref: Wc Program-Footnote-1717521 -Node: Miscellaneous Programs717615 -Node: Dupword Program718828 -Node: Alarm Program720858 -Node: Translate Program725713 -Ref: Translate Program-Footnote-1730278 -Node: Labels Program730548 -Ref: Labels Program-Footnote-1733899 -Node: Word Sorting733983 -Node: History Sorting738055 -Node: Extract Program739890 -Node: Simple Sed747419 -Node: Igawk Program750493 -Ref: Igawk Program-Footnote-1764824 -Ref: Igawk Program-Footnote-2765026 -Ref: Igawk Program-Footnote-3765148 -Node: Anagram Program765263 -Node: Signature Program768325 -Node: Programs Summary769572 -Node: Programs Exercises770787 -Ref: Programs Exercises-Footnote-1774916 -Node: Advanced Features775007 -Node: Nondecimal Data776997 -Node: Array Sorting778588 -Node: Controlling Array Traversal779288 -Ref: Controlling Array Traversal-Footnote-1787657 -Node: Array Sorting Functions787775 -Ref: Array Sorting Functions-Footnote-1792866 -Node: Two-way I/O793062 -Ref: Two-way I/O-Footnote-1798882 -Ref: Two-way I/O-Footnote-2799069 -Node: TCP/IP Networking799151 -Node: Profiling802269 -Node: Advanced Features Summary809808 -Node: Internationalization811744 -Node: I18N and L10N813224 -Node: Explaining gettext813911 -Ref: Explaining gettext-Footnote-1818934 -Ref: Explaining gettext-Footnote-2819119 -Node: Programmer i18n819284 -Ref: Programmer i18n-Footnote-1824140 -Node: Translator i18n824189 -Node: String Extraction824983 -Ref: String Extraction-Footnote-1826116 -Node: Printf Ordering826202 -Ref: Printf Ordering-Footnote-1828988 -Node: I18N Portability829052 -Ref: I18N Portability-Footnote-1831508 -Node: I18N Example831571 -Ref: I18N Example-Footnote-1834377 -Node: Gawk I18N834450 -Node: I18N Summary835095 -Node: Debugger836436 -Node: Debugging837458 -Node: Debugging Concepts837899 -Node: Debugging Terms839708 -Node: Awk Debugging842283 -Node: Sample Debugging Session843189 -Node: Debugger Invocation843723 -Node: Finding The Bug845109 -Node: List of Debugger Commands851587 -Node: Breakpoint Control852920 -Node: Debugger Execution Control856614 -Node: Viewing And Changing Data859976 -Node: Execution Stack863350 -Node: Debugger Info864987 -Node: Miscellaneous Debugger Commands869058 -Node: Readline Support874146 -Node: Limitations875042 -Node: Debugging Summary877151 -Node: Arbitrary Precision Arithmetic878324 -Node: Computer Arithmetic879740 -Ref: table-numeric-ranges883331 -Ref: Computer Arithmetic-Footnote-1884053 -Node: Math Definitions884110 -Ref: table-ieee-formats887424 -Ref: Math Definitions-Footnote-1888027 -Node: MPFR features888132 -Node: FP Math Caution889851 -Ref: FP Math Caution-Footnote-1890923 -Node: Inexactness of computations891292 -Node: Inexact representation892252 -Node: Comparing FP Values893612 -Node: Errors accumulate894694 -Node: Getting Accuracy896127 -Node: Try To Round898837 -Node: Setting precision899736 -Ref: table-predefined-precision-strings900433 -Node: Setting the rounding mode902263 -Ref: table-gawk-rounding-modes902637 -Ref: Setting the rounding mode-Footnote-1906045 -Node: Arbitrary Precision Integers906224 -Ref: Arbitrary Precision Integers-Footnote-1909208 -Node: POSIX Floating Point Problems909357 -Ref: POSIX Floating Point Problems-Footnote-1913239 -Node: Floating point summary913277 -Node: Dynamic Extensions915467 -Node: Extension Intro917020 -Node: Plugin License918286 -Node: Extension Mechanism Outline919083 -Ref: figure-load-extension919522 -Ref: figure-register-new-function921087 -Ref: figure-call-new-function922179 -Node: Extension API Description924242 -Node: Extension API Functions Introduction925690 -Node: General Data Types930502 -Ref: General Data Types-Footnote-1936457 -Node: Memory Allocation Functions936756 -Ref: Memory Allocation Functions-Footnote-1939601 -Node: Constructor Functions939700 -Node: Registration Functions941445 -Node: Extension Functions942130 -Node: Exit Callback Functions944429 -Node: Extension Version String945679 -Node: Input Parsers946342 -Node: Output Wrappers956227 -Node: Two-way processors960739 -Node: Printing Messages963003 -Ref: Printing Messages-Footnote-1964077 -Node: Updating ERRNO964230 -Node: Requesting Values964969 -Ref: table-value-types-returned965706 -Node: Accessing Parameters966589 -Node: Symbol Table Access967825 -Node: Symbol table by name968337 -Node: Symbol table by cookie970358 -Ref: Symbol table by cookie-Footnote-1974507 -Node: Cached values974571 -Ref: Cached values-Footnote-1978072 -Node: Array Manipulation978163 -Ref: Array Manipulation-Footnote-1979262 -Node: Array Data Types979299 -Ref: Array Data Types-Footnote-1981957 -Node: Array Functions982049 -Node: Flattening Arrays985908 -Node: Creating Arrays992816 -Node: Extension API Variables997588 -Node: Extension Versioning998224 -Node: Extension API Informational Variables1000115 -Node: Extension API Boilerplate1001179 -Node: Finding Extensions1004993 -Node: Extension Example1005553 -Node: Internal File Description1006351 -Node: Internal File Ops1010431 -Ref: Internal File Ops-Footnote-11022193 -Node: Using Internal File Ops1022333 -Ref: Using Internal File Ops-Footnote-11024716 -Node: Extension Samples1024991 -Node: Extension Sample File Functions1026520 -Node: Extension Sample Fnmatch1034169 -Node: Extension Sample Fork1035656 -Node: Extension Sample Inplace1036874 -Node: Extension Sample Ord1040084 -Node: Extension Sample Readdir1040920 -Ref: table-readdir-file-types1041809 -Node: Extension Sample Revout1042614 -Node: Extension Sample Rev2way1043203 -Node: Extension Sample Read write array1043943 -Node: Extension Sample Readfile1045885 -Node: Extension Sample Time1046980 -Node: Extension Sample API Tests1048328 -Node: gawkextlib1048820 -Node: Extension summary1051244 -Node: Extension Exercises1054936 -Node: Language History1056433 -Node: V7/SVR3.11058089 -Node: SVR41060241 -Node: POSIX1061675 -Node: BTL1063055 -Node: POSIX/GNU1063785 -Node: Feature History1069306 -Node: Common Extensions1082635 -Node: Ranges and Locales1083918 -Ref: Ranges and Locales-Footnote-11088534 -Ref: Ranges and Locales-Footnote-21088561 -Ref: Ranges and Locales-Footnote-31088796 -Node: Contributors1089017 -Node: History summary1094586 -Node: Installation1095966 -Node: Gawk Distribution1096911 -Node: Getting1097395 -Node: Extracting1098356 -Node: Distribution contents1099994 -Node: Unix Installation1105747 -Node: Quick Installation1106363 -Node: Additional Configuration Options1108790 -Node: Configuration Philosophy1110594 -Node: Non-Unix Installation1112964 -Node: PC Installation1113422 -Node: PC Binary Installation1114742 -Node: PC Compiling1116594 -Ref: PC Compiling-Footnote-11119618 -Node: PC Testing1119727 -Node: PC Using1120907 -Node: Cygwin1125021 -Node: MSYS1125791 -Node: VMS Installation1126292 -Node: VMS Compilation1127083 -Ref: VMS Compilation-Footnote-11128313 -Node: VMS Dynamic Extensions1128371 -Node: VMS Installation Details1130056 -Node: VMS Running1132309 -Node: VMS GNV1136588 -Node: VMS Old Gawk1137323 -Node: Bugs1137794 -Node: Other Versions1141991 -Node: Installation summary1148577 -Node: Notes1149635 -Node: Compatibility Mode1150500 -Node: Additions1151282 -Node: Accessing The Source1152207 -Node: Adding Code1153643 -Node: New Ports1159862 -Node: Derived Files1164350 -Ref: Derived Files-Footnote-11169835 -Ref: Derived Files-Footnote-21169870 -Ref: Derived Files-Footnote-31170468 -Node: Future Extensions1170582 -Node: Implementation Limitations1171240 -Node: Extension Design1172423 -Node: Old Extension Problems1173577 -Ref: Old Extension Problems-Footnote-11175095 -Node: Extension New Mechanism Goals1175152 -Ref: Extension New Mechanism Goals-Footnote-11178516 -Node: Extension Other Design Decisions1178705 -Node: Extension Future Growth1180818 -Node: Old Extension Mechanism1181654 -Node: Notes summary1183417 -Node: Basic Concepts1184599 -Node: Basic High Level1185280 -Ref: figure-general-flow1185562 -Ref: figure-process-flow1186247 -Ref: Basic High Level-Footnote-11189548 -Node: Basic Data Typing1189733 -Node: Glossary1193061 -Node: Copying1225007 -Node: GNU Free Documentation License1262546 -Node: Index1287664 +Node: Foreword342509 +Node: Foreword446951 +Node: Preface48483 +Ref: Preface-Footnote-151355 +Ref: Preface-Footnote-251462 +Ref: Preface-Footnote-351696 +Node: History51838 +Node: Names54191 +Ref: Names-Footnote-155285 +Node: This Manual55432 +Ref: This Manual-Footnote-161914 +Node: Conventions62014 +Node: Manual History64369 +Ref: Manual History-Footnote-167365 +Ref: Manual History-Footnote-267406 +Node: How To Contribute67480 +Node: Acknowledgments68609 +Node: Getting Started73496 +Node: Running gawk75935 +Node: One-shot77125 +Node: Read Terminal78388 +Node: Long80420 +Node: Executable Scripts81933 +Ref: Executable Scripts-Footnote-184728 +Node: Comments84831 +Node: Quoting87315 +Node: DOS Quoting92833 +Node: Sample Data Files93508 +Node: Very Simple96103 +Node: Two Rules101005 +Node: More Complex102891 +Node: Statements/Lines105754 +Ref: Statements/Lines-Footnote-1110213 +Node: Other Features110478 +Node: When111415 +Ref: When-Footnote-1113169 +Node: Intro Summary113234 +Node: Invoking Gawk114118 +Node: Command Line115632 +Node: Options116430 +Ref: Options-Footnote-1132082 +Ref: Options-Footnote-2132312 +Node: Other Arguments132337 +Node: Naming Standard Input135284 +Node: Environment Variables136377 +Node: AWKPATH Variable136935 +Ref: AWKPATH Variable-Footnote-1140346 +Ref: AWKPATH Variable-Footnote-2140391 +Node: AWKLIBPATH Variable140652 +Node: Other Environment Variables141909 +Node: Exit Status145547 +Node: Include Files146224 +Node: Loading Shared Libraries149819 +Node: Obsolete151247 +Node: Undocumented151939 +Node: Invoking Summary152236 +Node: Regexp153896 +Node: Regexp Usage155415 +Node: Escape Sequences157452 +Node: Regexp Operators163685 +Ref: Regexp Operators-Footnote-1171102 +Ref: Regexp Operators-Footnote-2171249 +Node: Bracket Expressions171347 +Ref: table-char-classes173370 +Node: Leftmost Longest176507 +Node: Computed Regexps177810 +Node: GNU Regexp Operators181237 +Node: Case-sensitivity184916 +Ref: Case-sensitivity-Footnote-1187812 +Ref: Case-sensitivity-Footnote-2188047 +Node: Strong Regexp Constants188155 +Node: Regexp Summary191097 +Node: Reading Files192703 +Node: Records194866 +Node: awk split records195599 +Node: gawk split records200531 +Ref: gawk split records-Footnote-1205075 +Node: Fields205112 +Node: Nonconstant Fields207853 +Ref: Nonconstant Fields-Footnote-1210089 +Node: Changing Fields210293 +Node: Field Separators216223 +Node: Default Field Splitting218921 +Node: Regexp Field Splitting220039 +Node: Single Character Fields223392 +Node: Command Line Field Separator224452 +Node: Full Line Fields227670 +Ref: Full Line Fields-Footnote-1229192 +Ref: Full Line Fields-Footnote-2229238 +Node: Field Splitting Summary229339 +Node: Constant Size231413 +Node: Splitting By Content235992 +Ref: Splitting By Content-Footnote-1239963 +Node: Multiple Line240126 +Ref: Multiple Line-Footnote-1246009 +Node: Getline246188 +Node: Plain Getline248655 +Node: Getline/Variable251294 +Node: Getline/File252443 +Node: Getline/Variable/File253829 +Ref: Getline/Variable/File-Footnote-1255433 +Node: Getline/Pipe255521 +Node: Getline/Variable/Pipe258226 +Node: Getline/Coprocess259359 +Node: Getline/Variable/Coprocess260624 +Node: Getline Notes261364 +Node: Getline Summary264159 +Ref: table-getline-variants264581 +Node: Read Timeout265329 +Ref: Read Timeout-Footnote-1269236 +Node: Retrying Input269294 +Node: Command-line directories270493 +Node: Input Summary271400 +Node: Input Exercises274572 +Node: Printing275300 +Node: Print277135 +Node: Print Examples278592 +Node: Output Separators281372 +Node: OFMT283389 +Node: Printf284745 +Node: Basic Printf285530 +Node: Control Letters287104 +Node: Format Modifiers291092 +Node: Printf Examples297107 +Node: Redirection299593 +Node: Special FD306436 +Ref: Special FD-Footnote-1309604 +Node: Special Files309678 +Node: Other Inherited Files310295 +Node: Special Network311296 +Node: Special Caveats312156 +Node: Close Files And Pipes313105 +Ref: Close Files And Pipes-Footnote-1320292 +Ref: Close Files And Pipes-Footnote-2320440 +Node: Nonfatal320591 +Node: Output Summary322916 +Node: Output Exercises324138 +Node: Expressions324817 +Node: Values326005 +Node: Constants326683 +Node: Scalar Constants327374 +Ref: Scalar Constants-Footnote-1328238 +Node: Nondecimal-numbers328488 +Node: Regexp Constants331502 +Node: Using Constant Regexps332028 +Node: Variables335191 +Node: Using Variables335848 +Node: Assignment Options337759 +Node: Conversion339633 +Node: Strings And Numbers340157 +Ref: Strings And Numbers-Footnote-1343221 +Node: Locale influences conversions343330 +Ref: table-locale-affects346088 +Node: All Operators346706 +Node: Arithmetic Ops347335 +Node: Concatenation349841 +Ref: Concatenation-Footnote-1352688 +Node: Assignment Ops352795 +Ref: table-assign-ops357787 +Node: Increment Ops359100 +Node: Truth Values and Conditions362560 +Node: Truth Values363634 +Node: Typing and Comparison364682 +Node: Variable Typing365502 +Node: Comparison Operators369126 +Ref: table-relational-ops369545 +Node: POSIX String Comparison373040 +Ref: POSIX String Comparison-Footnote-1374114 +Node: Boolean Ops374253 +Ref: Boolean Ops-Footnote-1378735 +Node: Conditional Exp378827 +Node: Function Calls380563 +Node: Precedence384443 +Node: Locales388102 +Node: Expressions Summary389734 +Node: Patterns and Actions392307 +Node: Pattern Overview393427 +Node: Regexp Patterns395104 +Node: Expression Patterns395646 +Node: Ranges399427 +Node: BEGIN/END402535 +Node: Using BEGIN/END403296 +Ref: Using BEGIN/END-Footnote-1406033 +Node: I/O And BEGIN/END406139 +Node: BEGINFILE/ENDFILE408455 +Node: Empty411362 +Node: Using Shell Variables411679 +Node: Action Overview413953 +Node: Statements416278 +Node: If Statement418126 +Node: While Statement419621 +Node: Do Statement421649 +Node: For Statement422797 +Node: Switch Statement425956 +Node: Break Statement428342 +Node: Continue Statement430434 +Node: Next Statement432261 +Node: Nextfile Statement434644 +Node: Exit Statement437296 +Node: Built-in Variables439701 +Node: User-modified440834 +Node: Auto-set448422 +Ref: Auto-set-Footnote-1462815 +Ref: Auto-set-Footnote-2463021 +Node: ARGC and ARGV463077 +Node: Pattern Action Summary467296 +Node: Arrays469726 +Node: Array Basics471055 +Node: Array Intro471899 +Ref: figure-array-elements473874 +Ref: Array Intro-Footnote-1476578 +Node: Reference to Elements476706 +Node: Assigning Elements479170 +Node: Array Example479661 +Node: Scanning an Array481420 +Node: Controlling Scanning484444 +Ref: Controlling Scanning-Footnote-1489843 +Node: Numeric Array Subscripts490159 +Node: Uninitialized Subscripts492343 +Node: Delete493962 +Ref: Delete-Footnote-1496714 +Node: Multidimensional496771 +Node: Multiscanning499866 +Node: Arrays of Arrays501457 +Node: Arrays Summary506225 +Node: Functions508318 +Node: Built-in509356 +Node: Calling Built-in510434 +Node: Numeric Functions512430 +Ref: Numeric Functions-Footnote-1517263 +Ref: Numeric Functions-Footnote-2517620 +Ref: Numeric Functions-Footnote-3517668 +Node: String Functions517940 +Ref: String Functions-Footnote-1541448 +Ref: String Functions-Footnote-2541577 +Ref: String Functions-Footnote-3541825 +Node: Gory Details541912 +Ref: table-sub-escapes543703 +Ref: table-sub-proposed545222 +Ref: table-posix-sub546585 +Ref: table-gensub-escapes548126 +Ref: Gory Details-Footnote-1548949 +Node: I/O Functions549100 +Ref: I/O Functions-Footnote-1556321 +Node: Time Functions556469 +Ref: Time Functions-Footnote-1566974 +Ref: Time Functions-Footnote-2567042 +Ref: Time Functions-Footnote-3567200 +Ref: Time Functions-Footnote-4567311 +Ref: Time Functions-Footnote-5567423 +Ref: Time Functions-Footnote-6567650 +Node: Bitwise Functions567916 +Ref: table-bitwise-ops568510 +Ref: Bitwise Functions-Footnote-1572848 +Node: Type Functions573021 +Node: I18N Functions575682 +Node: User-defined577333 +Node: Definition Syntax578138 +Ref: Definition Syntax-Footnote-1583825 +Node: Function Example583896 +Ref: Function Example-Footnote-1586818 +Node: Function Caveats586840 +Node: Calling A Function587358 +Node: Variable Scope588316 +Node: Pass By Value/Reference591310 +Node: Return Statement594809 +Node: Dynamic Typing597788 +Node: Indirect Calls598718 +Ref: Indirect Calls-Footnote-1608969 +Node: Functions Summary609097 +Node: Library Functions611802 +Ref: Library Functions-Footnote-1615411 +Ref: Library Functions-Footnote-2615554 +Node: Library Names615725 +Ref: Library Names-Footnote-1619186 +Ref: Library Names-Footnote-2619409 +Node: General Functions619495 +Node: Strtonum Function620598 +Node: Assert Function623620 +Node: Round Function626946 +Node: Cliff Random Function628487 +Node: Ordinal Functions629503 +Ref: Ordinal Functions-Footnote-1632566 +Ref: Ordinal Functions-Footnote-2632818 +Node: Join Function633028 +Ref: Join Function-Footnote-1634798 +Node: Getlocaltime Function634998 +Node: Readfile Function638742 +Node: Shell Quoting640716 +Node: Data File Management642117 +Node: Filetrans Function642749 +Node: Rewind Function646846 +Node: File Checking648232 +Ref: File Checking-Footnote-1649566 +Node: Empty Files649767 +Node: Ignoring Assigns651746 +Node: Getopt Function653296 +Ref: Getopt Function-Footnote-1664766 +Node: Passwd Functions664966 +Ref: Passwd Functions-Footnote-1673807 +Node: Group Functions673895 +Ref: Group Functions-Footnote-1681794 +Node: Walking Arrays682001 +Node: Library Functions Summary685011 +Node: Library Exercises686417 +Node: Sample Programs686882 +Node: Running Examples687652 +Node: Clones688380 +Node: Cut Program689604 +Node: Egrep Program699325 +Ref: Egrep Program-Footnote-1706837 +Node: Id Program706947 +Node: Split Program710627 +Ref: Split Program-Footnote-1714086 +Node: Tee Program714215 +Node: Uniq Program717005 +Node: Wc Program724431 +Ref: Wc Program-Footnote-1728686 +Node: Miscellaneous Programs728780 +Node: Dupword Program729993 +Node: Alarm Program732023 +Node: Translate Program736878 +Ref: Translate Program-Footnote-1741443 +Node: Labels Program741713 +Ref: Labels Program-Footnote-1745064 +Node: Word Sorting745148 +Node: History Sorting749220 +Node: Extract Program751055 +Node: Simple Sed758584 +Node: Igawk Program761658 +Ref: Igawk Program-Footnote-1775989 +Ref: Igawk Program-Footnote-2776191 +Ref: Igawk Program-Footnote-3776313 +Node: Anagram Program776428 +Node: Signature Program779490 +Node: Programs Summary780737 +Node: Programs Exercises781952 +Ref: Programs Exercises-Footnote-1786081 +Node: Advanced Features786172 +Node: Nondecimal Data788162 +Node: Array Sorting789753 +Node: Controlling Array Traversal790453 +Ref: Controlling Array Traversal-Footnote-1798822 +Node: Array Sorting Functions798940 +Ref: Array Sorting Functions-Footnote-1804031 +Node: Two-way I/O804227 +Ref: Two-way I/O-Footnote-1810047 +Ref: Two-way I/O-Footnote-2810234 +Node: TCP/IP Networking810316 +Node: Profiling813434 +Node: Advanced Features Summary821705 +Node: Internationalization823549 +Node: I18N and L10N825029 +Node: Explaining gettext825716 +Ref: Explaining gettext-Footnote-1830739 +Ref: Explaining gettext-Footnote-2830924 +Node: Programmer i18n831089 +Ref: Programmer i18n-Footnote-1835945 +Node: Translator i18n835994 +Node: String Extraction836788 +Ref: String Extraction-Footnote-1837921 +Node: Printf Ordering838007 +Ref: Printf Ordering-Footnote-1840793 +Node: I18N Portability840857 +Ref: I18N Portability-Footnote-1843313 +Node: I18N Example843376 +Ref: I18N Example-Footnote-1846182 +Node: Gawk I18N846255 +Node: I18N Summary846900 +Node: Debugger848241 +Node: Debugging849263 +Node: Debugging Concepts849704 +Node: Debugging Terms851513 +Node: Awk Debugging854088 +Node: Sample Debugging Session854994 +Node: Debugger Invocation855528 +Node: Finding The Bug856914 +Node: List of Debugger Commands863392 +Node: Breakpoint Control864725 +Node: Debugger Execution Control868419 +Node: Viewing And Changing Data871781 +Node: Execution Stack875155 +Node: Debugger Info876792 +Node: Miscellaneous Debugger Commands880863 +Node: Readline Support885951 +Node: Limitations886847 +Ref: Limitations-Footnote-1891078 +Node: Debugging Summary891129 +Node: Arbitrary Precision Arithmetic892408 +Node: Computer Arithmetic893824 +Ref: table-numeric-ranges897415 +Ref: Computer Arithmetic-Footnote-1898137 +Node: Math Definitions898194 +Ref: table-ieee-formats901508 +Ref: Math Definitions-Footnote-1902111 +Node: MPFR features902216 +Node: FP Math Caution903935 +Ref: FP Math Caution-Footnote-1905007 +Node: Inexactness of computations905376 +Node: Inexact representation906336 +Node: Comparing FP Values907696 +Node: Errors accumulate908778 +Node: Getting Accuracy910211 +Node: Try To Round912921 +Node: Setting precision913820 +Ref: table-predefined-precision-strings914517 +Node: Setting the rounding mode916347 +Ref: table-gawk-rounding-modes916721 +Ref: Setting the rounding mode-Footnote-1920129 +Node: Arbitrary Precision Integers920308 +Ref: Arbitrary Precision Integers-Footnote-1925225 +Node: POSIX Floating Point Problems925374 +Ref: POSIX Floating Point Problems-Footnote-1929256 +Node: Floating point summary929294 +Node: Dynamic Extensions931484 +Node: Extension Intro933037 +Node: Plugin License934303 +Node: Extension Mechanism Outline935100 +Ref: figure-load-extension935539 +Ref: figure-register-new-function937104 +Ref: figure-call-new-function938196 +Node: Extension API Description940259 +Node: Extension API Functions Introduction941791 +Node: General Data Types946650 +Ref: General Data Types-Footnote-1952605 +Node: Memory Allocation Functions952904 +Ref: Memory Allocation Functions-Footnote-1955749 +Node: Constructor Functions955848 +Node: Registration Functions957593 +Node: Extension Functions958278 +Node: Exit Callback Functions960577 +Node: Extension Version String961827 +Node: Input Parsers962490 +Node: Output Wrappers972375 +Node: Two-way processors976887 +Node: Printing Messages979151 +Ref: Printing Messages-Footnote-1980225 +Node: Updating ERRNO980378 +Node: Requesting Values981117 +Ref: table-value-types-returned981854 +Node: Accessing Parameters982737 +Node: Symbol Table Access983973 +Node: Symbol table by name984485 +Node: Symbol table by cookie986506 +Ref: Symbol table by cookie-Footnote-1990655 +Node: Cached values990719 +Ref: Cached values-Footnote-1994220 +Node: Array Manipulation994311 +Ref: Array Manipulation-Footnote-1995402 +Node: Array Data Types995439 +Ref: Array Data Types-Footnote-1998097 +Node: Array Functions998189 +Node: Flattening Arrays1002048 +Node: Creating Arrays1008956 +Node: Redirection API1013728 +Node: Extension API Variables1016559 +Node: Extension Versioning1017192 +Node: Extension API Informational Variables1019083 +Node: Extension API Boilerplate1020147 +Node: Finding Extensions1023961 +Node: Extension Example1024521 +Node: Internal File Description1025319 +Node: Internal File Ops1029399 +Ref: Internal File Ops-Footnote-11041161 +Node: Using Internal File Ops1041301 +Ref: Using Internal File Ops-Footnote-11043684 +Node: Extension Samples1043959 +Node: Extension Sample File Functions1045488 +Node: Extension Sample Fnmatch1053137 +Node: Extension Sample Fork1054624 +Node: Extension Sample Inplace1055842 +Node: Extension Sample Ord1059052 +Node: Extension Sample Readdir1059888 +Ref: table-readdir-file-types1060777 +Node: Extension Sample Revout1061582 +Node: Extension Sample Rev2way1062171 +Node: Extension Sample Read write array1062911 +Node: Extension Sample Readfile1064853 +Node: Extension Sample Time1065948 +Node: Extension Sample API Tests1067296 +Node: gawkextlib1067788 +Node: Extension summary1070235 +Node: Extension Exercises1073927 +Node: Language History1075424 +Node: V7/SVR3.11077080 +Node: SVR41079232 +Node: POSIX1080666 +Node: BTL1082046 +Node: POSIX/GNU1082776 +Node: Feature History1088615 +Node: Common Extensions1102985 +Node: Ranges and Locales1104268 +Ref: Ranges and Locales-Footnote-11108884 +Ref: Ranges and Locales-Footnote-21108911 +Ref: Ranges and Locales-Footnote-31109146 +Node: Contributors1109367 +Node: History summary1114936 +Node: Installation1116316 +Node: Gawk Distribution1117261 +Node: Getting1117745 +Node: Extracting1118706 +Node: Distribution contents1120344 +Node: Unix Installation1126440 +Node: Quick Installation1127122 +Node: Shell Startup Files1129536 +Node: Additional Configuration Options1130614 +Node: Configuration Philosophy1132419 +Node: Non-Unix Installation1134789 +Node: PC Installation1135247 +Node: PC Binary Installation1136567 +Node: PC Compiling1138419 +Ref: PC Compiling-Footnote-11141443 +Node: PC Testing1141552 +Node: PC Using1142732 +Node: Cygwin1146846 +Node: MSYS1147616 +Node: VMS Installation1148117 +Node: VMS Compilation1148908 +Ref: VMS Compilation-Footnote-11150138 +Node: VMS Dynamic Extensions1150196 +Node: VMS Installation Details1151881 +Node: VMS Running1154134 +Node: VMS GNV1158413 +Node: VMS Old Gawk1159148 +Node: Bugs1159619 +Node: Other Versions1163816 +Node: Installation summary1170402 +Node: Notes1171460 +Node: Compatibility Mode1172325 +Node: Additions1173107 +Node: Accessing The Source1174032 +Node: Adding Code1175468 +Node: New Ports1181687 +Node: Derived Files1186175 +Ref: Derived Files-Footnote-11191660 +Ref: Derived Files-Footnote-21191695 +Ref: Derived Files-Footnote-31192293 +Node: Future Extensions1192407 +Node: Implementation Limitations1193065 +Node: Extension Design1194248 +Node: Old Extension Problems1195402 +Ref: Old Extension Problems-Footnote-11196920 +Node: Extension New Mechanism Goals1196977 +Ref: Extension New Mechanism Goals-Footnote-11200341 +Node: Extension Other Design Decisions1200530 +Node: Extension Future Growth1202643 +Node: Old Extension Mechanism1203479 +Node: Notes summary1205242 +Node: Basic Concepts1206424 +Node: Basic High Level1207105 +Ref: figure-general-flow1207387 +Ref: figure-process-flow1208072 +Ref: Basic High Level-Footnote-11211373 +Node: Basic Data Typing1211558 +Node: Glossary1214886 +Node: Copying1246832 +Node: GNU Free Documentation License1284371 +Node: Index1309489 End Tag Table |