mirror of
git://git.code.sf.net/p/cdesktopenv/code
synced 2025-03-09 15:50:02 +00:00
sh.1: add spacing between paragraphs and a missing word (#502)
These are a few minor edits to the man page for readability and consistency: * Add missing "in" to or else a fifo in a temporary directory * Some paragraphs had missing spacing between them * Some lists were missing spacing before the following paragraph * Use bullet points to list the rksh restrictions * Indent the list of characters in the "Quoting" section
This commit is contained in:
parent
dde4451b85
commit
f03e67261d
1 changed files with 61 additions and 24 deletions
|
@ -1025,7 +1025,7 @@ will run process
|
||||||
.I list
|
.I list
|
||||||
asynchronously connected to some file in
|
asynchronously connected to some file in
|
||||||
.B /dev/fd
|
.B /dev/fd
|
||||||
if this directory exists, or else a fifo a temporary directory.
|
if this directory exists, or else a fifo in a temporary directory.
|
||||||
The name of this file will become the argument to the command.
|
The name of this file will become the argument to the command.
|
||||||
If the form with
|
If the form with
|
||||||
.B >
|
.B >
|
||||||
|
@ -1179,7 +1179,6 @@ may be assigned by writing:
|
||||||
\*(CK .\|.\|.
|
\*(CK .\|.\|.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
.PD 0
|
|
||||||
or
|
or
|
||||||
.PP
|
.PP
|
||||||
.RS
|
.RS
|
||||||
|
@ -1187,13 +1186,11 @@ or
|
||||||
\*(OK
|
\*(OK
|
||||||
.IB vname [ subscript ]= value\^
|
.IB vname [ subscript ]= value\^
|
||||||
\*(CK .\|.\|.
|
\*(CK .\|.\|.
|
||||||
.sp .5
|
|
||||||
.RE
|
.RE
|
||||||
|
.PP
|
||||||
Note that no space is allowed before or after the
|
Note that no space is allowed before or after the
|
||||||
.BR = .
|
.BR = .
|
||||||
.sp .5
|
|
||||||
.PP
|
.PP
|
||||||
.PD 0
|
|
||||||
Attributes assigned by the
|
Attributes assigned by the
|
||||||
.I typeset\^
|
.I typeset\^
|
||||||
special built-in command apply to all elements of the array.
|
special built-in command apply to all elements of the array.
|
||||||
|
@ -1209,7 +1206,6 @@ third element of the indexed array, use
|
||||||
.BI ${ vname [ 3 ][ foobar ]}
|
.BI ${ vname [ 3 ][ foobar ]}
|
||||||
.sp .5
|
.sp .5
|
||||||
.PP
|
.PP
|
||||||
.PD 0
|
|
||||||
A
|
A
|
||||||
.I nameref\^
|
.I nameref\^
|
||||||
is a variable that is a reference to another variable.
|
is a variable that is a reference to another variable.
|
||||||
|
@ -1354,7 +1350,6 @@ The number of elements in the array
|
||||||
.I vname\^
|
.I vname\^
|
||||||
is substituted.
|
is substituted.
|
||||||
.TP
|
.TP
|
||||||
.PD 0
|
|
||||||
\f3${@\fP\f2vname\^\fP\f3}\fP
|
\f3${@\fP\f2vname\^\fP\f3}\fP
|
||||||
Expands to the type name (See
|
Expands to the type name (See
|
||||||
.I "Type Variables"\^
|
.I "Type Variables"\^
|
||||||
|
@ -1412,6 +1407,7 @@ inclusive using the same quoting rules as
|
||||||
.PD 0
|
.PD 0
|
||||||
\f3${!\fP\f2prefix\^\fP\f3@}\fP
|
\f3${!\fP\f2prefix\^\fP\f3@}\fP
|
||||||
.TP
|
.TP
|
||||||
|
.PD
|
||||||
\f3${!\fP\f2prefix\^\fP\f3*}\fP
|
\f3${!\fP\f2prefix\^\fP\f3*}\fP
|
||||||
These both expand to the names of the variables whose names begin with
|
These both expand to the names of the variables whose names begin with
|
||||||
.IR prefix .
|
.IR prefix .
|
||||||
|
@ -1476,6 +1472,7 @@ is set or not.
|
||||||
.PD 0
|
.PD 0
|
||||||
\f3${\fP\f2parameter\^\fP\f3:\fP\f2offset\^\fP\f3:\fP\f2length\^\fP\f3}\fP
|
\f3${\fP\f2parameter\^\fP\f3:\fP\f2offset\^\fP\f3:\fP\f2length\^\fP\f3}\fP
|
||||||
.TP
|
.TP
|
||||||
|
.PD
|
||||||
\f3${\fP\f2parameter\^\fP\f3:\fP\f2offset\^\fP\f3}\fP
|
\f3${\fP\f2parameter\^\fP\f3:\fP\f2offset\^\fP\f3}\fP
|
||||||
Expands to the portion of the value of
|
Expands to the portion of the value of
|
||||||
.I parameter\^
|
.I parameter\^
|
||||||
|
@ -1643,6 +1640,7 @@ are automatically set by the shell:
|
||||||
.TP
|
.TP
|
||||||
.B #
|
.B #
|
||||||
The number of positional parameters in decimal.
|
The number of positional parameters in decimal.
|
||||||
|
.PD
|
||||||
.TP
|
.TP
|
||||||
.B \-
|
.B \-
|
||||||
Options supplied to the shell on invocation or by
|
Options supplied to the shell on invocation or by
|
||||||
|
@ -1992,6 +1990,7 @@ are used by the shell:
|
||||||
The search path for the
|
The search path for the
|
||||||
.B cd
|
.B cd
|
||||||
command.
|
command.
|
||||||
|
.PD
|
||||||
.TP
|
.TP
|
||||||
.B
|
.B
|
||||||
.SM EDITOR
|
.SM EDITOR
|
||||||
|
@ -2777,8 +2776,9 @@ Matches exactly one of the given patterns.
|
||||||
.TP
|
.TP
|
||||||
\f3!(\fP\f2pattern-list\^\fP\f3)\fP
|
\f3!(\fP\f2pattern-list\^\fP\f3)\fP
|
||||||
Matches anything except one of the given patterns.
|
Matches anything except one of the given patterns.
|
||||||
.PD
|
|
||||||
.RE
|
.RE
|
||||||
|
.PD
|
||||||
|
.PP
|
||||||
By default, each pattern or subpattern will match the
|
By default, each pattern or subpattern will match the
|
||||||
longest string possible consistent with generating
|
longest string possible consistent with generating
|
||||||
the longest overall match. If more than one match is
|
the longest overall match. If more than one match is
|
||||||
|
@ -2856,6 +2856,7 @@ Causes the ending character to be interpreted as a quote character,
|
||||||
causing all characters other than any escape character to be ignored
|
causing all characters other than any escape character to be ignored
|
||||||
when looking for a match.
|
when looking for a match.
|
||||||
.PD
|
.PD
|
||||||
|
.PP
|
||||||
.RE
|
.RE
|
||||||
Thus,
|
Thus,
|
||||||
\f3%(\^{\^}Q"E\e\^)\fP,
|
\f3%(\^{\^}Q"E\e\^)\fP,
|
||||||
|
@ -2971,6 +2972,7 @@ Right-anchor the pattern. This is the default for
|
||||||
.B K
|
.B K
|
||||||
style patterns.
|
style patterns.
|
||||||
.PD
|
.PD
|
||||||
|
.PP
|
||||||
.RE
|
.RE
|
||||||
If both \f2options\^\fP and \f3:\fP\f2pattern-list\^\fP
|
If both \f2options\^\fP and \f3:\fP\f2pattern-list\^\fP
|
||||||
are specified, then the options apply only to \f2pattern-list\^\fP.
|
are specified, then the options apply only to \f2pattern-list\^\fP.
|
||||||
|
@ -3004,6 +3006,7 @@ A single quoted string preceded by an unquoted
|
||||||
.B $
|
.B $
|
||||||
is processed as an ANSI C string
|
is processed as an ANSI C string
|
||||||
except for the following:
|
except for the following:
|
||||||
|
.RS
|
||||||
.PD 0
|
.PD 0
|
||||||
.TP
|
.TP
|
||||||
.B \e0
|
.B \e0
|
||||||
|
@ -3024,6 +3027,7 @@ Expands to the character control-\f2x\fP.
|
||||||
.TP
|
.TP
|
||||||
.BI \eC[. name .]
|
.BI \eC[. name .]
|
||||||
Expands to the collating element \f2name\fP.
|
Expands to the collating element \f2name\fP.
|
||||||
|
.RE
|
||||||
.PD
|
.PD
|
||||||
.PP
|
.PP
|
||||||
Inside double quote marks
|
Inside double quote marks
|
||||||
|
@ -3265,6 +3269,7 @@ and
|
||||||
.BR ]] .
|
.BR ]] .
|
||||||
Each expression can be constructed from one or more
|
Each expression can be constructed from one or more
|
||||||
of the following unary or binary expressions:
|
of the following unary or binary expressions:
|
||||||
|
.RS
|
||||||
.PD 0
|
.PD 0
|
||||||
.TP
|
.TP
|
||||||
\f2string\fP
|
\f2string\fP
|
||||||
|
@ -3487,8 +3492,11 @@ True, if
|
||||||
comes after
|
comes after
|
||||||
.I string2\^
|
.I string2\^
|
||||||
based on ASCII value of their characters.
|
based on ASCII value of their characters.
|
||||||
|
.RE
|
||||||
|
.PD
|
||||||
.PP
|
.PP
|
||||||
The following obsolete arithmetic comparisons are also permitted:
|
The following obsolete arithmetic comparisons are also permitted:
|
||||||
|
.RS
|
||||||
.PD 0
|
.PD 0
|
||||||
.TP
|
.TP
|
||||||
\f2exp1\fP \f3\-eq\fP \f2exp2\fP
|
\f2exp1\fP \f3\-eq\fP \f2exp2\fP
|
||||||
|
@ -3526,6 +3534,7 @@ True, if
|
||||||
.I exp1\^
|
.I exp1\^
|
||||||
is greater than or equal to
|
is greater than or equal to
|
||||||
.IR exp2 .
|
.IR exp2 .
|
||||||
|
.RE
|
||||||
.PD
|
.PD
|
||||||
.PP
|
.PP
|
||||||
In each of the above expressions, if
|
In each of the above expressions, if
|
||||||
|
@ -3540,7 +3549,8 @@ descriptor number is
|
||||||
.IR n .
|
.IR n .
|
||||||
.PP
|
.PP
|
||||||
A compound expression can be constructed from these primitives by
|
A compound expression can be constructed from these primitives by
|
||||||
using any of the following, listed in decreasing order of precedence.
|
using any of the following, listed in decreasing order of precedence:
|
||||||
|
.RS
|
||||||
.PD 0
|
.PD 0
|
||||||
.TP
|
.TP
|
||||||
\f3(\fP\f2expression\fP\f3)\fP
|
\f3(\fP\f2expression\fP\f3)\fP
|
||||||
|
@ -3568,6 +3578,7 @@ or
|
||||||
.I expression2\^
|
.I expression2\^
|
||||||
is true.
|
is true.
|
||||||
.PD
|
.PD
|
||||||
|
.RE
|
||||||
.SS Input/Output.
|
.SS Input/Output.
|
||||||
Before a command is executed, its input and output
|
Before a command is executed, its input and output
|
||||||
may be redirected using a special notation interpreted by the shell.
|
may be redirected using a special notation interpreted by the shell.
|
||||||
|
@ -3951,6 +3962,7 @@ echo \|a=b \|c
|
||||||
.ft R
|
.ft R
|
||||||
.fi
|
.fi
|
||||||
.RE
|
.RE
|
||||||
|
.PP
|
||||||
This feature is intended for use with scripts written
|
This feature is intended for use with scripts written
|
||||||
for early versions of the shell and its use in new scripts
|
for early versions of the shell and its use in new scripts
|
||||||
is strongly discouraged.
|
is strongly discouraged.
|
||||||
|
@ -4303,6 +4315,7 @@ There are several ways to refer to jobs in the shell.
|
||||||
A job can be referred to by the process ID of any process of the job
|
A job can be referred to by the process ID of any process of the job
|
||||||
or by one of the following:
|
or by one of the following:
|
||||||
.PD 0
|
.PD 0
|
||||||
|
.RS
|
||||||
.TP
|
.TP
|
||||||
.BI % number
|
.BI % number
|
||||||
The job with the given number.
|
The job with the given number.
|
||||||
|
@ -4334,7 +4347,9 @@ Equivalent to
|
||||||
.TP
|
.TP
|
||||||
.BI %\-
|
.BI %\-
|
||||||
Previous job.
|
Previous job.
|
||||||
|
.RE
|
||||||
.PD
|
.PD
|
||||||
|
.PP
|
||||||
In addition, unless noted otherwise, wherever a job can be specified,
|
In addition, unless noted otherwise, wherever a job can be specified,
|
||||||
the name of a background job pool can be used to represent all the
|
the name of a background job pool can be used to represent all the
|
||||||
jobs in that pool.
|
jobs in that pool.
|
||||||
|
@ -5522,6 +5537,7 @@ same time, such as when pressing one of those keys.
|
||||||
.SS "\ \ \ \ \ Input Edit Commands"
|
.SS "\ \ \ \ \ Input Edit Commands"
|
||||||
.RS
|
.RS
|
||||||
By default the editor is in input mode.
|
By default the editor is in input mode.
|
||||||
|
.PP
|
||||||
.PD 0
|
.PD 0
|
||||||
.TP 10
|
.TP 10
|
||||||
.I erase
|
.I erase
|
||||||
|
@ -5577,9 +5593,13 @@ a
|
||||||
.I tab\^
|
.I tab\^
|
||||||
is inserted.
|
is inserted.
|
||||||
.RE
|
.RE
|
||||||
|
.PD
|
||||||
|
.PP
|
||||||
.SS "\ \ \ \ \ Motion Edit Commands"
|
.SS "\ \ \ \ \ Motion Edit Commands"
|
||||||
.RS
|
.RS
|
||||||
These commands will move the cursor.
|
These commands will move the cursor.
|
||||||
|
.PP
|
||||||
|
.PD 0
|
||||||
.TP 10
|
.TP 10
|
||||||
[\f2count\fP]\f3l\fP
|
[\f2count\fP]\f3l\fP
|
||||||
Cursor forward (right) one character.
|
Cursor forward (right) one character.
|
||||||
|
@ -5737,9 +5757,13 @@ If cursor is not on one of the above characters,
|
||||||
the remainder of the line is searched for the first
|
the remainder of the line is searched for the first
|
||||||
occurrence of one of the above characters first.
|
occurrence of one of the above characters first.
|
||||||
.RE
|
.RE
|
||||||
|
.PD
|
||||||
|
.PP
|
||||||
.SS "\ \ \ \ \ Search Edit Commands"
|
.SS "\ \ \ \ \ Search Edit Commands"
|
||||||
.RS
|
.RS
|
||||||
These commands access your command history.
|
These commands access your command history.
|
||||||
|
.PP
|
||||||
|
.PD 0
|
||||||
.TP 10
|
.TP 10
|
||||||
[\f2count\fP]\f3k\fP
|
[\f2count\fP]\f3k\fP
|
||||||
Fetch previous command.
|
Fetch previous command.
|
||||||
|
@ -5814,9 +5838,13 @@ or
|
||||||
.BR ? ,
|
.BR ? ,
|
||||||
but in reverse direction.
|
but in reverse direction.
|
||||||
.RE
|
.RE
|
||||||
|
.PD
|
||||||
|
.PP
|
||||||
.SS "\ \ \ \ \ Text Modification Edit Commands"
|
.SS "\ \ \ \ \ Text Modification Edit Commands"
|
||||||
.RS
|
.RS
|
||||||
These commands will modify the line.
|
These commands will modify the line.
|
||||||
|
.PP
|
||||||
|
.PD 0
|
||||||
.TP 10
|
.TP 10
|
||||||
.B a
|
.B a
|
||||||
Enter input mode and enter text after the current character.
|
Enter input mode and enter text after the current character.
|
||||||
|
@ -5928,9 +5956,13 @@ by the matching pattern and input mode is entered.
|
||||||
.B \e
|
.B \e
|
||||||
Command or file name completion as described above.
|
Command or file name completion as described above.
|
||||||
.RE
|
.RE
|
||||||
|
.PD
|
||||||
|
.PP
|
||||||
.SS "\ \ \ \ \ Other Edit Commands"
|
.SS "\ \ \ \ \ Other Edit Commands"
|
||||||
.RS
|
.RS
|
||||||
Miscellaneous commands.
|
Miscellaneous commands.
|
||||||
|
.PP
|
||||||
|
.PD 0
|
||||||
.TP 10
|
.TP 10
|
||||||
[\f2count\fP]\f3y\fP\f2motion\fP
|
[\f2count\fP]\f3y\fP\f2motion\fP
|
||||||
.TP 10
|
.TP 10
|
||||||
|
@ -6056,6 +6088,7 @@ Commands that are preceded by a \(dg symbol below are
|
||||||
.I special\ built-in\ commands
|
.I special\ built-in\ commands
|
||||||
and are treated specially in the following ways:
|
and are treated specially in the following ways:
|
||||||
.PD 0
|
.PD 0
|
||||||
|
.RS
|
||||||
.TP
|
.TP
|
||||||
1.
|
1.
|
||||||
Variable assignment lists preceding the command
|
Variable assignment lists preceding the command
|
||||||
|
@ -6071,6 +6104,8 @@ that contains them to abort.
|
||||||
.TP
|
.TP
|
||||||
4.
|
4.
|
||||||
They are not valid function names.
|
They are not valid function names.
|
||||||
|
.RE
|
||||||
|
.PD
|
||||||
.PP
|
.PP
|
||||||
Commands that are preceded by a \(dd symbol below are
|
Commands that are preceded by a \(dd symbol below are
|
||||||
.IR declaration\ commands .
|
.IR declaration\ commands .
|
||||||
|
@ -7265,6 +7300,7 @@ or
|
||||||
formats, separates groups of digits with the grouping delimiter
|
formats, separates groups of digits with the grouping delimiter
|
||||||
.RB ( ,
|
.RB ( ,
|
||||||
on groups of 3 in the C locale).
|
on groups of 3 in the C locale).
|
||||||
|
.PD
|
||||||
.PP
|
.PP
|
||||||
The \f3\-v\fP option assigns the output directly to a variable instead of
|
The \f3\-v\fP option assigns the output directly to a variable instead of
|
||||||
writing it to standard output. This is faster than capturing the output using a
|
writing it to standard output. This is faster than capturing the output using a
|
||||||
|
@ -7935,6 +7971,7 @@ line delimiters, and may be helpful for certain terminals.
|
||||||
.B xtrace
|
.B xtrace
|
||||||
Same as
|
Same as
|
||||||
.BR \-x .
|
.BR \-x .
|
||||||
|
.PD
|
||||||
.PP
|
.PP
|
||||||
If no option name is supplied, then the current option settings are printed.
|
If no option name is supplied, then the current option settings are printed.
|
||||||
.RE
|
.RE
|
||||||
|
@ -7952,6 +7989,7 @@ This mode is on whenever the effective UID (GID)
|
||||||
is not equal to the real UID (GID).
|
is not equal to the real UID (GID).
|
||||||
Turning this off causes the effective UID and GID to be
|
Turning this off causes the effective UID and GID to be
|
||||||
set to the real UID and GID.
|
set to the real UID and GID.
|
||||||
|
.PD 0
|
||||||
.TP 8
|
.TP 8
|
||||||
.B \-r
|
.B \-r
|
||||||
Enables the restricted shell. This option cannot be unset
|
Enables the restricted shell. This option cannot be unset
|
||||||
|
@ -9117,36 +9155,35 @@ are identical to those of
|
||||||
.if \nZ=2 .BR ksh93\^ ,
|
.if \nZ=2 .BR ksh93\^ ,
|
||||||
except that the following are disallowed:
|
except that the following are disallowed:
|
||||||
.RS
|
.RS
|
||||||
.PD 0
|
.IP \[bu]
|
||||||
.PP
|
unsetting the restricted option
|
||||||
unsetting the restricted option,
|
.IP \[bu]
|
||||||
.br
|
|
||||||
changing directory (see
|
changing directory (see
|
||||||
.IR cd (1)),
|
.IR cd (1))
|
||||||
.br
|
.IP \[bu]
|
||||||
setting or unsetting the value or attributes of
|
setting or unsetting the value or attributes of
|
||||||
.BR SHELL ,
|
.BR SHELL ,
|
||||||
.BR ENV ,
|
.BR ENV ,
|
||||||
.BR FPATH ,
|
.BR FPATH ,
|
||||||
or
|
or
|
||||||
.BR PATH\*S,
|
.BR PATH\*S
|
||||||
.br
|
.IP \[bu]
|
||||||
specifying path or
|
specifying path or
|
||||||
command names containing
|
command names containing
|
||||||
.BR / ,
|
.BR /
|
||||||
.br
|
.IP \[bu]
|
||||||
redirecting output
|
redirecting output
|
||||||
.RB ( > ,
|
.RB ( > ,
|
||||||
.BR >| ,
|
.BR >| ,
|
||||||
.BR <> ,
|
.BR <> ,
|
||||||
and
|
and
|
||||||
.BR >> ) ,
|
.BR >> )
|
||||||
.br
|
.IP \[bu]
|
||||||
adding or deleting built-in commands,
|
adding or deleting built-in commands
|
||||||
.br
|
.IP \[bu]
|
||||||
using
|
using
|
||||||
.B "command -p"
|
.B "command -p"
|
||||||
to invoke a command.
|
to invoke a command
|
||||||
.PD
|
.PD
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue