Correct some hard sentence breaks. Only those surrounding the previous

commit and those which cause ugly nroff output have been fixed, since
the purpose of the style guideline which they contravene is to reduce
the sizes of deltas.

Reported by:	bde
This commit is contained in:
Sheldon Hearn 1999-09-14 11:46:04 +00:00
parent 34dda9f49f
commit e6d3cf2648
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=51275
12 changed files with 107 additions and 96 deletions

View File

@ -55,8 +55,9 @@ job control facilities (see
interactive file name interactive file name
and user name completion (see and user name completion (see
.Sx File Name Completion ) , .Sx File Name Completion ) ,
and a C-like syntax. It is used both as an interactive and a C-like syntax.
login shell and a shell script command processor. It is used both as an interactive login shell and
a shell script command processor.
.Ss Argument list processing .Ss Argument list processing
If the first argument (argument 0) to the shell is If the first argument (argument 0) to the shell is
.Ql Fl \& , .Ql Fl \& ,
@ -236,8 +237,9 @@ may be a component of a pipeline, etc.).
It is also possible to separate pipelines with `\&|\&|' or `&&' showing, It is also possible to separate pipelines with `\&|\&|' or `&&' showing,
as in the C language, as in the C language,
that the second is to be executed only if the first fails or succeeds that the second is to be executed only if the first fails or succeeds
respectively. (See respectively.
.Em Expressions . ) See
.Sx Expressions .
.Ss Jobs .Ss Jobs
The shell associates a The shell associates a
.Ar job .Ar job
@ -317,7 +319,8 @@ The job control mechanism requires that the
.Xr stty 1 .Xr stty 1
option option
.Ic new .Ic new
be set. It is an artifact from a be set.
It is an artifact from a
.Em new .Em new
implementation implementation
of the of the
@ -568,8 +571,8 @@ Repeat the previous substitution.
Apply the change once on each word, prefixing the above, e.g., `g&'. Apply the change once on each word, prefixing the above, e.g., `g&'.
.It a .It a
Apply the change as many times as possible on a single word, prefixing Apply the change as many times as possible on a single word, prefixing
the above. It can be used together with `g' to apply a substitution the above.
globally. It can be used together with `g' to apply a substitution globally.
.It p .It p
Print the new command line but do not execute it. Print the new command line but do not execute it.
.It q .It q

View File

@ -62,8 +62,8 @@ by iBCS2 compatible systems.
.Pp .Pp
Some shells may provide a builtin Some shells may provide a builtin
.Nm .Nm
command which is similar or identical to this utility. Consult command which is similar or identical to this utility.
the Consult the
.Xr builtin 1 .Xr builtin 1
manual page. manual page.
.Sh DIAGNOSTICS .Sh DIAGNOSTICS

View File

@ -112,8 +112,8 @@ TERM (software termination signal)
.Pp .Pp
Some shells may provide a builtin Some shells may provide a builtin
.Nm .Nm
command which is similar or identical to this utility. Consult command which is similar or identical to this utility.
the Consult the
.Xr builtin 1 .Xr builtin 1
manual page. manual page.
.Sh SEE ALSO .Sh SEE ALSO

View File

@ -50,8 +50,8 @@ the standard output.
.Pp .Pp
Some shells may provide a builtin Some shells may provide a builtin
.Nm .Nm
command which is similar or identical to this utility. Consult command which is similar or identical to this utility.
the Consult the
.Xr builtin 1 .Xr builtin 1
manual page. manual page.
.Sh DIAGNOSTICS .Sh DIAGNOSTICS
@ -75,7 +75,7 @@ In
.Xr csh 1 .Xr csh 1
the command the command
.Ic dirs .Ic dirs
is always faster because it is built into that shell. However, is always faster because it is built into that shell.
it can give a different answer in the rare case However, it can give a different answer in the rare case
that the current directory or a containing directory was moved after that the current directory or a containing directory was moved after
the shell descended into it. the shell descended into it.

View File

