 @@ -1,14 +1,14 @@
-.\"	$NetBSD: awk.1,v 1.18 2009/03/09 14:10:12 joerg Exp $
+.\"	$NetBSD: awk.1,v 1.19 2009/03/15 16:21:46 joerg Exp $
 .\"
 .\" Copyright (C) Lucent Technologies 1997
 .\" All Rights Reserved
 .\"
 .\" Permission to use, copy, modify, and distribute this software and
 .\" its documentation for any purpose and without fee is hereby
 .\" granted, provided that the above copyright notice appear in all
 .\" copies and that both that the copyright notice and this
 .\" permission notice and warranty disclaimer appear in supporting
 .\" documentation, and that the name Lucent Technologies or any of
 .\" its entities not be used in advertising or publicity pertaining
 .\" to distribution of the software without specific, written prior
 .\" permission.
 @@ -119,42 +119,43 @@ An input line is normally made up of fie
 or by regular expression
 .Va FS .
 The fields are denoted
 .Va $1 ,
 .Va $2 ,
 \&..., while
 .Va $0
 refers to the entire line.
 If
 .Va FS
 is null, the input line is split into one field per character.
 .Pp
 A pattern-action statement has the form
-.sp
+.Lp
 .Dl pattern \&{ action \&}
-.sp
+.Lp
 A missing \&{ action \&}
 means print the line;
 a missing pattern always matches.
 Pattern-action statements are separated by newlines or semicolons.
 .Pp
 An action is a sequence of statements.
 Statements are terminated by
 semicolons, newlines or right braces.
 An empty
 .Ar expression-list
 stands for
 .Va $0 .
