===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/awk/awk.1,v
retrieving revision 1.29
retrieving revision 1.30
diff -c -r1.29 -r1.30
*** src/usr.bin/awk/awk.1	2008/06/04 14:04:42	1.29
--- src/usr.bin/awk/awk.1	2008/06/04 17:14:07	1.30
***************
*** 1,4 ****
! .\"	$OpenBSD: awk.1,v 1.29 2008/06/04 14:04:42 pyr Exp $
  .\" EX/EE is a Bd
  .\"
  .\" Copyright (C) Lucent Technologies 1997
--- 1,4 ----
! .\"	$OpenBSD: awk.1,v 1.30 2008/06/04 17:14:07 jmc Exp $
  .\" EX/EE is a Bd
  .\"
  .\" Copyright (C) Lucent Technologies 1997
***************
*** 425,431 ****
  .El
  .Sh FUNCTIONS
  The awk language has a variety of built-in functions:
! arithmetic, string, input/output and general.
  .Ss Arithmetic Functions
  .Bl -tag -width "atan2(y, x)"
  .It Fn atan2 y x
--- 425,442 ----
  .El
  .Sh FUNCTIONS
  The awk language has a variety of built-in functions:
! arithmetic, string, input/output, general, and bit-operation.
! .Pp
! Functions may be defined (at the position of a pattern-action statement)
! thusly:
! .Pp
! .Dl function foo(a, b, c) { ...; return x }
! .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.
  .Ss Arithmetic Functions
  .Bl -tag -width "atan2(y, x)"
  .It Fn atan2 y x
***************
*** 678,709 ****
  .Fa cmd
  and returns its exit status.
  .El
! .Ss Bit-Operation functions
  .Bl -tag -width "lshift(a, b)"
  .It Fn compl x
  Returns the bitwise complement of integer argument x.
  .It Fn and x y
! Performs a bitwise AND on integer arguments x and y
  .It Fn or x y
! Performs a bitwise OR on integer arguments x and y
  .It Fn xor x y
! Performs a bitwise Exclusive-OR on integer arguments x and y
  .It Fn lshift x n
  Returns x shifted by n bits to the left.
  .It Fn rshift x n
  Returns y shifted by n bits to the right.
  .El
- .Pp
- Functions may be defined (at the position of a pattern-action statement)
- thusly:
- .Pp
- .Dl function foo(a, b, c) { ...; return x }
- .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
  Print lines longer than 72 characters:
  .Pp
--- 689,709 ----
  .Fa cmd
  and returns its exit status.
  .El
! .Ss Bit-Operation Functions
  .Bl -tag -width "lshift(a, b)"
  .It Fn compl x
  Returns the bitwise complement of integer argument x.
  .It Fn and x y
! Performs a bitwise AND on integer arguments x and y.
  .It Fn or x y
! Performs a bitwise OR on integer arguments x and y.
  .It Fn xor x y
! Performs a bitwise Exclusive-OR on integer arguments x and y.
  .It Fn lshift x n
  Returns x shifted by n bits to the left.
  .It Fn rshift x n
  Returns y shifted by n bits to the right.
  .El
  .Sh EXAMPLES
  Print lines longer than 72 characters:
  .Pp
***************
*** 770,777 ****
  .Op Fl \&dV
  and
  .Op Fl safe ,
! as well as the command
! .Cm fflush , compl , and , or , xor , lshift , rshift
  are extensions to that specification.
  .Sh HISTORY
  An
--- 770,778 ----
  .Op Fl \&dV
  and
  .Op Fl safe ,
! as well as the commands
! .Cm fflush , compl , and , or ,
! .Cm xor , lshift , rshift ,
  are extensions to that specification.
  .Sh HISTORY
  An