summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPhilippe Charnier <charnier@FreeBSD.org>1998-06-30 06:43:23 +0000
committerPhilippe Charnier <charnier@FreeBSD.org>1998-06-30 06:43:23 +0000
commit7da55eded99ad73ad4c1f683ecee972623fce454 (patch)
tree4bffc34a45d84e54612271c5936574a4c1583a9c
parent202eb0eeb1ce3b7ea74cb89aa1308069993eb565 (diff)
Notes
-rw-r--r--bin/cat/cat.130
-rw-r--r--bin/csh/csh.160
-rw-r--r--bin/date/date.14
-rw-r--r--bin/domainname/domainname.14
-rw-r--r--bin/hostname/hostname.14
-rw-r--r--bin/mkdir/mkdir.14
-rw-r--r--bin/pax/pax.111
-rw-r--r--bin/pwd/pwd.14
-rw-r--r--bin/rmail/rmail.810
-rw-r--r--bin/rmdir/rmdir.16
-rw-r--r--bin/sh/sh.16
-rw-r--r--bin/sleep/sleep.14
-rw-r--r--bin/stty/stty.16
-rw-r--r--bin/sync/sync.86
14 files changed, 86 insertions, 73 deletions
diff --git a/bin/cat/cat.1 b/bin/cat/cat.1
index cf869d124d5aa..8e324fcc967c4 100644
--- a/bin/cat/cat.1
+++ b/bin/cat/cat.1
@@ -33,7 +33,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)cat.1 8.3 (Berkeley) 5/2/95
-.\" $Id: cat.1,v 1.6 1997/02/22 14:01:26 peter Exp $
+.\" $Id: cat.1,v 1.3.2.1 1997/02/28 07:54:20 mpp Exp $
.\"
.Dd May 2, 1995
.Dt CAT 1
@@ -56,41 +56,38 @@ operands are processed in command line order.
A single dash represents the standard input.
.Pp
The options are as follows:
-.Bl -tag -width Ds
+.Bl -tag -width indent
.It Fl b
-Implies the
-.Fl n
-option but doesn't number blank lines.
+Number the non-blank output lines, starting at 1.
.It Fl e
-Implies the
+Display non-printing characters (see the
.Fl v
-option, and displays a dollar sign
+option), and display a dollar sign
.Pq Ql \&$
-at the end of each line
-as well.
+at the end of each line.
.It Fl n
Number the output lines, starting at 1.
.It Fl s
Squeeze multiple adjacent empty lines, causing the output to be
single spaced.
.It Fl t
-Implies the
+Display non-printing characters (see the
.Fl v
-option, and displays tab characters as
-.Ql ^I
-as well.
+option), and display tab characters as
+.Ql ^I .
.It Fl u
The
.Fl u
option guarantees that the output is unbuffered.
.It Fl v
-Displays non-printing characters so they are visible.
+Display non-printing characters so they are visible.
Control characters print as
.Ql ^X
for control-X; the delete
character (octal 0177) prints as
.Ql ^?
-Non-ascii characters (with the high bit set) are printed as
+.Pf Non- Tn ASCII
+characters (with the high bit set) are printed as
.Ql M-
(for meta) followed by the character for the low 7 bits.
.El
@@ -119,7 +116,8 @@ will cause the original data in file1 to be destroyed!
A
.Nm
command appeared in Version 1 AT&T UNIX.
-Dennis Ritchie designed and wrote the first man page.
+.An Dennis Ritchie
+designed and wrote the first man page.
It appears to have been
.Xr cat 1 .
diff --git a/bin/csh/csh.1 b/bin/csh/csh.1
index 9436ac5d7f485..eee16d5120af5 100644
--- a/bin/csh/csh.1
+++ b/bin/csh/csh.1
@@ -30,7 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)csh.1 8.2 (Berkeley) 1/21/94
-.\" $Id: csh.1,v 1.8 1997/02/22 14:01:40 peter Exp $
+.\" $Id: csh.1,v 1.5.2.1 1997/02/28 07:54:29 mpp Exp $
.\"
.Dd January 21, 1994
.Dt CSH 1
@@ -49,9 +49,9 @@ The
.Nm csh
is a command language interpreter
incorporating a history mechanism (see
-.Nm History Substitutions ) ,
+.Sx History Substitutions ) ,
job control facilities (see
-.Nm Jobs ) ,
+.Sx Jobs ) ,
interactive file name
and user name completion (see
.Nm File Name Completion ) ,
@@ -100,7 +100,7 @@ is the only flag specified).
The shell loads
.Pa .cshrc
even if it does not belong to the effective user.
-.Xr su 1
+.Xr Su 1
can pass
.Fl m
to the shell.
@@ -256,7 +256,7 @@ showing that the job which was started asynchronously was job number
1 and had one (top-level) process, whose process id was 1234.
.Pp
If you are running a job and wish to do something else you may hit the key
-.Nm ^Z
+.Em ^Z
(control-Z) which sends a STOP signal to the current job.
The shell will then normally show that the job has been `Stopped',
and print another prompt. You can then manipulate the state of this job,
@@ -271,11 +271,11 @@ the
command
.Ar fg .
A
-.Nm ^Z
+.Em ^Z
takes effect immediately and
is like an interrupt in that pending output and unread input are discarded
when it is typed. There is another special key
-.Nm ^Y
+.Em ^Y
that does not generate a STOP signal until a program attempts to
.Xr read 2
it.
@@ -455,7 +455,7 @@ in the previous command with little typing and a high degree of confidence.
History substitutions begin with the character `!' and may begin
.Ar anywhere
in the input stream (with the proviso that they
-.Nm "do not"
+.Em "do not"
nest.)
This `!' may be preceded by a `\e' to prevent its special meaning; for
convenience, an `!' is passed unchanged when it is followed by a blank,
@@ -631,7 +631,7 @@ Strings enclosed in `"' may be expanded as described below.
.Pp
In both cases the resulting text becomes (all or part of) a single word;
only in one special case (see
-.Em Command Substitution
+.Sx Command Substitution
below) does a `"' quoted string yield parts of more than one word;
`\'' quoted strings never do.
.Ss Alias substitution
@@ -708,7 +708,7 @@ occurs, and within `\''s where it
.Em never
occurs.
Strings quoted by `\*(ga' are interpreted later (see
-.Nm "Command substitution"
+.Sx "Command substitution"
below) so `$' substitution does not occur there until later, if at all.
A `$' is passed unchanged if followed by a blank, tab, or end-of-line.
.Pp
@@ -961,11 +961,11 @@ Several of the builtin commands (to be described later)
take expressions, in which the operators are similar to those of C, with
the same precedence.
These expressions appear in the
-.Nm @,
-.Ar exit ,
-.Ar if ,
+.Em @,
+.Em exit ,
+.Em if ,
and
-.Ar while
+.Em while
commands.
The following operators are available:
.Bd -ragged -offset indent
@@ -1335,7 +1335,7 @@ option lists process id's in addition to the normal information.
Sends either the TERM (terminate) signal or the
specified signal to the specified jobs or processes.
Signals are either given by number or by names (as given in
-.Pa /usr/include/signal.h,
+.Pa /usr/include/signal.h ,
stripped of the prefix ``SIG'').
The signal names are listed by ``kill \-l''.
There is no default, just saying `kill' does not
@@ -1405,7 +1405,7 @@ of the names suffice.
.Pp
.It Ic login
Terminate a login shell, replacing it with an instance of
-.Pa /usr/bin/login.
+.Pa /usr/bin/login .
This is one way to log off, included for compatibility with
.Xr sh 1 .
.Pp
@@ -1625,7 +1625,9 @@ commands.
Normally input during
.Ic source
commands is not placed on the history list;
-the \-h option causes the commands to be placed on the
+the
+.Fl h
+option causes the commands to be placed on the
history list without being executed.
.Pp
.It Ic stop
@@ -1635,9 +1637,9 @@ Stops the current or specified jobs that are executing in the background.
.It Ic suspend
Causes the shell to stop in its tracks, much as if it had been sent a stop
signal with
-.Ic ^Z .
+.Em ^Z .
This is most often used to stop shells started by
-.Xr su 1 .
+.Xr su 1 .
.Pp
.It Ic switch Ar (string)
.It Ic case Ar str1 :
@@ -2080,13 +2082,21 @@ signal; otherwise this signal is passed on to children from the state in the
shell's parent.
Interrupts are not allowed when a login shell is reading the file
.Pa \&.logout .
-.Sh AUTHOR
-William Joy.
-Job control and directory stack features first implemented by J.E. Kulp of
-IIASA, Laxenburg, Austria,
+.Sh AUTHORS
+.An William Joy .
+.Pp
+Job control and directory stack features first implemented by
+.An J.E. Kulp
+of IIASA, Laxenburg, Austria,
with different syntax than that used now.
-File name completion code written by Ken Greer, HP Labs.
-Eight-bit implementation Christos S. Zoulas, Cornell University.
+.Pp
+File name completion code written by
+.An Ken Greer ,
+HP Labs.
+.Pp
+Eight-bit implementation
+.An Christos S. Zoulas ,
+Cornell University.
.Sh FILES
.Bl -tag -width /etc/passwd -compact
.It Pa ~/.cshrc
diff --git a/bin/date/date.1 b/bin/date/date.1
index f00f0e9998b12..2b7c67524c855 100644
--- a/bin/date/date.1
+++ b/bin/date/date.1
@@ -33,7 +33,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)date.1 8.3 (Berkeley) 4/28/95
-.\" $Id: date.1,v 1.8.2.6 1997/10/03 12:54:28 danny Exp $
+.\" $Id: date.1,v 1.8.2.7 1998/02/15 11:01:38 jkh Exp $
.\"
.Dd November 17, 1993
.Dt DATE 1
@@ -112,7 +112,7 @@ Adjust the minute, hour, month day, week day, month or year according to
.Ar val .
If
.Ar val
-is preceeded with a plus or minus sign, the date is adjusted forwards
+is preceded with a plus or minus sign, the date is adjusted forwards
or backwards according to the remaining string, otherwise the relevant
part of the date is set. The date can be adjusted as many times as
required using these flags. Flags are processed in the order given.
diff --git a/bin/domainname/domainname.1 b/bin/domainname/domainname.1
index fd54736981bf4..b08d3d5184649 100644
--- a/bin/domainname/domainname.1
+++ b/bin/domainname/domainname.1
@@ -30,7 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" From: @(#)hostname.1 8.1 (Berkeley) 5/31/93
-.\" $Id: domainname.1,v 1.2 1995/01/14 17:02:33 ats Exp $
+.\" $Id: domainname.1,v 1.2.6.1 1997/08/24 21:48:26 jkh Exp $
.\"
.Dd September 18, 1994
.Dt DOMAINNAME 1
@@ -42,7 +42,7 @@
.Nm domainname
.Op Ar ypdomain
.Sh DESCRIPTION
-.Nm domainname
+.Nm Domainname
prints the name of the current YP/NIS domain. The super-user can
set the domain name by supplying an argument; this is usually done in the
network initialization script
diff --git a/bin/hostname/hostname.1 b/bin/hostname/hostname.1
index dd4e826cf3346..df502bdf9f59b 100644
--- a/bin/hostname/hostname.1
+++ b/bin/hostname/hostname.1
@@ -30,7 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)hostname.1 8.2 (Berkeley) 4/28/95
-.\" $Id: hostname.1,v 1.3.2.1 1997/02/28 07:54:36 mpp Exp $
+.\" $Id: hostname.1,v 1.3.2.2 1997/08/24 21:51:25 jkh Exp $
.\"
.Dd April 28, 1995
.Dt HOSTNAME 1
@@ -43,7 +43,7 @@
.Op Fl s
.Op Ar name-of-host
.Sh DESCRIPTION
-.Nm
+.Nm Hostname
prints the name of the current host. The super-user can
set the hostname by supplying an argument; this is usually done in the
network initialization script
diff --git a/bin/mkdir/mkdir.1 b/bin/mkdir/mkdir.1
index 8f9a09927f159..de42de3ed231b 100644
--- a/bin/mkdir/mkdir.1
+++ b/bin/mkdir/mkdir.1
@@ -33,7 +33,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)mkdir.1 8.2 (Berkeley) 1/25/94
-.\" $Id: mkdir.1,v 1.6 1997/02/22 14:04:08 peter Exp $
+.\" $Id: mkdir.1,v 1.3.2.1 1997/02/28 07:54:38 mpp Exp $
.\"
.Dd January 25, 1994
.Dt MKDIR 1
@@ -81,7 +81,7 @@ permission for the owner.
.Pp
The user must have write permission in the parent directory.
.Pp
-.Nm
+.Nm Mkdir
exits 0 if successful, and >0 if an error occurred.
.Sh SEE ALSO
.Xr rmdir 1
diff --git a/bin/pax/pax.1 b/bin/pax/pax.1
index e132358ef4788..cb85a754bc84b 100644
--- a/bin/pax/pax.1
+++ b/bin/pax/pax.1
@@ -34,7 +34,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)pax.1 8.4 (Berkeley) 4/18/94
-.\" $Id: pax.1,v 1.3 1995/08/16 23:12:25 nate Exp $
+.\" $Id: pax.1,v 1.3.2.1 1998/05/31 22:44:52 steve Exp $
.\"
.Dd April 18, 1994
.Dt PAX 1
@@ -298,7 +298,7 @@ If the
.Ar directory
operand does not exist, or it is not writable by the user,
or it is not of type directory,
-.Nm Pax
+.Nm
will exit with a non-zero exit status.
.Pp
The
@@ -1121,10 +1121,11 @@ and
operations are extensions to the
.Tn POSIX
standard.
-.Sh AUTHOR
-Keith Muller at the University of California, San Diego
+.Sh AUTHORS
+.An Keith Muller
+at the University of California, San Diego
.Sh ERRORS
-.Nm pax
+.Nm Pax
will exit with one of the following values:
.Bl -tag -width 2n
.It 0
diff --git a/bin/pwd/pwd.1 b/bin/pwd/pwd.1
index a922d12ae817d..10b303988403a 100644
--- a/bin/pwd/pwd.1
+++ b/bin/pwd/pwd.1
@@ -33,7 +33,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)pwd.1 8.2 (Berkeley) 4/28/95
-.\" $Id: pwd.1,v 1.5 1997/02/22 14:05:15 peter Exp $
+.\" $Id: pwd.1,v 1.2.8.1 1997/02/28 07:54:40 mpp Exp $
.\"
.Dd April 28, 1995
.Dt PWD 1
@@ -44,7 +44,7 @@
.Sh SYNOPSIS
.Nm pwd
.Sh DESCRIPTION
-.Nm
+.Nm Pwd
writes the absolute pathname of the current working directory to
the standard output.
.Pp
diff --git a/bin/rmail/rmail.8 b/bin/rmail/rmail.8
index dba93188e6081..a364357ae41b0 100644
--- a/bin/rmail/rmail.8
+++ b/bin/rmail/rmail.8
@@ -30,7 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)rmail.8 6.10 (Berkeley) 4/29/93
-.\" $Id: rmail.8,v 1.5 1997/02/22 14:05:30 peter Exp $
+.\" $Id: rmail.8,v 1.2.8.1 1997/02/28 07:54:43 mpp Exp $
.\"
.Dd April 29, 1993
.Dt RMAIL 8
@@ -42,7 +42,7 @@
.Nm rmail
.Ar user ...
.Sh DESCRIPTION
-.Nm
+.Nm Rmail
interprets incoming mail received via
.Xr uucp 1 ,
collapsing ``From'' lines in the form generated
@@ -52,11 +52,11 @@ into a single line of the form ``return-path!sender'',
and passing the processed mail on to
.Xr sendmail 8 .
.Pp
-.Nm
+.Nm Rmail
is explicitly designed for use with
-.Xr uucp
+.Xr uucp 1
and
-.Xr sendmail .
+.Xr sendmail 8 .
.Sh SEE ALSO
.Xr uucp 1 ,
.Xr mail.local 8 ,
diff --git a/bin/rmdir/rmdir.1 b/bin/rmdir/rmdir.1
index 8ae09ecdaa85b..52144c3698064 100644
--- a/bin/rmdir/rmdir.1
+++ b/bin/rmdir/rmdir.1
@@ -33,7 +33,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)rmdir.1 8.1 (Berkeley) 5/31/93
-.\" $Id: rmdir.1,v 1.3 1996/08/29 18:06:08 wosch Exp $
+.\" $Id: rmdir.1,v 1.3.2.1 1997/08/25 08:43:05 jkh Exp $
.\"
.Dd May 31, 1993
.Dt RMDIR 1
@@ -46,7 +46,9 @@
.Op Fl p
.Ar directory ...
.Sh DESCRIPTION
-The rmdir utility removes the directory entry specified by
+The
+.Nm
+utility removes the directory entry specified by
each
.Ar directory
argument, provided it is empty.
diff --git a/bin/sh/sh.1 b/bin/sh/sh.1
index 4841214164069..6b56c5681fa40 100644
--- a/bin/sh/sh.1
+++ b/bin/sh/sh.1
@@ -33,7 +33,7 @@
.\" SUCH DAMAGE.
.\"
.\" from: @(#)sh.1 8.6 (Berkeley) 5/4/95
-.\" $Id: sh.1,v 1.9.2.7 1998/02/12 01:25:29 jdp Exp $
+.\" $Id: sh.1,v 1.9.2.8 1998/02/15 11:32:26 jkh Exp $
.\"
.Dd May 5, 1995
.Dt SH 1
@@ -48,7 +48,7 @@
.Op Fl c Ar string
.Op Ar arg ...
.Sh DESCRIPTION
-.Nm sh
+.Nm Sh
is the standard command interpreter for the system.
The current version of
.Nm
@@ -1092,7 +1092,7 @@ The following environment variables affect the execution of fc:
.It Va FCEDIT
Name of the editor to use.
.It Va HISTSIZE
-The number of previous commands that are accessable.
+The number of previous commands that are accessible.
.El
.It fg [ job ]
Move the specified job or the current job to the
diff --git a/bin/sleep/sleep.1 b/bin/sleep/sleep.1
index af5e5c19c8cca..cabb537ef7ba5 100644
--- a/bin/sleep/sleep.1
+++ b/bin/sleep/sleep.1
@@ -33,7 +33,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)sleep.1 8.3 (Berkeley) 4/18/94
-.\" $Id: sleep.1,v 1.2.8.1 1997/02/28 07:54:48 mpp Exp $
+.\" $Id: sleep.1,v 1.2.8.2 1997/08/25 09:18:37 jkh Exp $
.\"
.Dd April 18, 1994
.Dt SLEEP 1
@@ -50,7 +50,7 @@ The
command
suspends execution for a minimum of
.Ar seconds .
-.Nm
+.Nm Sleep
is used to schedule the execution of other commands (see
.Sx EXAMPLES
below).
diff --git a/bin/stty/stty.1 b/bin/stty/stty.1
index 79f5a93b01c57..3276c7401684b 100644
--- a/bin/stty/stty.1
+++ b/bin/stty/stty.1
@@ -33,7 +33,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)stty.1 8.4 (Berkeley) 4/18/94
-.\" $Id: stty.1,v 1.4.2.2 1997/06/02 06:38:39 charnier Exp $
+.\" $Id: stty.1,v 1.4.2.3 1998/06/03 04:12:26 jkoshy Exp $
.\"
.Dd April 18, 1994
.Dt STTY 1
@@ -493,7 +493,9 @@ first rows, then columns.
.Ss Compatibility Modes:
.Pp
These modes remain for compatibility with the previous version of
-the stty command.
+the
+.Nm
+command.
.Bl -tag -width Fl
.It Cm all
Reports all the terminal modes as with
diff --git a/bin/sync/sync.8 b/bin/sync/sync.8
index 3bbb57fbbf3e3..30b3859ef89a1 100644
--- a/bin/sync/sync.8
+++ b/bin/sync/sync.8
@@ -30,7 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)sync.8 8.1 (Berkeley) 5/31/93
-.\" $Id: sync.8,v 1.3 1996/02/12 00:45:47 mpp Exp $
+.\" $Id: sync.8,v 1.3.2.1 1997/08/25 09:25:24 jkh Exp $
.\"
.Dd May 31, 1993
.Dt SYNC 8
@@ -48,9 +48,9 @@ processor is halted in a way not suitably done by
or
.Xr halt 8 .
Generally, it is preferable to use
-.Xr reboot
+.Xr reboot 8
or
-.Xr halt
+.Xr halt 8
to shut down the system,
as they may perform additional actions
such as resynchronizing the hardware clock