now that we're definitively at 40 pages for the PDF manual, revert some of

the changes in r1.81, and improve wording further
This commit is contained in:
tg 2007-06-23 19:07:14 +00:00
parent 0cd850b207
commit 7796820c82
1 changed files with 32 additions and 17 deletions

49
mksh.1
View File

@ -1,7 +1,7 @@
.\" $MirOS: src/bin/mksh/mksh.1,v 1.88 2007/06/22 23:34:41 tg Exp $ .\" $MirOS: src/bin/mksh/mksh.1,v 1.89 2007/06/23 19:07:14 tg Exp $
.\" $OpenBSD: ksh.1,v 1.120 2007/05/31 20:47:44 otto Exp $ .\" $OpenBSD: ksh.1,v 1.120 2007/05/31 20:47:44 otto Exp $
.\" .\"
.Dd June 22, 2007 .Dd June 23, 2007
.Dt MKSH 1 .Dt MKSH 1
.Os MirBSD .Os MirBSD
.Sh NAME .Sh NAME
@ -173,11 +173,14 @@ substitution and the resulting file
(if any) is read and executed. (if any) is read and executed.
If the If the
.Ev ENV .Ev ENV
variable is unset or empty, but not set to a non-existing filename, the file variable is unset or empty, the file
.Pa $HOME/.mkshrc .Pa $HOME/.mkshrc
is read and processed like above instead, leaving is read and processed like above instead, leaving
.Ev ENV .Ev ENV
unchanged. unchanged.
This processing does not occur if
.Ev ENV
is set to a non-existing filename.
.Pp .Pp
The exit status of the shell is 127 if the command file specified on the The exit status of the shell is 127 if the command file specified on the
command line could not be opened, or non-zero if a fatal syntax error command line could not be opened, or non-zero if a fatal syntax error
@ -734,9 +737,10 @@ succeeds).
.It .It
The single argument form of The single argument form of
.Ic test , .Ic test ,
.No \&[ Ar str No \&] , which tests if the argument has a non-zero length, is not valid; explicit
which tests if the argument has a non-zero length, is not valid; operators must always be used e.g. instead of
use explicit operators instead, i.e.\& .No \&[ Ar str No \&]
use
.No \&[[ -n Ar str No \&]] . .No \&[[ -n Ar str No \&]] .
.It .It
Parameter, command, and arithmetic substitutions are performed as expressions Parameter, command, and arithmetic substitutions are performed as expressions
@ -995,6 +999,7 @@ but it is carried out more efficiently because no process is started.
.Pf $( Ns Ar command Ns \&) .Pf $( Ns Ar command Ns \&)
expressions are currently parsed by finding matching parentheses, expressions are currently parsed by finding matching parentheses,
regardless of quoting. regardless of quoting.
This should be fixed soon.
.Pp .Pp
Arithmetic substitutions are replaced by the value of the specified expression. Arithmetic substitutions are replaced by the value of the specified expression.
For example, the command For example, the command
@ -3927,7 +3932,7 @@ If any of the
or or
.Fl Z .Fl Z
options are changed, all others from this set are cleared, options are changed, all others from this set are cleared,
unless listed in the same command. unless they are also given on the same command line.
.Pp .Pp
.It Xo .It Xo
.Ic ulimit .Ic ulimit
@ -4609,8 +4614,8 @@ Set the mark at the cursor position.
If at the end of line, or if the If at the end of line, or if the
.Ic gmacs .Ic gmacs
option is set, this exchanges the two previous characters; otherwise, it option is set, this exchanges the two previous characters; otherwise, it
exchanges the previous and current characters and moves the cursor right exchanges the previous and current characters and moves the cursor one
one character. character to the right.
.It Xo up-history: .It Xo up-history:
.Op Ar n .Op Ar n
.No ^P , ^XA .No ^P , ^XA
@ -4647,7 +4652,7 @@ editor with the following exceptions:
.It .It
You start out in insert mode. You start out in insert mode.
.It .It
There are file and command completion commands: There are file name and command completion commands:
=, \e, *, ^X, ^E, ^F, and, optionally, =, \e, *, ^X, ^E, ^F, and, optionally,
.Aq tab .Aq tab
and and
@ -4655,8 +4660,11 @@ and
.It .It
The The
.Ic _ .Ic _
command is the last argument command instead of command is different (in
going to the start of the current line. .Nm mksh ,
it is the last argument command; in
.Xr vi 1
it goes to the start of the current line).
.It .It
The The
.Ic / .Ic /
@ -4715,7 +4723,9 @@ Command and file name expansion (see below).
.It Aq esc .It Aq esc
Puts the editor in command mode (see below). Puts the editor in command mode (see below).
.It Aq tab .It Aq tab
Optional file name and command completion, enabled with Optional file name and command completion (see
.Ic ^F
above), enabled with
.Ic set -o vi-tabcomplete . .Ic set -o vi-tabcomplete .
.El .El
.Pp .Pp
@ -4743,7 +4753,11 @@ contains two words) and a
.Dq big-word .Dq big-word
is a sequence of non-whitespace characters. is a sequence of non-whitespace characters.
.Pp .Pp
The following special commands are not in, or are different from, the normal vi file Special
.Nm
vi commands:
.Pp
The following commands are not in, or are different from, the normal vi file
editor: editor:
.Bl -tag -width 10n .Bl -tag -width 10n
.It Xo .It Xo
@ -5298,15 +5312,16 @@ and many other persons, and is currently maintained by
This document attempts to describe This document attempts to describe
.Nm mksh R30 .Nm mksh R30
and up, and up,
compiled without any options impacting functionality. compiled without any options impacting functionality, such as
.Dv MKSH_SMALL ,
for an operating environment supporting all of its advanced needs.
Please report bugs in Please report bugs in
.Nm .Nm
to the to the
.Aq miros-discuss@mirbsd.org .Aq miros-discuss@mirbsd.org
mailing list or in the mailing list or in the
.Li \&#\&!/bin/mksh .Li \&#\&!/bin/mksh
or .Pq or Li \&#ksh
.Li \&#ksh
IRC channel at IRC channel at
.Pa irc.freenode.net:6667 . .Pa irc.freenode.net:6667 .
.Pp .Pp