diff options
Diffstat (limited to 'gnu/usr.bin/awk/awk.1')
| -rw-r--r-- | gnu/usr.bin/awk/awk.1 | 104 |
1 files changed, 52 insertions, 52 deletions
diff --git a/gnu/usr.bin/awk/awk.1 b/gnu/usr.bin/awk/awk.1 index a98c99d..1b58bec 100644 --- a/gnu/usr.bin/awk/awk.1 +++ b/gnu/usr.bin/awk/awk.1 @@ -1,11 +1,11 @@ .ds PX \s-1POSIX\s+1 .ds UX \s-1UNIX\s+1 .ds AN \s-1ANSI\s+1 -.TH GAWK 1 "Apr 18 1994" "Free Software Foundation" "Utility Commands" +.TH AWK 1 "Apr 18 1994" "Free Software Foundation" "Utility Commands" .SH NAME -gawk \- pattern scanning and processing language +awk \- GNU awk pattern scanning and processing language .SH SYNOPSIS -.B gawk +.B awk [ POSIX or GNU style options ] .B \-f .I program-file @@ -13,7 +13,7 @@ gawk \- pattern scanning and processing language .B \-\^\- ] file .\^.\^. .br -.B gawk +.B awk [ POSIX or GNU style options ] [ .B \-\^\- @@ -35,7 +35,7 @@ of \*(UX also provides some GNU-specific extensions. .PP The command line consists of options to -.I gawk +.I awk itself, the AWK program text (if not supplied via the .B \-f or @@ -57,7 +57,7 @@ for \*(PX mandated features. Other implementations of the AWK language are likely to only accept the traditional one letter options. .PP Following the \*(PX standard, -.IR gawk -specific +.IR awk -specific options are supplied via arguments to the .B \-W option. Multiple @@ -135,9 +135,9 @@ flag sets the maximum record size. These two flags and the option are from the AT&T Bell Labs research version of \*(UX .IR awk . They are ignored by -.IR gawk , +.IR awk , since -.I gawk +.I awk has no pre-defined limits. .TP \w'\fB\-\^\-copyright\fR'u+1n .PD 0 @@ -148,7 +148,7 @@ has no pre-defined limits. Run in .I compatibility mode. In compatibility mode, -.I gawk +.I awk behaves identically to \*(UX .IR awk ; none of the GNU-specific extensions are recognized. @@ -268,10 +268,10 @@ will be recognized in the same argument. .PD .B \-\^\-version Print version information for this particular copy of -.I gawk +.I awk on the error output. This is useful mainly for knowing if the current copy of -.I gawk +.I awk on your system is up to date with respect to whatever the Free Software Foundation is distributing. @@ -341,10 +341,10 @@ all variable assignments specified via the .B \-v option are performed. Next, -.I gawk +.I awk compiles the program into an internal form. Then, -.I gawk +.I awk executes the code in the .B BEGIN block(s) (if any), @@ -353,7 +353,7 @@ each file named in the .B ARGV array. If there are no files named on the command line, -.I gawk +.I awk reads the standard input. .PP If a filename on the command line has the form @@ -374,11 +374,11 @@ a single data file. If the value of a particular element of .B ARGV is empty (\fB""\fR), -.I gawk +.I awk skips over it. .PP For each line in the input, -.I gawk +.I awk tests to see if it matches any .I pattern in the AWK program. @@ -388,7 +388,7 @@ is executed. The patterns are tested in the order they occur in the program. .PP Finally, after all the input is exhausted, -.I gawk +.I awk executes the code in the .B END block(s) (if any). @@ -403,7 +403,7 @@ runs; these will be described as needed and summarized below. .SS Fields .PP As each input line is read, -.I gawk +.I awk splits the line into .IR fields , using the value of the @@ -429,7 +429,7 @@ If the .B FIELDWIDTHS variable is set to a space separated list of numbers, each field is expected to have fixed width, and -.I gawk +.I awk will split up the record using the specified widths. The value of .B FS is ignored. @@ -480,7 +480,7 @@ AWK's built-in variables are: .TP \w'\fBFIELDWIDTHS\fR'u+1n .B ARGC The number of command line arguments (does not include options to -.IR gawk , +.IR awk , or the program source). .TP .B ARGIND @@ -506,12 +506,12 @@ The array is indexed by the environment variables, each element being the value of that variable (e.g., \fBENVIRON["HOME"]\fP might be .BR /u/arnold ). Changing this array does not affect the environment seen by programs which -.I gawk +.I awk spawns via redirection or the .B system() function. (This may change in a future version of -.IR gawk .) +.IR awk .) .\" but don't hold your breath... .TP .B ERRNO @@ -528,14 +528,14 @@ a string describing the error. .TP .B FIELDWIDTHS A white-space separated list of fieldwidths. When set, -.I gawk +.I awk parses the input into fields of fixed width, instead of using the value of the .B FS variable as the field separator. The fixed field width facility is still experimental; expect the semantics to change as -.I gawk +.I awk evolves over time. .TP .B FILENAME @@ -605,7 +605,7 @@ The input record separator, by default a newline. is exceptional in that only the first character of its string value is used for separating records. (This will probably change in a future release of -.IR gawk .) +.IR awk .) If .B RS is set to the null string, then records are separated by @@ -739,7 +739,7 @@ Two strings are compared, of course, as strings. According to the \*(PX standard, even if two strings are numeric strings, a numeric comparison is performed. However, this is clearly incorrect, and -.I gawk +.I awk does not do this. .PP Uninitialized variables have the numeric value 0 and the string value "" @@ -1246,13 +1246,13 @@ into a file, or via .B getline from a file, -.I gawk +.I awk recognizes certain special filenames internally. These filenames allow access to open file descriptors inherited from -.IR gawk 's +.IR awk 's parent process (usually the shell). Other special filenames provide access information about the running -.B gawk +.B awk process. The filenames are: .TP \w'\fB/dev/stdout\fR'u+1n @@ -1468,7 +1468,7 @@ Non-alphabetic characters are left unchanged. .PP Since one of the primary uses of AWK programs is processing log files that contain time stamp information, -.I gawk +.I awk provides the following two functions for obtaining time stamps and formatting them. .PP @@ -1496,11 +1496,11 @@ guaranteed to be available. A public-domain version of .IR strftime (3) and a man page for it are shipped with -.IR gawk ; +.IR awk ; if that version was used to build -.IR gawk , +.IR awk , then all of the conversions described in that man page are available to -.IR gawk. +.IR awk. .SS String Constants .PP String constants in AWK are sequences of characters enclosed @@ -1643,12 +1643,12 @@ Addison-Wesley, 1988. ISBN 0-201-07981-X. Edition 0.15, published by the Free Software Foundation, 1993. .SH POSIX COMPATIBILITY A primary goal for -.I gawk +.I awk is compatibility with the \*(PX standard, as well as with the latest version of \*(UX .IR awk . To this end, -.I gawk +.I awk incorporates the following user visible features which are not described in the AWK book, but are part of @@ -1679,7 +1679,7 @@ The option for implementation specific features is from the \*(PX standard. .PP When processing arguments, -.I gawk +.I awk uses the special option ``\fB\-\^\-\fP'' to signal the end of arguments. In compatibility mode, it will warn about, but otherwise ignore, @@ -1696,7 +1696,7 @@ has it return the seed it was using, to allow keeping track of random number sequences. Therefore .B srand() in -.I gawk +.I awk also returns its current seed. .PP Other new features are: @@ -1711,7 +1711,7 @@ array; the and .BR \ev escape sequences (done originally in -.I gawk +.I awk and fed back into AT&T's); the .B tolower() and @@ -1726,13 +1726,13 @@ has some extensions to \*(PX They are described in this section. All the extensions described here can be disabled by invoking -.I gawk +.I awk with the .B "\-W compat" option. .PP The following features of -.I gawk +.I awk are not available in \*(PX .IR awk . @@ -1800,7 +1800,7 @@ or when closing a file or pipe, respectively. .PP When -.I gawk +.I awk is invoked with the .B "\-W compat" option, @@ -1818,7 +1818,7 @@ has been specified. .ig .PP If -.I gawk +.I awk was compiled for debugging, it will accept the following additional options: .TP @@ -1833,13 +1833,13 @@ or .IR bison (1) debugging output during program parsing. This option should only be of interest to the -.I gawk +.I awk maintainers, and may not even be compiled into -.IR gawk . +.IR awk . .. .SH HISTORICAL FEATURES There are two features of historical AWK implementations that -.I gawk +.I awk supports. First, it is possible to call the .B length() @@ -1863,7 +1863,7 @@ a = length($0) .RE .PP This feature is marked as ``deprecated'' in the \*(PX standard, and -.I gawk +.I awk will issue a warning about its use if .B "\-W lint" is specified on the command line. @@ -1887,14 +1887,14 @@ has not been specified. If .B POSIXLY_CORRECT exists in the environment, then -.I gawk +.I awk behaves exactly as if .B \-\-posix had been specified on the command line. If .B \-\-lint has been specified, -.I gawk +.I awk will issue a warning message to this effect. .SH BUGS The @@ -1910,9 +1910,9 @@ and the associated and .B /dev/stderr files, you may get different output from -.I gawk +.I awk than you would get on a system without those files. When -.I gawk +.I awk interprets these files internally, it synchronizes output to the standard output with output to .BR /dev/stdout , @@ -1921,11 +1921,11 @@ open files. Caveat Emptor. .SH VERSION INFORMATION This man page documents -.IR gawk , +.IR awk , version 2.15. .PP Starting with the 2.15 version of -.IR gawk , +.IR awk , the .BR \-c , .BR \-V , |
