JehanneOS/mksh
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

remove all mentions of “the null string”, it’s an empty string (in most

Browse Source 
cases), or an unset parameter (in some cases)
This commit is contained in:
tg 2016-08-24 19:35:26 +00:00
parent 879c6a0911
commit 91b5d4b3ad
1 changed files with 20 additions and 40 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

60
mksh.1
View File

@ -1,4 +1,4 @@
.\" $MirOS: src/bin/mksh/mksh.1,v 1.413 2016/08/10 18:20:05 tg Exp $ .\" $MirOS: src/bin/mksh/mksh.1,v 1.414 2016/08/24 19:35:26 tg Exp $
.\" $OpenBSD: ksh.1,v 1.160 2015/07/04 13:27:04 feinerer Exp $ .\" $OpenBSD: ksh.1,v 1.160 2015/07/04 13:27:04 feinerer Exp $
.\"- .\"-
.\" Copyright © 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, .\" Copyright © 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
@ -76,7 +76,7 @@
.\" with -mandoc, it might implement .Mx itself, but we want to .\" with -mandoc, it might implement .Mx itself, but we want to
.\" use our own definition. And .Dd must come *first*, always. .\" use our own definition. And .Dd must come *first*, always.
.\" .\"
.Dd $Mdocdate: August 10 2016 $ .Dd $Mdocdate: August 24 2016 $
.\" .\"
.\" Check which macro package we use, and do other -mdoc setup. .\" Check which macro package we use, and do other -mdoc setup.
.\" .\"
@ -829,9 +829,7 @@ When
.Ar list .Ar list
completes, the enumerated list is printed if completes, the enumerated list is printed if
.Ev REPLY .Ev REPLY
is is empty, the prompt is printed, and so on.
.Dv NULL ,
the prompt is printed, and so on.
This process continues until an end-of-file This process continues until an end-of-file
is read, an interrupt is received, or a is read, an interrupt is received, or a
.Ic break .Ic break
@ -1389,14 +1387,10 @@ and
works equivalent to $* and $@ for positional parameters. works equivalent to $* and $@ for positional parameters.
If substitution is performed on a parameter If substitution is performed on a parameter
(or an array parameter element) (or an array parameter element)
that is not set, a null string is substituted unless the that is not set, an empty string is substituted unless the
.Ic nounset .Ic nounset
option option
.Po .Pq Ic set Fl u
.Ic set Fl o Ic nounset
or
.Ic set Fl u
.Pc
is set, in which case an error occurs. is set, in which case an error occurs.
.Pp .Pp
Parameters can be assigned values in a number of ways. Parameters can be assigned values in a number of ways.
@ -1476,8 +1470,7 @@ form of parameter substitution:
.Sm on .Sm on
If If
.Ar name .Ar name
is set and not is set and not empty,
.Dv NULL ,
it is substituted; otherwise, it is substituted; otherwise,
.Ar word .Ar word
is substituted. is substituted.
@ -1486,8 +1479,7 @@ is substituted.
.Sm on .Sm on
If If
.Ar name .Ar name
is set and not is set and not empty,
.Dv NULL ,
.Ar word .Ar word
is substituted; otherwise, nothing is substituted. is substituted; otherwise, nothing is substituted.
.Sm off .Sm off
@ -1495,8 +1487,7 @@ is substituted; otherwise, nothing is substituted.
.Sm on .Sm on
If If
.Ar name .Ar name
is set and not is set and not empty,
.Dv NULL ,
it is substituted; otherwise, it is assigned it is substituted; otherwise, it is assigned
.Ar word .Ar word
and the resulting value of and the resulting value of
@ -1507,8 +1498,7 @@ is substituted.
.Sm on .Sm on
If If
.Ar name .Ar name
is set and not is set and not empty,
.Dv NULL ,
it is substituted; otherwise, it is substituted; otherwise,
.Ar word .Ar word
is printed on standard error (preceded by is printed on standard error (preceded by
@ -1524,7 +1514,7 @@ is omitted, the string
is used instead. is used instead.
Currently a bug, if Currently a bug, if
.Ar word .Ar word
is a variable which expands to the null string, the is a variable which expands to the empty string, the
error message is also printed. error message is also printed.
.El .El
.Pp .Pp
@ -1541,8 +1531,7 @@ In the above modifiers, the
.Ql \&: .Ql \&:
can be omitted, in which case the conditions only depend on can be omitted, in which case the conditions only depend on
.Ar name .Ar name
being set (as opposed to set and not being set (as opposed to set and not empty).
.Dv NULL ) .
If If
.Ar word .Ar word
is needed, parameter, command, arithmetic, and tilde substitution are performed is needed, parameter, command, arithmetic, and tilde substitution are performed
@ -1815,18 +1804,16 @@ by the first character of the
.Ev IFS .Ev IFS
parameter (or the empty string if parameter (or the empty string if
.Ev IFS .Ev IFS
is is unset.
.Dv NULL ) .
.It Ev @ .It Ev @
Same as Same as
.Ic $* , .Ic $* ,
unless it is used inside double quotes, in which case a separate word is unless it is used inside double quotes, in which case a separate word is
generated for each positional parameter. generated for each positional parameter.
If there are no positional parameters, no word is generated. If there are no positional parameters, no word is generated.
.Ic $@ .Ic \&"$@"
can be used to access arguments, verbatim, without losing can be used to access arguments, verbatim, without losing
.Dv NULL empty arguments or splitting arguments with spaces (IFS, actually).
arguments or splitting arguments with spaces.
.El .El
.Pp .Pp
The following parameters are set and/or used by the shell: The following parameters are set and/or used by the shell:
@ -2170,9 +2157,7 @@ You may want to set it to
instead, to include timestamps. instead, to include timestamps.
.It Ev PWD .It Ev PWD
The current working directory. The current working directory.
May be unset or May be unset or empty if the shell doesn't know where it is.
.Dv NULL
if the shell doesn't know where it is.
.It Ev RANDOM .It Ev RANDOM
Each time Each time
.Ev RANDOM .Ev RANDOM
@ -2434,7 +2419,7 @@ the shell.
Three exceptions to this are commands in pipelines, for which Three exceptions to this are commands in pipelines, for which
standard input and/or standard output are those set up by the pipeline, standard input and/or standard output are those set up by the pipeline,
asynchronous commands created when job control is disabled, for which standard asynchronous commands created when job control is disabled, for which standard
input is initially set to be from input is initially set to
.Pa /dev/null , .Pa /dev/null ,
and commands for which any of the following redirections have been specified: and commands for which any of the following redirections have been specified:
.Bl -tag -width XXxxmarker .Bl -tag -width XXxxmarker
@ -3277,16 +3262,13 @@ If the parameter
.Ev CDPATH .Ev CDPATH
is set, it lists the search path for the directory containing is set, it lists the search path for the directory containing
.Ar dir . .Ar dir .
A An unset or empty path means the current directory.
.Dv NULL
path means the current directory.
If If
.Ar dir .Ar dir
is found in any component of the is found in any component of the
.Ev CDPATH .Ev CDPATH
search path other than the search path other than an unset or empty path,
.Dv NULL the name of the new working directory will be written to standard output.
path, the name of the new working directory will be written to standard output.
If If
.Ar dir .Ar dir
is missing, the home directory is missing, the home directory
@ -4668,9 +4650,7 @@ A common mistake is to use
.Dq if \&[ $foo = bar \&] .Dq if \&[ $foo = bar \&]
which fails if parameter which fails if parameter
.Dq foo .Dq foo
is is empty or unset, if it has embedded spaces (i.e.\&
.Dv NULL
or unset, if it has embedded spaces (i.e.\&
.Ev IFS .Ev IFS
octets), or if it is a unary operator like octets), or if it is a unary operator like
.Sq \&! .Sq \&!