 @@ -1,14 +1,14 @@
-.\"	$NetBSD: sh.1,v 1.194 2018/03/16 11:19:24 kre Exp $
+.\"	$NetBSD: sh.1,v 1.195 2018/03/16 11:53:57 kre Exp $
 .\" Copyright (c) 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
 .\"
 .\" This code is derived from software contributed to Berkeley by
 .\" Kenneth Almquist.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 @@ -276,27 +276,27 @@ built-in (described later).
 Automatically export any variable to which a value is assigned
 while this flag is set.
 .It Fl b Em notify
 Enable asynchronous notification of background job completion.
 (Not implemented.)
 .It Fl C Em noclobber
 Don't overwrite existing files with
 .Dq > .
 .It Fl c
 Read commands from the
 .Ar command_string
 operand instead of, or in addition to, from the standard input.
 Special parameter
-.Dv 0
+.Dv 0	\" $0
 will be set from the
 .Ar command_name
 operand if given, and the positional parameters
 .Li ( 1 , 2 ,
 etc.)
 set from the remaining argument operands, if any.
 .Fl c
 is only available at invocation, it cannot be
 .Ic set ,
 and there is no form using
 .Dq Cm \&+ .
 .It Fl E Em emacs
 Enable the built-in emacs style
 @@ -995,27 +995,27 @@ reached before the delimiter is encounte
 .\"
 .\"
 .Ss Search and Execution
 .\"
 There are three types of commands: shell functions, built-in commands, and
 normal programs \(em and the command is searched for (by name) in that order.
 A command that contains a slash
 .Sq \&/
 in its name is always a normal program.
 They each are executed in a different way.
 .Pp
 When a shell function is executed, all of the shell positional parameters
 (note: excluding
-.Li 0 ,
+.Li 0 ,	\" $0
 which is a special, not positional, parameter, and remains unchanged)
 are set to the arguments of the shell function.
 The variables which are explicitly placed in the environment of
 the command (by placing assignments to them before the function name) are
 made local to the function and are set to the values given,
 and exported for the benefit of programs executed with the function.
 Then the command given in the function definition is executed.
 The positional parameters, and local variables, are restored to
 their original values when the command completes.
 This all occurs within the current shell, and the function
 can alter variables, or other settings, of the shell, but
 not the positional parameters nor their related special parameters.
 .Pp
 @@ -1583,58 +1583,58 @@ The
 .Ic set
 built-in can also be used to set or reset them, and
 .Ic shift
 can be used to manipulate the list.
 .Pp
 To refer to the 10th (and later) positional parameters,
 the form
 .Li \&${ Ns Ar n Ns Li \&}
 must be used.
 Without the braces, a digit following
 .Dq $
 can only refer to one of the first 9 positional parameters,
 or the special parameter
-.Dv 0 .
+.Dv 0 .	\" $0
 The word
 .Dq Li $10
 is treated identically to
 .Dq Li ${1}0 .
 .\"
 .\"
 .Ss Special Parameters
 .\"
 A special parameter is a parameter denoted by one of the following special
 characters.
 The value of the parameter is listed next to its character.
 .Bl -tag -width thinhyphena
 .It Dv *
 Expands to the positional parameters, starting from one.
 When the
 expansion occurs within a double-quoted string it expands to a single
 field with the value of each parameter separated by the first character of
 the
 .Ev IFS
 variable, or by a
 .Aq space
 if
 .Ev IFS
 is unset.
-.It Dv @
+.It Dv @	\" $@
 Expands to the positional parameters, starting from one.
 When the expansion occurs within double quotes, each positional
 parameter expands as a separate argument.
 If there are no positional parameters, the
 expansion of @ generates zero arguments, even when
-.Dv @
+.Dv $@
 is double-quoted.
 What this basically means, for example, is
 if
 .Li $1
 is
 .Dq abc
 and
 .Li $2
 is
 .Dq def\ ghi ,
 then
 .Li \*q$@\*q
 expands to
 @@ -1657,44 +1657,44 @@ Expands to the process ID of the invoked
 A sub-shell retains the same value of
 .Dv $
 as its parent.
 .It Dv \&!
 Expands to the process ID of the most recent background
 command executed from the current shell.
 For a pipeline, the process ID is that of the last command in the pipeline.
 If no background commands have yet been started by the shell, then
 .Dq Dv \&!
 will be unset.
 Once set, the value of
 .Dq Dv \&!
 will be retained until another background command is started.
-.It Dv 0 No (zero)
+.It Dv 0 No (zero)	\" $0
 Expands to the name of the shell or shell script.
 .El
 .\"
 .\"
 .Ss Word Expansions
 .\"
 This section describes the various expansions that are performed on words.
 Not all expansions are performed on every word, as explained later.
 .Pp
 Tilde expansions, parameter expansions, command substitutions, arithmetic
 expansions, and quote removals that occur within a single word expand to a
 single field.
 It is only field splitting or pathname expansion that can
 create multiple fields from a single word.
 The single exception to this
 rule is the expansion of the special parameter
-.Dv @
+.Dv @	\" $@
 within double quotes, as was described above.
 .Pp
 The order of word expansion is:
 .Bl -enum
 .It
 Tilde Expansion, Parameter Expansion, Command Substitution,
 Arithmetic Expansion (these all occur at the same time).
 .It
 Field Splitting is performed on fields
 generated by step (1) unless the
 .Ev IFS
 variable is null.
 .It
 @@ -1755,27 +1755,27 @@ is substituted.
 .Pp
 The parameter name or symbol can be enclosed in braces,
 which are optional in this simple case,
 except for positional parameters with more than one digit or
 when parameter is followed by a character that could be interpreted as
 part of the name.
 If a parameter expansion occurs inside double quotes:
 .Bl -enum
 .It
 pathname expansion is not performed on the results of the expansion;
 .It
 field splitting is not performed on the results of the
 expansion, with the exception of the special rules for
-.Dv @ .
+.Dv @ .	\" $@
 .El
 .Pp
 In addition, a parameter expansion where braces are used,
 can be modified by using one of the following formats.
 If the
 .Sq Ic \&:
 is omitted in the following modifiers, then the test in the expansion
 applies only to unset parameters, not null ones.
 .Bl -tag -width aaparameterwordaaaaa
 .It Li ${ Ns Ar parameter Ns Ic :- Ns Ar word Ns Li }
 .Sy Use Default Values.
 If
 .Ar parameter
 @@ -1829,27 +1829,27 @@ in this expansion.
 .Sy String Length.
 The length in characters of the value of
 .Ar parameter .
 .El
 .Pp
 The following four varieties of parameter expansion provide for substring
 processing.
 In each case, pattern matching notation (see
 .Sx Shell Patterns ) ,
 rather than regular expression notation, is used to evaluate the patterns.
 If parameter is
 .Dv *
 or
-.Dv @ ,
+.Dv @ ,	\" $@
 the result of the expansion is unspecified.
 Enclosing the full parameter expansion string in double quotes does not
 cause the following four varieties of pattern characters to be quoted,
 whereas quoting characters within the braces has this effect.
 .Bl -tag -width aaparameterwordaaaaa
 .It Li ${ Ns Ar parameter Ns Ic % Ns Ar word Ns Li }
 .Sy Remove Smallest Suffix Pattern.
 The
 .Ar word
 is expanded to produce a pattern.
 The parameter expansion then results in
 .Ar parameter ,
 with the
 @@ -2867,35 +2867,35 @@ not to the global variable named
 Another way to view this, is as if the shell just has one flat, global,
 namespace, in which all variables exist.
 The
 .Ic local
 command conceptually copies the variable(s) named to unnamed temporary
 variables, and when the function ends, copies them back again.
 All references to the variables reference the same global variables,
 but while the function is active, after the
 .Ic local
 command has run, the values and attributes of the variables might
 be altered, and later, when the function completes, be restored.
 .Pp
 Note that the positional parameters
-.Li 1 ,
+.Li 1 ,	\" $1
-.Li 2 ,
+.Li 2 ,	\" $2
 \&... (see
 .Sx Positional Parameters ) ,
 and the special parameters
-.Li \&# ,
+.Li \&# ,	\" $#
-.Li \&*
+.Li \&*		\" $*
 and
-.Li \&@
+.Li \&@		\" $@
 (see
 .Sx Special Parameters ) ,
 are always made local in all functions, and are reset inside the
 function to represent the options and arguments passed to the function.
 Note that
 .Li $0
 however retains the value it had outside the function,
 as do all the other special parameters.
 .Pp
 The only special parameter that can optionally be made local is
 .Dq Li \- .
 Making
 .Dq Li \-
 @@ -3162,27 +3162,27 @@ has no parameters, and exits with an exi
 an attempt is made to give it an option.
 .It Ic trap Ar action signal ...
 .It Ic trap \-
 .It Ic trap Op Fl l
 .It Ic trap Oo Fl p Oc Ar signal ...
 .It Ic trap Ar N signal ...
 .Pp
 Cause the shell to parse and execute action when any of the specified
 signals are received.
 The signals are specified by signal number or as the name of the signal.
 If
 .Ar signal
 is
-.Li 0
+.Li 0	\" $0
 or its equivalent,
 .Li EXIT ,
 the action is executed when the shell exits.
 The
 .Ar action
 may be a null (empty) string,
 which causes the specified signals to be ignored.
 With
 .Ar action
 set to
 .Sq Li -
 the specified signals are set to their default actions.
 If the first