diff options
author | Mike Pechkin <mpech@cvs.openbsd.org> | 2002-02-11 18:43:53 +0000 |
---|---|---|
committer | Mike Pechkin <mpech@cvs.openbsd.org> | 2002-02-11 18:43:53 +0000 |
commit | 08be39f5bb2c3749f037ee6a116aec7656b0460b (patch) | |
tree | 94d8c274d8fb74b16780ae5b6e401c511d9f84d5 /bin | |
parent | 11661b37fd11040c9eb7ea938591fd8c371e7c9c (diff) |
Initial patch.
When you give command examples in a manual page prefix them with
$ command
or
# command
deraadt@ ok
Diffstat (limited to 'bin')
-rw-r--r-- | bin/cat/cat.1 | 8 | ||||
-rw-r--r-- | bin/chio/chio.1 | 6 | ||||
-rw-r--r-- | bin/chmod/chmod.1 | 22 | ||||
-rw-r--r-- | bin/cp/cp.1 | 8 | ||||
-rw-r--r-- | bin/date/date.1 | 4 | ||||
-rw-r--r-- | bin/dd/dd.1 | 4 | ||||
-rw-r--r-- | bin/df/df.1 | 4 | ||||
-rw-r--r-- | bin/kill/kill.1 | 6 | ||||
-rw-r--r-- | bin/ln/ln.1 | 8 | ||||
-rw-r--r-- | bin/ls/ls.1 | 8 | ||||
-rw-r--r-- | bin/mkdir/mkdir.1 | 8 | ||||
-rw-r--r-- | bin/mv/mv.1 | 11 | ||||
-rw-r--r-- | bin/pax/pax.1 | 16 | ||||
-rw-r--r-- | bin/ps/ps.1 | 4 | ||||
-rw-r--r-- | bin/rm/rm.1 | 9 | ||||
-rw-r--r-- | bin/rmdir/rmdir.1 | 6 |
16 files changed, 68 insertions, 64 deletions
diff --git a/bin/cat/cat.1 b/bin/cat/cat.1 index 962a591116a..0c9aaddb92e 100644 --- a/bin/cat/cat.1 +++ b/bin/cat/cat.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: cat.1,v 1.20 2000/10/18 06:55:06 aaron Exp $ +.\" $OpenBSD: cat.1,v 1.21 2002/02/11 18:43:50 mpech Exp $ .\" $NetBSD: cat.1,v 1.12 1995/09/27 05:38:55 cgd Exp $ .\" .\" Copyright (c) 1989, 1990, 1993 @@ -109,13 +109,13 @@ The .Nm utility exits 0 on success or >0 if an error occurred. .Sh EXAMPLES -.Cm cat file1 +.Cm $ cat file1 .Pp Print the contents of .Ar file1 to the standard output. .Pp -.Cm cat file1 file2 > file3 +.Cm $ cat file1 file2 > file3 .Pp Sequentially print the contents of .Ar file1 @@ -130,7 +130,7 @@ See the manual page for your shell (i.e., .Xr sh 1 ) for more information on redirection. .Pp -.Cm cat file1 - file2 - file3 +.Cm $ cat file1 - file2 - file3 .Pp Print the contents of .Ar file1 , diff --git a/bin/chio/chio.1 b/bin/chio/chio.1 index 6646e8124bd..31c408ced85 100644 --- a/bin/chio/chio.1 +++ b/bin/chio/chio.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chio.1,v 1.17 2001/08/26 17:51:29 deraadt Exp $ +.\" $OpenBSD: chio.1,v 1.18 2002/02/11 18:43:50 mpech Exp $ .\" $NetBSD: chio.1,v 1.1.1.1 1996/04/03 00:34:38 thorpej Exp $ .\" .\" Copyright (c) 1996 Jason R. Thorpe <thorpej@and.com> @@ -197,11 +197,11 @@ Element supports passing media (exporting) to an outside human operator. Element supports receiving media (importing) from an outside human operator. .El .Sh EXAMPLES -.Cm chio move slot 3 drive 0 +.Cm # chio move slot 3 drive 0 .Pp Moves the media in slot 3 (fourth slot) to drive 0 (first drive). .Pp -.Cm chio setpicker 2 +.Cm # chio setpicker 2 .Pp Configures the changer to use picker 2 (third picker) for operations. .Sh FILES diff --git a/bin/chmod/chmod.1 b/bin/chmod/chmod.1 index 5310f98d4fc..44d697271c0 100644 --- a/bin/chmod/chmod.1 +++ b/bin/chmod/chmod.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chmod.1,v 1.22 2001/02/15 19:18:13 aaron Exp $ +.\" $OpenBSD: chmod.1,v 1.23 2002/02/11 18:43:50 mpech Exp $ .\" $NetBSD: chmod.1,v 1.8 1995/03/21 09:02:07 cgd Exp $ .\" .\" Copyright (c) 1989, 1990, 1993, 1994 @@ -328,36 +328,38 @@ or .Sq t , are ignored. .Sh EXAMPLES -.Cm chmod 644 file +.Cm $ chmod 644 file .Pp Set file readable by anyone and writable by the owner only. .Pp -.Cm chmod go-w file +.Cm $ chmod go-w file .Pp Deny write permission to group and others. .Pp -.Cm chmod =rw,+X file +.Cm $ chmod =rw,+X file .Pp Set the read and write permissions to the usual defaults, but retain any execute permissions that are currently set. .Pp -.Cm chmod +X file +.Cm $ chmod +X file .Pp Make a directory or file searchable/executable by everyone if it is already searchable/executable by anyone. .Pp -.Cm chmod 755 file , -.Cm chmod u=rwx,go=rx file , -.Cm chmod u=rwx,go=u-w file +.Cm $ chmod 755 file +.br +.Cm $ chmod u=rwx,go=rx file +.br +.Cm $ chmod u=rwx,go=u-w file .Pp Any of these commands will make a file readable/executable by everyone and writable by the owner only. .Pp -.Cm chmod go= file +.Cm $ chmod go= file .Pp Clear all mode bits for group and others. .Pp -.Cm chmod g=u-w file +.Cm $ chmod g=u-w file .Pp Set the group bits equal to the user bits, but clear the group write bit. .Sh SEE ALSO diff --git a/bin/cp/cp.1 b/bin/cp/cp.1 index 8882bce56c8..2dfef10d4e1 100644 --- a/bin/cp/cp.1 +++ b/bin/cp/cp.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: cp.1,v 1.18 2000/11/10 13:03:00 aaron Exp $ +.\" $OpenBSD: cp.1,v 1.19 2002/02/11 18:43:50 mpech Exp $ .\" $NetBSD: cp.1,v 1.9 1995/07/25 19:36:45 jtc Exp $ .\" .\" Copyright (c) 1989, 1990, 1993, 1994 @@ -185,20 +185,20 @@ The .Nm utility exits 0 on success or >0 if an error occurred. .Sh EXAMPLES -.Cm cp foo bar +.Cm $ cp foo bar .Pp Make a copy of file .Pa foo named .Pa bar . .Pp -.Cm cp *.txt /tmp +.Cm $ cp *.txt /tmp .Pp Copy a group of files to the .Pa /tmp directory. .Pp -.Cm cp -R junk /tmp +.Cm $ cp -R junk /tmp .Pp Copy the directory .Pa junk diff --git a/bin/date/date.1 b/bin/date/date.1 index ff8f976345b..ba5cc29583d 100644 --- a/bin/date/date.1 +++ b/bin/date/date.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: date.1,v 1.32 2001/12/02 02:02:25 deraadt Exp $ +.\" $OpenBSD: date.1,v 1.33 2002/02/11 18:43:50 mpech Exp $ .\" $NetBSD: date.1,v 1.12 1996/03/12 04:32:37 phil Exp $ .\" .\" Copyright (c) 1980, 1990, 1993 @@ -156,7 +156,7 @@ Everything but the minute is optional. Time changes for Daylight Saving Time, standard time, leap seconds, and leap years are handled automatically. .Sh EXAMPLES -.Cm date \&"+DATE: %Y-%m-%d%nTIME: %H:%M:%S\&" +.Cm $ date \&"+DATE: %Y-%m-%d%nTIME: %H:%M:%S\&" .Pp Displays .Bd -literal -offset indent diff --git a/bin/dd/dd.1 b/bin/dd/dd.1 index 9f358137f7b..caa6c4a17b6 100644 --- a/bin/dd/dd.1 +++ b/bin/dd/dd.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: dd.1,v 1.11 2000/10/18 06:55:07 aaron Exp $ +.\" $OpenBSD: dd.1,v 1.12 2002/02/11 18:43:51 mpech Exp $ .\" $NetBSD: dd.1,v 1.5 1995/03/21 09:04:04 cgd Exp $ .\" .\" Copyright (c) 1990, 1993 @@ -342,7 +342,7 @@ The .Nm utility exits 0 on success or >0 if an error occurred. .Sh EXAMPLES -.Cm dd if=floppy28.fs of=/dev/fd0a +.Cm # dd if=floppy28.fs of=/dev/fd0a .Pp Write an .Ox diff --git a/bin/df/df.1 b/bin/df/df.1 index 43279728b7b..4b08f0140dd 100644 --- a/bin/df/df.1 +++ b/bin/df/df.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: df.1,v 1.26 2002/01/24 20:33:45 mickey Exp $ +.\" $OpenBSD: df.1,v 1.27 2002/02/11 18:43:51 mpech Exp $ .\" $NetBSD: df.1,v 1.12 1995/12/05 02:42:45 jtc Exp $ .\" .\" Copyright (c) 1989, 1990, 1993 @@ -115,7 +115,7 @@ the specified type, a warning is issued and no information is given on that file system. .El .Sh EXAMPLES -.Cm df -kP /usr +.Cm $ df -kP /usr .Pp Output, in a strict format suitable for portable scripts, disk space statistics for the diff --git a/bin/kill/kill.1 b/bin/kill/kill.1 index db32b0a6ffe..f63f0e655d0 100644 --- a/bin/kill/kill.1 +++ b/bin/kill/kill.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: kill.1,v 1.18 2002/01/24 21:37:41 mickey Exp $ +.\" $OpenBSD: kill.1,v 1.19 2002/02/11 18:43:51 mpech Exp $ .\" $NetBSD: kill.1,v 1.8 1995/09/07 06:30:26 jtc Exp $ .\" .\" Copyright (c) 1980, 1990, 1993 @@ -137,11 +137,11 @@ See .Xr csh 1 for details. .Sh EXAMPLES -.Cm kill -9 1234 +.Cm $ kill -9 1234 .Pp Forcibly terminate process ID 1234. .Pp -.Cm kill -HUP `cat /var/run/inetd.pid` +.Cm # kill -HUP `cat /var/run/inetd.pid` .Pp Send the .Xr inetd 8 diff --git a/bin/ln/ln.1 b/bin/ln/ln.1 index 3cbda6bf9e4..58533a4ada0 100644 --- a/bin/ln/ln.1 +++ b/bin/ln/ln.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ln.1,v 1.16 2002/01/24 20:33:45 mickey Exp $ +.\" $OpenBSD: ln.1,v 1.17 2002/02/11 18:43:51 mpech Exp $ .\" $NetBSD: ln.1,v 1.10 1995/07/25 19:37:04 jtc Exp $ .\" .\" Copyright (c) 1980, 1990, 1993 @@ -127,14 +127,14 @@ makes links in to all the named source files. The links made will have the same name as the files being linked to. .Sh EXAMPLES -.Cm ln -s /var/www /home/www +.Cm # ln -s /var/www /home/www .Pp Creates a symbolic link named .Pa /home/www and points it to .Pa /var/www . .Pp -.Cm ln /usr/local/bin/fooprog-1.0 /usr/local/bin/fooprog +.Cm # ln /usr/local/bin/fooprog-1.0 /usr/local/bin/fooprog .Pp Hard link .Pa /usr/local/bin/fooprog @@ -159,7 +159,7 @@ may be invoked from shell scripts, for example, using the .Cm "if [ ]" construct. .Pp -.Cm "mkdir bar baz; ln -s bar foo; ln -shf baz foo" +.Cm "$ mkdir bar baz; ln -s bar foo; ln -shf baz foo" .Pp The second call to .Nm diff --git a/bin/ls/ls.1 b/bin/ls/ls.1 index 7ffcacbd101..9e3e9bb194c 100644 --- a/bin/ls/ls.1 +++ b/bin/ls/ls.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ls.1,v 1.32 2002/01/24 20:33:45 mickey Exp $ +.\" $OpenBSD: ls.1,v 1.33 2002/02/11 18:43:51 mpech Exp $ .\" $NetBSD: ls.1,v 1.14 1995/12/05 02:44:01 jtc Exp $ .\" .\" Copyright (c) 1980, 1990, 1991, 1993, 1994 @@ -394,18 +394,18 @@ The .Nm utility exits 0 on success or >0 if an error occurred. .Sh EXAMPLES -.Cm ls -l +.Cm $ ls -l .Pp List the contents of the current working directory in long format. .Pp -.Cm ls -lioF +.Cm $ ls -lioF .Pp In addition to listing the contents of the current working directory in long format, show inode numbers, file flags (see .Xr chflags 1 ) , and suffix each filename with a symbol representing its file type. .Pp -.Cm ls -lt /var/log +.Cm $ ls -lt /var/log .Pp List the files in .Pa /var/log , diff --git a/bin/mkdir/mkdir.1 b/bin/mkdir/mkdir.1 index e1819ecd6f0..df6e01bf0bf 100644 --- a/bin/mkdir/mkdir.1 +++ b/bin/mkdir/mkdir.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mkdir.1,v 1.15 2000/11/09 17:51:56 aaron Exp $ +.\" $OpenBSD: mkdir.1,v 1.16 2002/02/11 18:43:51 mpech Exp $ .\" $NetBSD: mkdir.1,v 1.9 1995/07/25 19:37:13 jtc Exp $ .\" .\" Copyright (c) 1989, 1990, 1993 @@ -90,18 +90,18 @@ The .Nm utility exits 0 on success or >0 if an error occurred. .Sh EXAMPLES -.Cm mkdir foobar +.Cm $ mkdir foobar .Pp Create a directory named .Pa foobar . .Pp -.Cm mkdir -m 700 foobar +.Cm $ mkdir -m 700 foobar .Pp Create a directory named .Pa foobar and set its file mode to 700. .Pp -.Cm mkdir -p cow/horse/monkey +.Cm $ mkdir -p cow/horse/monkey .Pp Create a directory named .Pa cow/horse/monkey , diff --git a/bin/mv/mv.1 b/bin/mv/mv.1 index 3518c695e50..0953ab5af8d 100644 --- a/bin/mv/mv.1 +++ b/bin/mv/mv.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mv.1,v 1.14 2001/12/21 11:41:49 mpech Exp $ +.\" $OpenBSD: mv.1,v 1.15 2002/02/11 18:43:51 mpech Exp $ .\" $NetBSD: mv.1,v 1.8 1995/03/21 09:06:51 cgd Exp $ .\" .\" Copyright (c) 1989, 1990, 1993 @@ -116,7 +116,7 @@ and to accomplish the move. The effect is equivalent to: .Bd -literal -offset indent -rm -f destination_path && \e +$ rm -f destination_path && \e \tcp -pr source_file destination && \e \trm -rf source_file .Ed @@ -125,7 +125,7 @@ The .Nm utility exits 0 on success or >0 if an error occurred. .Sh EXAMPLES -.Cm mv -f foo bar +.Cm $ mv -f foo bar .Pp Rename file .Pa foo @@ -135,8 +135,9 @@ overwriting .Pa bar if it already exists. .Pp -.Cm mv -i -- -f bar , -.Cm mv -i ./-f bar +.Cm $ mv -i -- -f bar +.br +.Cm $ mv -i ./-f bar .Pp Either of these commands will rename the file .Pa -f diff --git a/bin/pax/pax.1 b/bin/pax/pax.1 index 786ae2e793a..335059c3cfa 100644 --- a/bin/pax/pax.1 +++ b/bin/pax/pax.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pax.1,v 1.30 2002/01/16 18:16:56 marc Exp $ +.\" $OpenBSD: pax.1,v 1.31 2002/02/11 18:43:51 mpech Exp $ .\" $NetBSD: pax.1,v 1.3 1995/03/21 09:07:37 cgd Exp $ .\" .\" Copyright (c) 1992 Keith Muller. @@ -1047,17 +1047,17 @@ options are specified along with the option, a file is not considered selected unless it is newer than the file to which it is compared. .Sh EXAMPLES -.Cm pax -w -f /dev/rst0 \&. +.Cm $ pax -w -f /dev/rst0 \&. .Pp Copies the contents of the current directory to the device .Pa /dev/rst0 . .Pp -.Cm pax -v -f filename +.Cm $ pax -v -f filename .Pp Gives the verbose table of contents for an archive stored in .Pa filename . .Pp -.Cm mkdir newdir ; +.Cm $ mkdir newdir ; .Cm cd olddir ; .Cm pax -rw \&. newdir .Pp @@ -1066,7 +1066,7 @@ This sequence of commands will copy the entire directory hierarchy to .Pa newdir . .Pp -.Cm pax -r -s ',^//*usr//*,,' -f a.pax +.Cm $ pax -r -s ',^//*usr//*,,' -f a.pax .Pp Reads the archive .Pa a.pax , @@ -1074,13 +1074,13 @@ with all files rooted in .Pa /usr into the archive extracted relative to the current directory. .Pp -.Cm pax -rw -i \&. dest_dir +.Cm $ pax -rw -i \&. dest_dir .Pp Can be used to interactively select the files to copy from the current directory to .Pa dest_dir . .Pp -.Cm pax -r -pe -U root -G bin -f a.pax +.Cm $ pax -r -pe -U root -G bin -f a.pax .Pp Extract all files from the archive .Pa a.pax @@ -1090,7 +1090,7 @@ with group .Em bin and preserve all file permissions. .Pp -.Cm "pax -r -w -v -Y -Z home /backup" +.Cm "$ pax -r -w -v -Y -Z home /backup" .Pp Update (and list) only those files in the destination directory .Pa /backup diff --git a/bin/ps/ps.1 b/bin/ps/ps.1 index 1301ff435f1..ab135e59768 100644 --- a/bin/ps/ps.1 +++ b/bin/ps/ps.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ps.1,v 1.32 2002/01/24 21:37:41 mickey Exp $ +.\" $OpenBSD: ps.1,v 1.33 2002/02/11 18:43:51 mpech Exp $ .\" $NetBSD: ps.1,v 1.16 1996/03/21 01:36:28 jtc Exp $ .\" .\" Copyright (c) 1980, 1990, 1991, 1993, 1994 @@ -513,7 +513,7 @@ wait channel (as a symbolic name) exit or stop status (valid only for stopped or zombie process) .El .Sh EXAMPLES -.Cm ps -auxw +.Cm $ ps -auxw .Pp Display information on all system processes. .Sh FILES diff --git a/bin/rm/rm.1 b/bin/rm/rm.1 index 6ef60dd6b05..40ca2feb5be 100644 --- a/bin/rm/rm.1 +++ b/bin/rm/rm.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rm.1,v 1.17 2002/01/24 19:21:39 mickey Exp $ +.\" $OpenBSD: rm.1,v 1.18 2002/02/11 18:43:51 mpech Exp $ .\" $NetBSD: rm.1,v 1.8 1995/07/25 19:37:30 jtc Exp $ .\" .\" Copyright (c) 1990, 1993, 1994 @@ -138,14 +138,15 @@ If an error occurs, .Nm exits with a value >0. .Sh EXAMPLES -.Cm rm -rf foobar +.Cm $ rm -rf foobar .Pp Recursively remove all files contained within the .Pa foobar directory hierarchy. .Pp -.Cm rm -- -f , -.Cm rm ./-f +.Cm $ rm -- -f +.br +.Cm $ rm ./-f .Pp Either of these commands will remove the file .Pa -f . diff --git a/bin/rmdir/rmdir.1 b/bin/rmdir/rmdir.1 index 542f7ea4d90..a0b49232255 100644 --- a/bin/rmdir/rmdir.1 +++ b/bin/rmdir/rmdir.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rmdir.1,v 1.12 2001/09/15 01:18:41 millert Exp $ +.\" $OpenBSD: rmdir.1,v 1.13 2002/02/11 18:43:51 mpech Exp $ .\" $NetBSD: rmdir.1,v 1.10 1995/07/25 19:37:35 jtc Exp $ .\" .\" Copyright (c) 1990, 1993 @@ -88,13 +88,13 @@ argument referred to an empty directory and was removed successfully. An error occurred. .El .Sh EXAMPLES -.Cm rmdir foobar +.Cm $ rmdir foobar .Pp Remove the directory .Pa foobar if it is empty. .Pp -.Cm rmdir -p cow/horse/monkey +.Cm $ rmdir -p cow/horse/monkey .Pp Remove all directories up to and including .Pa cow , |