From e004acc89178ac4ee62d9181de312c4eb5f444c2 Mon Sep 17 00:00:00 2001 From: Philippe Charnier Date: Tue, 16 Apr 2002 20:08:06 +0000 Subject: [PATCH] Use `The .Nm utility' --- bin/df/df.1 | 4 +++- bin/domainname/domainname.1 | 5 +++-- bin/ed/ed.1 | 29 ++++++++++++++++++----------- bin/hostname/hostname.1 | 5 +++-- bin/mkdir/mkdir.1 | 5 +++-- bin/ps/ps.1 | 8 ++++++-- bin/pwd/pwd.1 | 5 +++-- bin/rcp/rcp.1 | 15 +++++++++------ bin/sh/bltin/echo.1 | 3 ++- 9 files changed, 50 insertions(+), 29 deletions(-) diff --git a/bin/df/df.1 b/bin/df/df.1 index fc2c3479ada8..7b73e3e5c53d 100644 --- a/bin/df/df.1 +++ b/bin/df/df.1 @@ -48,7 +48,9 @@ .Op Fl t Ar type .Op Ar file | filesystem ... .Sh DESCRIPTION -.Nm Df +The +.Nm +utility displays statistics about the amount of free disk space on the specified .Ar filesystem or on the filesystem of which diff --git a/bin/domainname/domainname.1 b/bin/domainname/domainname.1 index 5120165b3282..e67fcb39c3d8 100644 --- a/bin/domainname/domainname.1 +++ b/bin/domainname/domainname.1 @@ -42,8 +42,9 @@ .Nm .Op Ar ypdomain .Sh DESCRIPTION -.Nm Domainname -prints the name of the current YP/NIS domain. The super-user can +The +.Nm +utility 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 .Pa /etc/rc.network , diff --git a/bin/ed/ed.1 b/bin/ed/ed.1 index 12a4e5dcbe36..51759242cbfc 100644 --- a/bin/ed/ed.1 +++ b/bin/ed/ed.1 @@ -15,8 +15,9 @@ .\" .LP .\" red [-] [-sx] [-p \fIstring\fR] [\fIfile\fR] .Sh DESCRIPTION -.Nm Ed -is a line-oriented text editor. +The +.Nm +utility is a line-oriented text editor. It is used to create, display, modify and otherwise manipulate text files. .\" .B red @@ -147,8 +148,9 @@ only if it is not prefixed with a bang. .El .Sh LINE ADDRESSING An address represents the number of a line in the buffer. -.Nm Ed -maintains a +The +.Nm +utility maintains a .Em current address which is typically supplied to commands as the default address when none is specified. @@ -442,7 +444,9 @@ to print the last line affected by the command. An interrupt (typically ^C) has the effect of aborting the current command and returning the editor to command mode. .Pp -.Nm Ed +The +.Nm +utility recognizes the following commands. The commands are shown together with the default address or address range supplied if none is specified (in parenthesis). @@ -578,8 +582,9 @@ Print the addressed lines unambiguously. If a single line fills for than one screen (as might be the case when viewing a binary file, for instance), a `--More--' prompt is printed on the last line. -.Nm Ed -waits until the RETURN key is pressed +The +.Nm +utility waits until the RETURN key is pressed before displaying the next screen. The current address is set to the last line printed. @@ -804,8 +809,9 @@ If the first character of is `!', then it is replaced by text of the previous .Ar !command . -.Nm Ed -does not process +The +.Nm +utility does not process .Ar command for backslash (\\) escapes. However, an unescaped @@ -845,8 +851,9 @@ USD:12-13 .%D 1981 .Re .Sh LIMITATIONS -.Nm Ed -processes +The +.Nm +utility processes .Ar file arguments for backslash escapes, i.e., in a filename, any characters preceded by a backslash (\\) are diff --git a/bin/hostname/hostname.1 b/bin/hostname/hostname.1 index b83d5344a510..cb45cbe02814 100644 --- a/bin/hostname/hostname.1 +++ b/bin/hostname/hostname.1 @@ -43,8 +43,9 @@ .Op Fl s .Op Ar name-of-host .Sh DESCRIPTION -.Nm Hostname -prints the name of the current host. The super-user can +The +.Nm +utility 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 .Pa /etc/rc.network , diff --git a/bin/mkdir/mkdir.1 b/bin/mkdir/mkdir.1 index cf0fe7b0fe55..a425df9789a9 100644 --- a/bin/mkdir/mkdir.1 +++ b/bin/mkdir/mkdir.1 @@ -47,8 +47,9 @@ .Op Fl m Ar mode .Ar directory_name ... .Sh DESCRIPTION -.Nm Mkdir -creates the directories named as operands, in the order specified, +The +.Nm +utility creates the directories named as operands, in the order specified, using mode .Li rwxrwxrwx (\&0777) as modified by the current diff --git a/bin/ps/ps.1 b/bin/ps/ps.1 index 32402e710f90..359022336092 100644 --- a/bin/ps/ps.1 +++ b/bin/ps/ps.1 @@ -54,7 +54,9 @@ .Nm .Op Fl L .Sh DESCRIPTION -.Nm Ps +The +.Nm +utility displays a header line followed by lines containing information about your processes that have controlling terminals. This information is sorted by controlling terminal, then by process @@ -347,7 +349,9 @@ When printing using the command keyword, a process that has exited and has a parent that has not yet waited for the process (in other words, a zombie) is listed as ``'', and a process which is blocked while trying to exit is listed as ``''. -.Nm Ps +The +.Nm +utility makes an educated guess as to the file name and arguments given when the process was created by examining memory or the swap area. The method is inherently somewhat unreliable and in any event a process diff --git a/bin/pwd/pwd.1 b/bin/pwd/pwd.1 index 49390ad50473..f2ac73d50bbe 100644 --- a/bin/pwd/pwd.1 +++ b/bin/pwd/pwd.1 @@ -45,8 +45,9 @@ .Nm .Op Fl L | P .Sh DESCRIPTION -.Nm Pwd -writes the absolute pathname of the current working directory to +The +.Nm +utility writes the absolute pathname of the current working directory to the standard output. .Pp Some shells may provide a builtin diff --git a/bin/rcp/rcp.1 b/bin/rcp/rcp.1 index ce5c3e6134af..8eab25f83955 100644 --- a/bin/rcp/rcp.1 +++ b/bin/rcp/rcp.1 @@ -49,8 +49,9 @@ .Ar .Ar directory .Sh DESCRIPTION -.Nm Rcp -copies files between machines. Each +The +.Nm +utility copies files between machines. Each .Ar file or .Ar directory @@ -113,14 +114,16 @@ A on a remote host may be quoted (using \e, ", or \(aa) so that the metacharacters are interpreted remotely. .Pp -.Nm Rcp -does not prompt for passwords; it performs remote execution +The +.Nm +utility does not prompt for passwords; it performs remote execution via .Xr rsh 1 , and requires the same authorization. .Pp -.Nm Rcp -handles third party copies, where neither source nor target files +The +.Nm +utility handles third party copies, where neither source nor target files are on the current machine. .Sh FILES .Bl -tag -width /etc/auth.conf -compact diff --git a/bin/sh/bltin/echo.1 b/bin/sh/bltin/echo.1 index c7f093673851..742eaca28a7e 100644 --- a/bin/sh/bltin/echo.1 +++ b/bin/sh/bltin/echo.1 @@ -47,8 +47,9 @@ .Op Fl n | Fl e .Ar args... .Sh DESCRIPTION +The .Nm -prints its arguments on the standard output, separated by spaces. +utility prints its arguments on the standard output, separated by spaces. Unless the .Fl n option is present, a newline is output following the arguments.