-String constants are quoted \&\f(CW"\ "\fR,
+String constants are quoted
 .Em \&"\ \&" ,
 with the usual C escapes recognized within.
 Expressions take on string or numeric values as appropriate,
 and are built using the
 .Sx Operators
 (see next subsection).
 Variables may be scalars, array elements
 (denoted
 .Va x[i] )
 or fields.
 Variables are initialized to the null string.
 Array subscripts may be any string,
 not necessarily numeric;
 this allows for a form of associative memory.
 @@ -193,154 +194,127 @@ String concatenation.
 .It Ic != ==
 Regular relational operators
 .It Ic ~ !~
 Regular expression match and not match
 .It Ic in
 Array membership
 .It Ic "\*[Am]\*[Am]"
 Logical AND
 .It Ic "||"
 Logical OR
 .It Ic ?:
 C conditional expression.
 This is used as
-.Ar expr1 Ic ? Ar expr2 Ic : Ar expr3 No .
+.Ar expr1 Ic \&? Ar expr2 Ic \&: Ar expr3 No .
 If
 .Ar expr1
 is true, the result value is
 .Ar expr2 ,
 otherwise it is
 .Ar expr3 .
 Only one of
 .Ar expr2
 and
 .Ar expr3
 is evaluated.
 .It Ic = += -=
 .It Ic *= /= %= ^=
 Assignment and Operator-Assignment
 .El
 .Ss Control Statements
 The control statements are as follows:
 .Pp
 .Bl -hang -offset indent -width indent -compact
-.It Xo
+.It Ic if \&( Ar expression Ic \&) Ar statement Bq Ic else Ar statement
-.Ic if \&( Ar expression Ic \&) Ar statement
+.It Ic while \&( Ar expression Ic \&) Ar statement
-.Bq Ic else Ar statement
+.It Ic for \&( Ar expression Ic \&; Ar expression Ic \&; \
-.Xc
+Ar expression Ic \&) Ar statement
-.It Ic while( Ar expression Ic \&) Ar statement
+.It Ic for \&( Va var Ic in Ar array Ic \&) Ar statement
-.It Xo
+.It Ic do Ar statement Ic while \&( Ar expression Ic \&)
 .Ic for( Ar expression Ic \&; Ar expression Ic \&;
 .Ar expression Ic \&)
 .Ar statement
 .Xc
 .It Xo
 .Ic for( Va var Ic in Ar array
 .Ic \&)
 .Ar statement
 .Xc
 .It Xo
 .Ic do Ar statement
 .Ic while( Ar expression Ic \&)
 .Xc
 .It Ic break
 .It Ic continue
 .It Ic delete Va array Bq Ar expression
 .It Ic delete Va array
 .It Ic exit Bq Ar expression
 .Ar expression
 .It Ic return Bq Ar expression
-.It Ic { Ar [ statement ... ] Ic }
+.It Ic \&{ Ar [ statement ... ] Ic \&}
 .El
 .Ss I/O Statements
 The input/output statements are as follows:
 .Pp
 .Bl -tag -width indent
 .It Fn close expr
 Closes the file or pipe
 .Ar expr .
 Returns zero on success; otherwise nonzero.
 .It Fn fflush expr
 Flushes any buffered output for the file or pipe
 .Ar expr .
 Returns zero on success; otherwise nonzero.
 .It Ic getline Bq Va var
 Set
 .Va var
 (or
 .Va $0 if
 .Va var
 is not specified)
 to the next input record from the current input file.
 .Ic getline
 returns 1 for a successful input,
 for end of file, and \-1 for an error.
-.It Xo
+.It Ic getline Bo Va var Bc Ic \*[Lt] Ar file
 .Ic getline
 .Bq Va var
 .Ic \*[Lt]
 .Ar file
 .Xc
 Set
 .Va var
 (or
 .Va $0 if
 .Va var
 is not specified)
 to the next input record from the specified file
 .Ar file .
 .It Ar expr Ic \&| getline
 Pipes the output of
 .Ar expr
 into
 .Ic getline ;
 each call of
 .Ic getline
 returns the next line of output from
 .Ar expr .
 .It Ic next
 Skip remaining patterns on this input line.
 .It Ic nextfile
 Skip rest of this file, open next, start at top.
-.It Xo
+.It Ic print Bo Ar expr-list Bc Bq Ic \*[Gt] Ar file
 .Ic print
 .Bq Ar expr-list
 .Bq Ic \*[Gt] Ar file
 .Xc
 The
 .Ic print
 statement prints its arguments on the standard output (or to a file
 if
 .Ic \*[Gt] file
 or to a pipe if
 .Ic | Ar expr
 is present),
 separated by the current output field separator
 .Va OFS ,
 and terminated by the
 output record separator
 .Va ORS .
 Both
 .Ar file
 and
 .Ar expr
 may be literal names or parenthesized expressions; identical string values in
 different statements denote the same open file.
-.It Xo
+.It Ic printf Ar format Bo Ic \&, Ar expr-list Bc Bq Ic \*[Gt] Ar file
 .Ic printf
 .Ar format
 .Bq Ic , Ar expr-list
 .Bq Ic \*[Gt] Ar file
 .Xc
 Format and print its expression list according to
 .Ar format .
 See
 .Xr printf 3
 for list of supported formats and their meaning.
 .El
 .Ss Mathematical and Numeric Functions
 AWK has the following mathematical and numerical functions built-in:
 .Pp
 .Bl -tag -width indent
 .It Fn atan2 x y
 Returns the arctangent of
 .Ar x Ic / Ar y
 @@ -691,37 +665,35 @@ Functions may be defined (at the positio
 .Ic function foo(a, b, c) { ...; return x }
 .Ed
 .Pp
 Parameters are passed by value if scalar and by reference if array name;
 functions may be called recursively.
 Parameters are local to the function; all other variables are global.
 Thus local variables may be created by providing excess parameters in
 the function definition.
 .Sh EXAMPLES
 .Bl -tag -width indent -compact
 .It Ic length($0) \*[Gt] 72
 Print lines longer than 72 characters.
 .Pp
-.It Ic { print $2, $1 }
+.It Ic \&{ print $2, $1 \&}
 Print first two fields in opposite order.
 .Pp
 .It Ic BEGIN { FS =  \&",[ \et]*|[ \et]+\&" }
 .It Ic "\ \ \ \ \ \ {" print \&$2, \&$1 }
 Same, with input fields separated by comma and/or blanks and tabs.
 .Pp
 .It Ic "\ \ \ \ {" s += $1 }
-.It Xo
+.It Ic END { print \&"sum is\&", s, \&" average is\ \&",\ s/NR\ }
 .Ic END { print \&"sum is\&", s, \&" average is\ \&",\ s/NR\ }
 .Xc
 Add up first column, print sum and average.
 .Pp
 .It Ic /start/, /stop/
 Print all lines between start/stop pairs.
 .Pp
 .It Ic BEGIN { # Simulate echo(1)
 .It Ic "\ \ \ \ " for (i = 1; i \*[Lt] ARGC;\ i++)\ printf\ \&"%s\ \&",\ ARGV[i]
 .It Ic "\ \ \ \ " printf \&"\en\&"
 .It Ic "\ \ \ \ " exit }
 .El
 .Sh SEE ALSO
 .Xr egrep 1 ,
 .Xr lex 1 ,
 @@ -745,16 +717,16 @@ Edition 1.0, published by the Free Softw
 .Sh HISTORY
 .Nm nawk
 has been the default system
 .Nm
 since
 .Nx 2.0 ,
 replacing the previously used GNU
 .Nm .
 .Sh BUGS
 There are no explicit conversions between numbers and strings.
 To force an expression to be treated as a number add 0 to it;
 to force it to be treated as a string concatenate
 \&"\&" to it.
-.br
+.Pp
 The scope rules for variables in functions are a botch;
 the syntax is worse.