diff options
author | Philippe Charnier <charnier@FreeBSD.org> | 1998-06-30 06:43:23 +0000 |
---|---|---|
committer | Philippe Charnier <charnier@FreeBSD.org> | 1998-06-30 06:43:23 +0000 |
commit | 7da55eded99ad73ad4c1f683ecee972623fce454 (patch) | |
tree | 4bffc34a45d84e54612271c5936574a4c1583a9c | |
parent | 202eb0eeb1ce3b7ea74cb89aa1308069993eb565 (diff) |
Notes
-rw-r--r-- | bin/cat/cat.1 | 30 | ||||
-rw-r--r-- | bin/csh/csh.1 | 60 | ||||
-rw-r--r-- | bin/date/date.1 | 4 | ||||
-rw-r--r-- | bin/domainname/domainname.1 | 4 | ||||
-rw-r--r-- | bin/hostname/hostname.1 | 4 | ||||
-rw-r--r-- | bin/mkdir/mkdir.1 | 4 | ||||
-rw-r--r-- | bin/pax/pax.1 | 11 | ||||
-rw-r--r-- | bin/pwd/pwd.1 | 4 | ||||
-rw-r--r-- | bin/rmail/rmail.8 | 10 | ||||
-rw-r--r-- | bin/rmdir/rmdir.1 | 6 | ||||
-rw-r--r-- | bin/sh/sh.1 | 6 | ||||
-rw-r--r-- | bin/sleep/sleep.1 | 4 | ||||
-rw-r--r-- | bin/stty/stty.1 | 6 | ||||
-rw-r--r-- | bin/sync/sync.8 | 6 |
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 |