fix a typo and shrink it to 39 DIN A4 pages

This commit is contained in:
tg 2007-03-10 21:14:07 +00:00
parent b08848c7ff
commit dbf38a152d
1 changed files with 33 additions and 44 deletions

77
mksh.1
View File

@ -1,4 +1,4 @@
.\" $MirOS: src/bin/mksh/mksh.1,v 1.80 2007/03/10 00:34:54 tg Exp $ .\" $MirOS: src/bin/mksh/mksh.1,v 1.81 2007/03/10 21:14:07 tg Exp $
.\" $OpenBSD: ksh.1,v 1.118 2006/11/30 08:47:58 jmc Exp $ .\" $OpenBSD: ksh.1,v 1.118 2006/11/30 08:47:58 jmc Exp $
.\" .\"
.Dd March 10, 2007 .Dd March 10, 2007
@ -173,14 +173,11 @@ 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, the file variable is unset or empty, but not set to a non-existing filename, 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
unset in the shell environment. 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
@ -737,10 +734,9 @@ succeeds).
.It .It
The single argument form of The single argument form of
.Ic test , .Ic test ,
which tests if the argument has a non-zero length, is not valid; explicit .No \&[ Ar str No \&] ,
operators must always be used e.g. instead of which tests if the argument has a non-zero length, is not valid;
.No \&[ Ar str No \&] use explicit operators instead, i.e.\&
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
@ -750,12 +746,12 @@ and
.Ql \*(Ba\*(Ba .Ql \*(Ba\*(Ba
operators. operators.
This means that in the following statement, This means that in the following statement,
.Ic $(\*(Lt foo) .Ic $(\*(Ltfoo)
is evaluated if and only if the file is evaluated if and only if the file
.Pa foo .Pa foo
exists and is readable: exists and is readable:
.Bd -literal -offset indent .Bd -literal -offset indent
$ [[ -r foo && $(\*(Lt foo) = b*r ]] $ [[ -r foo && $(\*(Ltfoo) = b*r ]]
.Ed .Ed
.El .El
.El .El
@ -982,16 +978,15 @@ As a special case in command substitutions, a command of the form
is interpreted to mean substitute the contents of is interpreted to mean substitute the contents of
.Ar file . .Ar file .
Note that Note that
.Ic $(\*(Lt foo) .Ic $(\*(Ltfoo)
has the same effect as has the same effect as
.Ic $(cat foo) , .Ic $(cat foo) ,
but it is carried out more efficiently because no process is started. but it is carried out more efficiently because no process is started.
.Pp .Pp
.Sy Note : .Sy Note :
.Pf $( Ns Ar command Ns \&) .Pf $( Ns Ar command Ns \&)
expressions are currently parsed by finding the matching parenthesis, 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
@ -1382,7 +1377,9 @@ parameters all point to the same file.
If If
.Ev HISTFILE .Ev HISTFILE
isn't set, no history file is used. isn't set, no history file is used.
This is different from the original Korn shell. This is different from
.At
.Nm ksh .
.It Ev HISTSIZE .It Ev HISTSIZE
The number of commands normally stored for history. The number of commands normally stored for history.
The default is 500. The default is 500.
@ -1429,7 +1426,7 @@ When using
.Ic getopts , .Ic getopts ,
it contains the argument for a parsed option, if it requires one. it contains the argument for a parsed option, if it requires one.
.It Ev OPTIND .It Ev OPTIND
The index of the next argument to be processed when using The index of the next argument to be processed by
.Ic getopts . .Ic getopts .
Assigning 1 to this parameter causes Assigning 1 to this parameter causes
.Ic getopts .Ic getopts
@ -1548,7 +1545,7 @@ if the shell doesn't know where it is.
Every time Every time
.Ev RANDOM .Ev RANDOM
is referenced, it is assigned a pseudo-random number first. is referenced, it is assigned a pseudo-random number first.
By default, if available, By default,
.Xr arc4random 3 .Xr arc4random 3
is used to produce unsigned 15\-bit values (0\-32767) is used to produce unsigned 15\-bit values (0\-32767)
whose quality depends on the operating environment. whose quality depends on the operating environment.
@ -3262,8 +3259,8 @@ the positional parameters (or to array
if if
.Fl A .Fl A
is used). is used).
.It Fl U \(*Ba Ic utf8-hack .It Fl U \*(Ba Ic utf8-hack
Enable an experimental UTF-8 hack for the Enable UTF-8 support in the
.Sx Emacs editing mode . .Sx Emacs editing mode .
This is enabled automatically for interactive shells if your system supports This is enabled automatically for interactive shells if your system supports
.Fn setlocale LC_CTYPE \&"" .Fn setlocale LC_CTYPE \&""
@ -3323,10 +3320,13 @@ Do not kill running jobs with a
.Dv SIGHUP .Dv SIGHUP
signal when a login shell exits. signal when a login shell exits.
Currently set by default, but this will Currently set by default, but this will
change in the future to be compatible with the original Korn shell (which change in the future to be compatible with
.At
.Nm ksh ,
which
doesn't have this option, but does send the doesn't have this option, but does send the
.Dv SIGHUP .Dv SIGHUP
signal). signal.
.It Ic nolog .It Ic nolog
No effect. No effect.
In the original Korn shell, this prevents function definitions from In the original Korn shell, this prevents function definitions from
@ -3905,7 +3905,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 they are also given on the same command line. unless listed in the same command.
.Pp .Pp
.It Xo .It Xo
.Ic ulimit .Ic ulimit
@ -4586,8 +4586,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 one exchanges the previous and current characters and moves the cursor right
character to the right. one character.
.It Xo up-history: .It Xo up-history:
.Op Ar n .Op Ar n
.No ^P , ^XA .No ^P , ^XA
@ -4624,7 +4624,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 name and command completion commands: There are file and command completion commands:
=, \e, *, ^X, ^E, ^F, and, optionally, =, \e, *, ^X, ^E, ^F, and, optionally,
.Aq tab .Aq tab
and and
@ -4632,11 +4632,8 @@ and
.It .It
The The
.Ic _ .Ic _
command is different (in command is the last argument command instead of
.Nm going to the start of the current line.
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 /
@ -4695,9 +4692,7 @@ 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 (see Optional file name and command completion, enabled with
.Ic ^F
above), enabled with
.Ic set -o vi-tabcomplete . .Ic set -o vi-tabcomplete .
.El .El
.Pp .Pp
@ -4725,11 +4720,7 @@ 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
Special The following special commands are not in, or are different from, the normal vi file
.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
@ -5282,10 +5273,8 @@ and many other persons, and is currently maintained by
.An Thorsten Glaser Aq tg@mirbsd.de . .An Thorsten Glaser Aq tg@mirbsd.de .
.Sh BUGS .Sh BUGS
This document attempts to describe This document attempts to describe
.Nm mksh R29 , .Nm mksh R29b ,
compiled without compiled without any options impacting functionality.
.Dv MKSH_SMALL
or other functionality-reducing options.
Please report bugs in Please report bugs in
.Nm .Nm
to the to the
@ -5295,7 +5284,7 @@ mailing list or in the
or or
.Li \&#ksh .Li \&#ksh
IRC channel at IRC channel at
.Pa irc.freenode.net . .Pa irc.freenode.net:6667 .
.Pp .Pp
By the way, the most frequently reported bug is: By the way, the most frequently reported bug is:
.Bd -literal -offset indent .Bd -literal -offset indent