* improvements from openbsd or sh.1tbl

* remove , before or in most cases
* wrapping, whitespace, wording improvement

ksh.1tbl

@@ -1,4 +1,4 @@
-.\" $MirBSD: ksh.1tbl,v 1.28 2004/08/27 14:08:35 tg Stab $
+.\" $MirBSD: ksh.1tbl,v 1.29 2004/08/27 14:21:42 tg Stab $
 .\" $OpenBSD: ksh.1tbl,v 1.72 2004/08/07 16:46:58 millert Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1993
@@ -278,7 +278,7 @@ and lastly,
 is used to create subshells.
 .Pp
 Whitespace and meta-characters can be quoted individually using a backslash
-.Pq Sq \e ,
+.Pq Sq \e
 or in groups using double
 .Pq Sq \&"
 or single
@@ -460,7 +460,7 @@ and
 .Ql ||
 operators, while it need not follow
 .Ql & ,
-.Ql |& ,
+.Ql |&
 or
 .Ql \&; .
 The exit status of a list is that of the last command executed, with the
@@ -847,7 +847,7 @@ If a
 inside a double-quoted string is followed by
 .Ql \e ,
 .Ql $ ,
-.Ql ` ,
+.Ql `
 or
 .Ql \&" ,
 it is replaced by the second character; if it is followed by a newline, both
@@ -1009,7 +1009,7 @@ form, a
 .Ql \e
 followed by any of
 .Ql $ ,
-.Ql ` ,
+.Ql `
 or
 .Ql \e
 is stripped (a
@@ -1057,7 +1057,7 @@ is an arithmetic expression.
 Array indices are currently limited to the range 0 through 1023, inclusive.
 Parameter substitutions take the form
 .Ic $ Ns Ar name ,
-.Ic ${ Ns Ar name Ns Ic \&} ,
+.Ic ${ Ns Ar name Ns Ic \&}
 or
 .Sm off
 .Xo
@@ -1280,11 +1280,11 @@ command below for a list of options).
 .It Ev \&?
 The exit status of the last non-asynchronous command executed.
 If the last command was killed by a signal,
-.Ic \&$?\&
+.Va \&$?\&
 is set to 128 plus the signal number.
 .It Ev 0
 The name the shell was invoked with (i.e.,
-.Li argv[0] ) ,
+.Li argv[0] )
 or the
 .Ar command-name
 if it was invoked with the
@@ -1584,7 +1584,7 @@ is referenced, it is assigned a random number in the range
 Until the variable is written to, the
 .Xr arc4random 3
 function is being used, after a write or if the function is not available,
-.Xr random 3 ,
+.Xr random 3
 or, if that does not exist,
 .Xr rand 3 ,
 is being used.
@@ -1644,7 +1644,7 @@ or
 .Ql - ,
 the value of the
 .Ev HOME ,
-.Ev PWD ,
+.Ev PWD
 or
 .Ev OLDPWD
 parameter is substituted, respectively.
@@ -2215,7 +2215,9 @@ Functions are like
 in that they are executed in the current environment.
 However, unlike
 .Li .-scripts ,
-shell arguments (i.e., positional parameters $1, $2, etc.) are never visible
+shell arguments (i.e., positional parameters
+.Va $1 , $2 ,
+etc.) are never visible
 inside them.
 When the shell is determining the location of a command, functions
 are searched after special built-in commands, before regular and
@@ -2346,6 +2348,13 @@ The following is a list of things that are affected by the state of the
 .Ic posix
 option:
 .Bl -bullet
+Reading of
+.Ev $ENV .
+If not in
+.Ic posix
+mode, the
+.Ev ENV
+parameter is not expanded and included when the shell starts.
 .It
 Occurrences of
 .Ic \e\&"
@@ -2656,7 +2665,7 @@ where
 .Ar value
 is quoted.
 If options were preceded with
-.Ql + ,
+.Ql +
 or a lone
 .Ql +
 is given on the command line, only
@@ -2713,7 +2722,7 @@ Exit the
 inner-most
 .Ic for ,
 .Ic select ,
-.Ic until ,
+.Ic until
 or
 .Ic while
 loop.
@@ -2839,7 +2848,7 @@ Jumps to the beginning of the
 inner-most
 .Ic for ,
 .Ic select ,
-.Ic until ,
+.Ic until
 or
 .Ic while
 loop.
@@ -3015,7 +3024,7 @@ When the end of the options is encountered,
 exits with a non-zero exit status.
 Options end at the first (non-option
 argument) argument that does not start with a
-.Ql - ,
+.Ql -
 or when a
 .Ql --
 argument is encountered.
@@ -3319,7 +3328,7 @@ explicitly tested by a shell construct such as
 .Ic if ,
 .Ic until ,
 .Ic while ,
-.Ic \&&\&& ,
+.Ic \&&\&&
 or
 .Ic \&|\&|
 statements.
@@ -3491,7 +3500,9 @@ with no option name will list all the options and whether each is on or off;
 will print the long names of all options that are currently on.
 .Pp
 Remaining arguments, if any, are positional parameters and are assigned, in
-order, to the positional parameters (i.e., $1, $2, etc.).
+order, to the positional parameters (i.e.
+.Va $1 , $2 ,
+etc.).
 If options end with
 .Ql --
 and there are no remaining arguments, all positional parameters are cleared.
@@ -3797,7 +3808,7 @@ is either a
 string, indicating the signals are to be ignored, a minus sign
 .Pq Sq \&- ,
 indicating that the default action is to be taken for the signals (see
-.Xr signal 3 ) ,
+.Xr signal 3 )
 or a string containing shell commands to be evaluated and executed at the first
 opportunity (i.e., when the current command completes, or before printing the
 next
@@ -4141,7 +4152,7 @@ below for the format of
 .Ic wait
 will return if a signal for which a trap has been set is received, or if a
 .Dv SIGHUP ,
-.Dv SIGINT ,
+.Dv SIGINT
 or
 .Dv SIGQUIT
 signal is received.
@@ -4351,7 +4362,7 @@ In these editing modes, if a line is longer than the screen width (see
 parameter),
 a
 .Ql > ,
-.Ql + ,
+.Ql +
 or
 .Ql <
 character is displayed in the last column indicating that there are more
@@ -4835,11 +4846,11 @@ appended
 if the word contains no file globbing characters) -- the big-word is replaced
 with the resulting words.
 If the current big-word is the first on the line (or
-follows one of the following characters:
+follows one of the characters
 .Ql \&; ,
 .Ql | ,
 .Ql & ,
-.Ql ( ,
+.Ql (
 or
 .Ql \&) )
 and does not contain a slash