@ -66,9 +66,9 @@ specification of the shell.
.Ss Overview .Ss Overview
The shell is a command that reads lines from The shell is a command that reads lines from
either a file or the terminal, interprets them, and either a file or the terminal, interprets them, and
generally executes other commands. It is the program that is running generally executes other commands.
when a user logs into the system (although a user can select It is the program that is running when a user logs into the system
a different shell with the (although a user can select a different shell with the
.Xr chsh 1 .Xr chsh 1
command). command).
The shell The shell
@ -106,7 +106,8 @@ at login time in the
.Pa .profile .Pa .profile
file, and commands that are executed for every shell inside the file, and commands that are executed for every shell inside the
.Ev ENV .Ev ENV
file. To set the file.
To set the
.Ev ENV .Ev ENV
variable to some file, place the following line in your variable to some file, place the following line in your
.Pa .profile .Pa .profile
@ -211,8 +212,10 @@ running (i.e. when set with the
.Ic set .Ic set
command). command).
.It Fl T Li asynctraps .It Fl T Li asynctraps
When waiting for a child, execute traps immediately. If this option is When waiting for a child, execute traps immediately.
not set, traps are executed after the child exits, as specified in If this option is not set,
traps are executed after the child exits,
as specified in
.St -p1003.2 .St -p1003.2
This nonstandard option is useful for putting guarding shells around This nonstandard option is useful for putting guarding shells around
children that block signals. The surrounding shell may kill the child children that block signals. The surrounding shell may kill the child
@ -302,9 +305,9 @@ An alias is a name and corresponding value set using the
.Ic alias .Ic alias
builtin command. Whenever a reserved word may occur (see above), builtin command. Whenever a reserved word may occur (see above),
and after checking for reserved words, the shell and after checking for reserved words, the shell
checks the word to see if it matches an alias. If it does, checks the word to see if it matches an alias.
it replaces it in the input stream with its value. For example, If it does, it replaces it in the input stream with its value.
if there is an alias called For example, if there is an alias called
.Dq lf .Dq lf
with the value with the value
.Dq ls -F , .Dq ls -F ,
@ -424,9 +427,10 @@ set to the arguments of the shell function.
The variables which are explicitly placed in the environment of The variables which are explicitly placed in the environment of
the command (by placing assignments to them before the the command (by placing assignments to them before the
function name) are made local to the function and are set function name) are made local to the function and are set
to the values given. Then the command given in the function to the values given.
definition is executed. The positional parameters are Then the command given in the function definition is executed.
restored to their original values when the command completes. The positional parameters are restored to their original values
when the command completes.
This all occurs within the current shell. This all occurs within the current shell.
.Pp .Pp
Shell builtin commands are executed internally to the shell, without Shell builtin commands are executed internally to the shell, without
@ -436,8 +440,8 @@ Otherwise, if the command name does not match a function
or builtin command, the command is searched for as a normal or builtin command, the command is searched for as a normal
program in the filesystem (as described in the next section). program in the filesystem (as described in the next section).
When a normal program is executed, the shell runs the program, When a normal program is executed, the shell runs the program,
passing the arguments and the environment to the passing the arguments and the environment to the program.
program. If the program is not a normal executable file If the program is not a normal executable file
(i.e. if it does not begin with the (i.e. if it does not begin with the
.Qq magic number .Qq magic number
whose whose
@ -446,11 +450,11 @@ representation is
.Qq #! , .Qq #! ,
resulting in an ENOEXEC return value from resulting in an ENOEXEC return value from
.Fn execve ) .Fn execve )
the shell the shell will interpret the program in a subshell.
will interpret the program in a subshell. The child shell The child shell will reinitialize itself in this case,
will reinitialize itself in this case, so that the effect will so that the effect will be
be as if a new shell had been invoked to handle the ad-hoc shell as if a new shell had been invoked to handle the ad-hoc shell script,
script, except that the location of hashed commands located in except that the location of hashed commands located in
the parent shell will be remembered by the child. the parent shell will be remembered by the child.
.Pp .Pp
Note that previous versions of this document Note that previous versions of this document
@ -802,9 +806,10 @@ Tilde expansions, parameter expansions, command substitutions,
arithmetic expansions, and quote removals that occur within arithmetic expansions, and quote removals that occur within
a single word expand to a single field. It is only field a single word expand to a single field. It is only field
splitting or pathname expansion that can create multiple splitting or pathname expansion that can create multiple
fields from a single word. The single exception to this fields from a single word.
rule is the expansion of the special parameter @ within The single exception to this rule is
double-quotes, as was described above. the expansion of the special parameter @ within double-quotes,
as was described above.
.Pp .Pp
The order of word expansion is: The order of word expansion is:
.Bl -enum .Bl -enum
@ -884,7 +889,8 @@ parameter is unset or null, the expansion of
word (or a message indicating it is unset if word (or a message indicating it is unset if
word is omitted) is written to standard word is omitted) is written to standard
error and the shell exits with a nonzero error and the shell exits with a nonzero
exit status. Otherwise, the value of exit status.
Otherwise, the value of
parameter is substituted. An parameter is substituted. An
interactive shell need not exit. interactive shell need not exit.
.It Li ${parameter:+word} .It Li ${parameter:+word}
@ -958,8 +964,8 @@ splitting, they may be translated into <space>s, depending on the value
of IFS and quoting that is in effect.) of IFS and quoting that is in effect.)
.Ss Arithmetic Expansion .Ss Arithmetic Expansion
Arithmetic expansion provides a mechanism for evaluating an arithmetic Arithmetic expansion provides a mechanism for evaluating an arithmetic
expression and substituting its value. The format for arithmetic expression and substituting its value.
expansion is as follows: The format for arithmetic expansion is as follows:
.Bd -literal -offset indent .Bd -literal -offset indent
$((expression)) $((expression))
.Ed .Ed
@ -1012,11 +1018,11 @@ characters and they are turned into meta-characters.
An asterisk An asterisk
.Dq * .Dq *
matches any string of characters. A matches any string of characters. A
question mark matches any single character. A left question mark matches any single character.
bracket A left bracket
.Dq [ .Dq [
introduces a character class. The end of introduces a character class.
the character class is indicated by a The end of the character class is indicated by a
.Dq ] ; .Dq ] ;
if the if the
.Dq ] .Dq ]
@ -1024,21 +1030,19 @@ is missing then the
.Dq [ .Dq [
matches a matches a
.Dq [ .Dq [
rather than rather than introducing a character class.
introducing a character class. A character class matches A character class matches any of the characters between the square brackets.
any of the characters between the square brackets. A A range of characters may be specified using a minus sign.
range of characters may be specified using a minus sign. The character class may be complemented
The character class may be complemented by making an by making an exclamation point the first character of the character class.
exclamation point the first character of the character
class.
.Pp .Pp
To include a To include a
.Dq ] .Dq ]
in a character class, make it the first in a character class, make it the first character listed
character listed (after the (after the
.Dq ! , .Dq ! ,
if any). To include a if any).
minus sign, make it the first or last character listed. To include a minus sign, make it the first or last character listed.
.Ss Builtin Commands .Ss Builtin Commands
This section lists the commands which This section lists the commands which
are builtin because they need to perform some operation are builtin because they need to perform some operation
@ -1090,16 +1094,16 @@ and the directory name does not begin with a slash (/),
dot (.) or dot-dot (..), dot (.) or dot-dot (..),
then the directories listed in CDPATH will be then the directories listed in CDPATH will be
searched for the specified directory. The format of searched for the specified directory. The format of
CDPATH is the same as that of PATH. In an interactive shell, CDPATH is the same as that of PATH.
the cd command will print out the name of In an interactive shell,
the directory that it actually switched to if this is the cd command will print out the name of the directory
different from the name that the user gave. These that it actually switched to
may be different either because the CDPATH mechanism if this is different from the name that the user gave.
These may be different either because the CDPATH mechanism
was used or because a symbolic link was crossed. was used or because a symbolic link was crossed.
.It eval string ... .It eval string ...
Concatenate all the arguments with spaces. Then Concatenate all the arguments with spaces.
re-parse and execute the Then re-parse and execute the command.
command.
.It exec [ command arg ... ] .It exec [ command arg ... ]
Unless command is omitted, the shell process is Unless command is omitted, the shell process is
replaced with the specified program (which must be a replaced with the specified program (which must be a
@ -1289,11 +1293,10 @@ to executing
.El .El
.Pp .Pp
.It setvar variable value .It setvar variable value
Assigns value to variable. (In general it is better Assigns value to variable.
to write variable=value rather than using setvar. In general it is better to write variable=value rather than using setvar.
Setvar is intended to be used in functions that Setvar is intended to be used in functions that
assign values to variables whose names are passed as assign values to variables whose names are passed as parameters.
parameters.)
.It shift [ n ] .It shift [ n ]
Shift the positional parameters n times. A shift Shift the positional parameters n times. A shift
sets the value of $1 to the value of $2, the value of sets the value of $1 to the value of $2, the value of
@ -1312,7 +1315,8 @@ default action. The trap command has no effect on
signals that were ignored on entry to the shell. signals that were ignored on entry to the shell.
.It type [name] ... .It type [name] ...
Interpret each name as a command and print the Interpret each name as a command and print the
resolution of the command search. Possible resolutions are: resolution of the command search.
Possible resolutions are:
shell keyword, alias, shell builtin command, command, tracked alias shell keyword, alias, shell builtin command, command, tracked alias
and not found. For aliases the alias expansion is printed; and not found. For aliases the alias expansion is printed;
for commands and tracked aliases the complete pathname of for commands and tracked aliases the complete pathname of
@ -1374,8 +1378,8 @@ The maximal number of simultaneous processes for this user ID.
Set the value of umask (see Set the value of umask (see
.Xr umask 2 ) .Xr umask 2 )
to the specified to the specified
octal value. If the argument is omitted, the octal value.
umask value is printed. If the argument is omitted, the umask value is printed.
.It unalias [-a] [name] .It unalias [-a] [name]
If If
.Dq name .Dq name
@ -1385,14 +1389,14 @@ If
is specified, all aliases are removed. is specified, all aliases are removed.
.It unset name ... .It unset name ...
The specified variables and functions are unset and The specified variables and functions are unset and
unexported. If a given name corresponds to both a unexported.
variable and a function, both the variable and the If a given name corresponds to both a variable and a function,
function are unset. both the variable and the function are unset.
.It wait [ job ] .It wait [ job ]
Wait for the specified job to complete and return the Wait for the specified job to complete and return the
exit status of the last process in the job. If the exit status of the last process in the job.
argument is omitted, wait for all jobs to complete If the argument is omitted, wait for all jobs to complete
and the return an exit status of zero. and return an exit status of zero.
.El .El
.Ss Commandline Editing .Ss Commandline Editing
When When

View File

@ -125,8 +125,8 @@ any component of a pipeline except the last.
If a command specified to the shell contains a slash If a command specified to the shell contains a slash
.Dq \&/ , .Dq \&/ ,
the shell will not execute a builtin command, even if the last component the shell will not execute a builtin command, even if the last component
of the specified command matches the name of a builtin command. Thus, of the specified command matches the name of a builtin command.
while specifying Thus, while specifying
.Dq Ic echo .Dq Ic echo
causes a builtin command to be executed under shells that support the causes a builtin command to be executed under shells that support the
builtin echo command, builtin echo command,
@ -145,7 +145,8 @@ Only builtin commands for the
.Xr csh 1 .Xr csh 1
and and
.Xr sh 1 .Xr sh 1
shells are listed here. Consult the appropriate manual page for shells are listed here.
Consult the appropriate manual page for
details on the operation of any given builtin command under those shells. details on the operation of any given builtin command under those shells.
Users of other shells will need to consult the documentation supplied Users of other shells will need to consult the documentation supplied
with the other shells. with the other shells.

View File

@ -145,8 +145,8 @@ a user's login environment.
.Pp .Pp
Some shells may provide a builtin Some shells may provide a builtin
.Nm .Nm
command which is similar or identical to this utility. Consult command which is similar or identical to this utility.
the Consult the
.Xr builtin 1 .Xr builtin 1
manual page. manual page.
.Sh FILES .Sh FILES

View File

@ -54,8 +54,8 @@ If
is not given is not given
.Nm .Nm
assumed the value 10. assumed the value 10.
The priority is a value in the range -20 to 20. The default priority The priority is a value in the range -20 to 20.
is 0, priority 20 is the lowest possible. The default priority is 0, priority 20 is the lowest possible.
.Nm Nice .Nm Nice
will execute will execute
.Ar command .Ar command
@ -76,8 +76,8 @@ command executed by
.Pp .Pp
Some shells may provide a builtin Some shells may provide a builtin
.Nm .Nm
command which is similar or identical to this utility. Consult command which is similar or identical to this utility.
the Consult the
.Xr builtin 1 .Xr builtin 1
manual page. manual page.
.Sh EXAMPLES .Sh EXAMPLES

View File

@ -54,7 +54,8 @@ with
its arguments its arguments
and at this time sets the signal and at this time sets the signal
.Dv SIGHUP .Dv SIGHUP
to be ignored. The signal to be ignored.
The signal
.Dv SIGQUIT .Dv SIGQUIT
may also be set may also be set
to be ignored. to be ignored.
@ -71,8 +72,8 @@ exits 1 if an error occurs, otherwise the exit status is that of
.Pp .Pp
Some shells may provide a builtin Some shells may provide a builtin
.Nm .Nm
command which is similar or identical to this utility. Consult command which is similar or identical to this utility.
the Consult the
.Xr builtin 1 .Xr builtin 1
manual page. manual page.
.Sh ENVIRONMENT .Sh ENVIRONMENT

View File

@ -253,8 +253,8 @@ the actual width.
.Pp .Pp
Some shells may provide a builtin Some shells may provide a builtin
.Nm .Nm
command which is similar or identical to this utility. Consult command which is similar or identical to this utility.
the Consult the
.Xr builtin 1 .Xr builtin 1
manual page. manual page.
.Sh RETURN VALUES .Sh RETURN VALUES

View File

@ -71,7 +71,8 @@ Available options:
If the If the
.Fl o .Fl o
flag is used, append to the specified file rather than overwriting flag is used, append to the specified file rather than overwriting
it. Otherwise, this option has no effect. it.
Otherwise, this option has no effect.
.It Fl l .It Fl l
The contents of the The contents of the
.Em rusage .Em rusage
@ -92,14 +93,15 @@ output POSIX.2 compliant (each time is printed on its own line).
.Pp .Pp
Some shells may provide a builtin Some shells may provide a builtin
.Nm .Nm
command which is similar or identical to this utility. Consult command which is similar or identical to this utility.
the Consult the
.Xr builtin 1 .Xr builtin 1
manual page. manual page.
.Sh DIAGNOSTICS .Sh DIAGNOSTICS
If If
.Ar command .Ar command
could be timed successfully, its exit status is returned. In case could be timed successfully, its exit status is returned.
If
.Ar command .Ar command
terminated abnormally, a warning message is output to stderr. terminated abnormally, a warning message is output to stderr.
If the If the

View File

@ -55,8 +55,8 @@ none are found.
.Pp .Pp
Some shells may provide a builtin Some shells may provide a builtin
.Nm .Nm
command which is similar or identical to this utility. Consult command which is similar or identical to this utility.
the Consult the
.Xr builtin 1 .Xr builtin 1
manual page. manual page.
.Sh HISTORY .Sh HISTORY