]> granicus.if.org Git - procps-ng/commitdiff
docs: some manpage fixes
authorCraig Small <csmall@dropbear.xyz>
Thu, 4 Jun 2020 12:25:26 +0000 (22:25 +1000)
committerCraig Small <csmall@dropbear.xyz>
Thu, 4 Jun 2020 12:33:16 +0000 (22:33 +1000)
Some editorial changes so the man pages follow the standards.

References:
 procps#173

12 files changed:
pgrep.1
pidof.1
pmap.1
ps/ps.1
pwdx.1
slabtop.1
sysctl.8
sysctl.conf.5
tload.1
vmstat.8
w.1
watch.1

diff --git a/pgrep.1 b/pgrep.1
index 6dc4081d1e6eba1bc0cf49522cdd42210816bdd2..01e0d2e884a53075d343f3af700407cd579fb876 100644 (file)
--- a/pgrep.1
+++ b/pgrep.1
@@ -1,13 +1,13 @@
 .\"
 .\" Copyright 2000 Kjetil Torgrim Homme
-.\"           2017 Craig Small
+.\"           2017-2020 Craig Small
 .\"
 .\" This program is free software; you can redistribute it and/or modify
 .\" it under the terms of the GNU General Public License as published by
 .\" the Free Software Foundation; either version 2 of the License, or
 .\" (at your option) any later version.
 .\"
-.TH PGREP "1" "2020-05-17" "procps-ng" "User Commands"
+.TH PGREP "1" "2020-06-04" "procps-ng" "User Commands"
 .SH NAME
 pgrep, pkill \- look up or signal processes based on name and other attributes
 .SH SYNOPSIS
@@ -141,29 +141,27 @@ context.  In
 context this option is disabled.
 .TP
 \fB\-x\fR, \fB\-\-exact\fR\fR
-Only match processes whose names (or command line if \-f is specified)
+Only match processes whose names (or command lines if \fB\-f\fR is specified)
 .B exactly
 match the
 .IR pattern .
 .TP
 \fB\-F\fR, \fB\-\-pidfile\fR \fIfile\fR
-Read
-.IR PID 's
-from file.  This option is perhaps more useful for
+Read \fIPID\fRs from \fIfile\fR.  This option is perhaps more useful for
 .B pkill
 than
 .BR pgrep .
 .TP
 \fB\-L\fR, \fB\-\-logpidfile\fR
-Fail if pidfile (see -F) not locked.
+Fail if pidfile (see \fB\-F\fR) not locked.
 .TP
 \fB\-r\fR, \fB\-\-runstates\fR \fID,R,S,Z,\fP...
 Match only processes which match the process state.
 .TP
 \fB\-\-ns \fIpid\fP
 Match processes that belong to the same namespaces. Required to run as
-root to match processes from other users. See \-\-nslist for how to limit
-which namespaces to match.
+root to match processes from other users. See \fB\-\-nslist\fR for how to
+limit which namespaces to match.
 .TP
 \fB\-\-nslist \fIname\fP,...
 Match only the provided namespaces. Available namespaces:
@@ -234,7 +232,7 @@ Fatal error: out of memory etc.
 .PD
 .SH NOTES
 The process name used for matching is limited to the 15 characters present in
-the output of /proc/\fIpid\fP/stat.  Use the \-f option to match against the
+the output of /proc/\fIpid\fP/stat.  Use the \fB\-f\fR option to match against the
 complete command line, /proc/\fIpid\fP/cmdline. Threads may not have the
 same process name as the parent process but will have the same command line.
 .PP
diff --git a/pidof.1 b/pidof.1
index 8ef4abfbb197c7a7e507b2979e3f8248194083e0..5e0c9938fbd934bd2e50fd12e197c37b89e268b9 100644 (file)
--- a/pidof.1
+++ b/pidof.1
 .\" along with this program; if not, write to the Free Software
 .\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 .\"
-.TH PIDOF 1 "2019-09-21" "" "User Commands"
+.TH PIDOF 1 "2020-06-04" "" "User Commands"
 .SH NAME
-pidof -- find the process ID of a running program.
+pidof -- find the process ID of a running program
 .SH SYNOPSIS
 .B pidof
 .RB [ \-s ]
 .RB [ \-c ]
 .RB [ \-x ]
 .RB [ \-o
-.IR omitpid[,omitpid..] ]
+.IR omitpid[,omitpid...] ]
 .RB [ \-o
-.IR omitpid[,omitpid..].. ]
+.IR omitpid[,omitpid...]... ]
 .RB [ \-S
 .IR separator ]
 .B program
-.RB [ program.. ]
+.RB [ program... ]
 .SH DESCRIPTION
 .B Pidof
 finds the process id's (pids) of the named programs. It prints those
@@ -52,7 +52,8 @@ program, in other words the calling shell or shell script.
 .IP "-S \fIseparator\fP"
 Use \fIseparator\fP as a separator put between pids. Used only when
 more than one pids are printed for the program.
-The \fI\-d\fR option is an alias for this option for sysvinit pidof
+The \fB\-d\fR option is an alias for this option for sysvinit
+.B pidof
 compatibility.
 .SH "EXIT STATUS"
 .TP
diff --git a/pmap.1 b/pmap.1
index 78cb50d7a715bd4f4231161a3488bcbf4d583756..90035ff57b12ba82982c9e0094d372f507402627 100644 (file)
--- a/pmap.1
+++ b/pmap.1
@@ -5,14 +5,16 @@
 .\" Licensed under version 2 of the GNU General Public License.
 .\" Written by Albert Cahalan.
 .\"
-.TH PMAP "1" "September 2012" "procps-ng" "User Commands"
+.TH PMAP "1" "2020-06-04" "procps-ng" "User Commands"
 .SH NAME
 pmap \- report memory map of a process
 .SH SYNOPSIS
 .B pmap
 [\fIoptions\fR] \fIpid\fR [...]
 .SH DESCRIPTION
-The pmap command reports the memory map of a process or processes.
+The
+.B pmap
+command reports the memory map of a process or processes.
 .SH OPTIONS
 .TP
 \fB\-x\fR, \fB\-\-extended\fR
@@ -78,7 +80,9 @@ Did not find all processes asked for.
 .BR ps (1),
 .BR pgrep (1)
 .SH STANDARDS
-No standards apply, but pmap looks an awful lot like a SunOS command.
+No standards apply, but
+.B pmap
+looks an awful lot like a SunOS command.
 .SH "REPORTING BUGS"
 Please send bug reports to
 .UR procps@freelists.org
diff --git a/ps/ps.1 b/ps/ps.1
index 1dbcbf281edeb736123068391e08c4e3388d27a8..df307e6b043e54dbf026c263087609d67bdb5818 100644 (file)
--- a/ps/ps.1
+++ b/ps/ps.1
@@ -4,7 +4,7 @@
 .\" Quick hack conversion by Albert Cahalan, 1998.
 .\" Licensed under version 2 of the Gnu General Public License.
 .\"
-.TH PS 1 2018-08-08 "procps-ng" "User Commands"
+.TH PS "1" "2020-06-04" "procps-ng" "User Commands"
 .\"
 .\" To render this page:
 .\"    groff -t -b -man -X -P-resolution -P100 -Tps ps.1 &
@@ -34,7 +34,7 @@ ps \- report a snapshot of the current processes.
 .B ps
 displays information about a selection of the active processes.  If you want
 a repetitive update of the selection and the displayed information, use
-.IR top (1)
+.B top
 instead.
 .P
 This version of
@@ -58,14 +58,14 @@ implementations that this
 .B ps
 is compatible with.
 .P
-Note that "\fBps \-aux\fR" is distinct from "\fBps\ aux\fR".  The POSIX and
-UNIX standards require that "\fBps\ \-aux\fR" print all processes owned by a
-user named "x", as well as printing all processes that would be selected by
+Note that \fBps \-aux\fR is distinct from \fBps\ aux\fR.  The POSIX and
+UNIX standards require that \fBps\ \-aux\fR print all processes owned by a
+user named \fIx\fR, as well as printing all processes that would be selected by
 the
 .B \-a
-option.  If the user named "x" does not exist, this
+option.  If the user named \fIx\fR does not exist, this
 .B ps
-may interpret the command as "\fBps\ aux\fR" instead and print a warning.
+may interpret the command as \fBps\ aux\fR instead and print a warning.
 This behavior is intended to aid in transitioning old scripts and habits.  It
 is fragile, subject to change, and thus should not be relied upon.
 .P
@@ -740,14 +740,15 @@ Show threads, possibly with SPID column.
 .SH "OTHER INFORMATION"
 .TP
 .BI \-\-help \ section
-Print a help message.  The section argument can be one of
-\fIs\fRimple,
-\fIl\fRist,
-\fIo\fRutput,
-\fIt\fRhreads,
-\fIm\fRisc or
-\fIa\fRll.
-The argument can be shortened to one of the underlined letters as in: s|l|o|t|m|a.
+Print a help message.  The \fIsection\fR argument can be one of
+.IR s imple,
+.IR l ist,
+.IR o utput,
+.IR t hreads,
+.IR m "isc, or"
+.IR a ll.
+The argument can be shortened to one of the underlined letters as in:
+s\^|\^l\^|\^o\^|\^t\^|\^m\^|\^a.
 .TP
 .B \-\-info
 Print debugging info.
@@ -795,18 +796,18 @@ will be destroyed by
 if the parent process exits.
 .PP
 If the length of the username is greater than the length of the display
-column, the username will be truncated. See the -o and -O formatting
-options to customize length.
+column, the username will be truncated.  See the \fB\-o\fR and \fB\-O\fR
+formatting options to customize length.
 .PP
 Commands options such as
 .B ps \-aux
 are not recommended as it is a confusion of two different standards.
 According to the POSIX and UNIX standards, the above command asks to
 display all processes with a TTY (generally the commands users are
-running) plus all processes owned by a user named "x".  If that user
+running) plus all processes owned by a user named \fIx\fR.  If that user
 doesn't exist, then
 .B ps
-will assume you really meant "\fBps\fR \fIaux\fR".
+will assume you really meant \fBps aux\fR.
 .SH "PROCESS FLAGS"
 The sum of these values is displayed in the "F" column,
 which is provided by the
@@ -1157,8 +1158,8 @@ fully destroyed by its parent.  The output in this column may contain spaces.
 (alias
 .BR ucmd , \ ucomm ).
 See also the
-.B args format keyword,
-the
+.B args
+format keyword, the
 .B \-f
 option, and the
 .B c
@@ -1326,7 +1327,9 @@ format is displayed.  (alias
 T}
 
 ipcns  IPCNS   T{
-Unique inode number describing the namespace the process belongs to. See namespaces(7).
+Unique inode number describing the namespace the process belongs to.
+See
+.IR namespaces (7).
 T}
 
 label  LABEL   T{
@@ -1377,11 +1380,15 @@ The number of minor page faults that have occurred with this process.
 T}
 
 mntns  MNTNS   T{
-Unique inode number describing the namespace the process belongs to. See namespaces(7).
+Unique inode number describing the namespace the process belongs to.
+See
+.IR namespaces (7).
 T}
 
 netns  NETNS   T{
-Unique inode number describing the namespace the process belongs to. See namespaces(7).
+Unique inode number describing the namespace the process belongs to.
+See
+.IR namespaces (7).
 T}
 
 ni     NI      T{
@@ -1405,7 +1412,7 @@ T}
 
 numa   NUMA    T{
 The node assocated with the most recently used processor.
-A -1 means that NUMA information is unavailable.
+A \fI\-1\fR means that NUMA information is unavailable.
 T}
 
 nwchan WCHAN   T{
@@ -1458,7 +1465,9 @@ a number representing the process ID (alias
 T}
 
 pidns  PIDNS   T{
-Unique inode number describing the namespace the process belongs to. See namespaces(7).
+Unique inode number describing the namespace the process belongs to.
+See
+.IR namespaces (7).
 T}
 
 pmem   %MEM    T{
@@ -1817,11 +1826,15 @@ see
 T}
 
 userns USERNS  T{
-Unique inode number describing the namespace the process belongs to. See namespaces(7).
+Unique inode number describing the namespace the process belongs to.
+See
+.IR namespaces (7).
 T}
 
 utsns  UTSNS   T{
-Unique inode number describing the namespace the process belongs to. See namespaces(7).
+Unique inode number describing the namespace the process belongs to.
+See
+.IR namespaces (7).
 T}
 
 uunit  UUNIT   T{
diff --git a/pwdx.1 b/pwdx.1
index 627040bf4b7a26fe63bf9e1afd1eabd4bc913829..ec83b56e899d9263f5dd1ad0e656d32fbc874ce4 100644 (file)
--- a/pwdx.1
+++ b/pwdx.1
@@ -3,7 +3,7 @@
 .\" Copyright 2004 Nicholas Miell.
 .\" Based on the pmap(1) man page by Albert Cahalan.
 .\"
-.TH PWDX "1" "June 2011" "procps-ng" "User Commands"
+.TH PWDX "1" "2020-06-04" "procps-ng" "User Commands"
 .SH NAME
 pwdx \- report current working directory of a process
 .SH SYNOPSIS
@@ -20,7 +20,9 @@ Output help screen and exit.
 .BR ps (1),
 .BR pgrep (1)
 .SH STANDARDS
-No standards apply, but pwdx looks an awful lot like a SunOS command.
+No standards apply, but
+.B pwdx
+looks an awful lot like a SunOS command.
 .SH AUTHOR
 .UR nmiell@gmail.com
 Nicholas Miell
index 47d6f834e8aeb972c35c94f5c3d081a05e08cead..2c403ffee7e7db9b1e6bc32b7598350745ff8176 100644 (file)
--- a/slabtop.1
+++ b/slabtop.1
@@ -43,8 +43,9 @@ The following are valid sort criteria used to sort the individual slab caches
 and thereby determine what are the "top" slab caches to display.  The default
 sort criteria is to sort by the number of objects ("o").
 .PP
-The sort criteria can also be changed while slabtop is running by pressing
-the associated character.
+The sort criteria can also be changed while
+.B slabtop
+is running by pressing the associated character.
 .TS
 l l l.
 \fBcharacter   description     header\fR
@@ -89,7 +90,9 @@ requires a 2.4 or later kernel (specifically, a version 1.1 or later
 .IR /proc/slabinfo ).
 Kernel 2.2 should be supported in the future.
 .PP
-The slabtop statistic header is tracking how many bytes of slabs are being
+The
+.B slabtop
+statistic header is tracking how many bytes of slabs are being
 used and is not a measure of physical memory.  The 'Slab' field in the
 /proc/meminfo file is tracking information about used slab physical memory.
 .SH AUTHORS
index d65f22c2ef585308ac8dd7f9c3976014829b9923..c872c4e1aaa0f6d65eaab49cbf0debaa2d33fccf 100644 (file)
--- a/sysctl.8
+++ b/sysctl.8
@@ -144,7 +144,9 @@ The
 .B base_reachable_time
 and
 .B retrans_time
-are deprecated.  The sysctl command does not allow changing values of these
+are deprecated.  The
+.B sysctl
+command does not allow changing values of these
 parameters.  Users who insist to use deprecated kernel interfaces should push values
 to /proc file system by other means.  For example:
 .PP
index 476c8514dfd2b100dc452e39ff720bb30be5ab8f..f16597c541017e0737c2ddd5be63196c0ea958a6 100644 (file)
@@ -6,7 +6,7 @@
 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 .\" GNU General Public License for more details."
-.TH SYSCTL.CONF "5" "2020-02-27" "procps-ng" "File Formats"
+.TH SYSCTL.CONF "5" "2020-06-04" "procps-ng" "File Formats"
 .SH NAME
 sysctl.conf \- sysctl preload/configuration file
 .SH DESCRIPTION
@@ -27,7 +27,7 @@ token = value
 .PP
 Note that blank lines are ignored, and whitespace before and after a token or
 value is ignored, although a value can contain whitespace within.  Lines which
-begin with a # or ; are considered comments and ignored.
+begin with a \fI#\fR or \fI;\fR are considered comments and ignored.
 
 If a line begins with a single \-, any attempts to set the value that fail will be
 ignored.
diff --git a/tload.1 b/tload.1
index c17e05f4d47be879a66ce297eadd731bc9b50bc9..7773498739b5f5593cddbe7893f96fe279e5e7d1 100644 (file)
--- a/tload.1
+++ b/tload.1
@@ -1,7 +1,7 @@
 .\"             -*-Nroff-*-
 .\"  This page Copyright (C) 1993 Matt Welsh, mdw@tc.cornell.edu.
 .\"  Freely distributable under the terms of the GPL
-.TH TLOAD "1" "June 2011" "procps-ng" "User Commands"
+.TH TLOAD "1" "2020-06-04" "procps-ng" "User Commands"
 .SH NAME
 tload \- graphic representation of system load average
 .SH SYNOPSIS
@@ -11,7 +11,9 @@ tload \- graphic representation of system load average
 .B tload
 prints a graph of the current system load average to the specified
 .I tty
-(or the tty of the tload process if none is specified).
+(or the tty of the
+.B tload
+process if none is specified).
 .SH OPTIONS
 .TP
 \fB\-s\fR, \fB\-\-scale\fR \fInumber\fR
index 420d9f394b373828cf0d805ae11d848f745d8717..acf437e5646d77f6c9c7754677c599c2f500a97a 100644 (file)
--- a/vmstat.8
+++ b/vmstat.8
@@ -1,6 +1,6 @@
 .\"  This page Copyright (C) 1994 Henry Ware <al172@yfn.ysu.edu>
 .\"  Distributed under the GPL, Copyleft 1994.
-.TH VMSTAT 8 "September 2011" "procps-ng" "System Administration"
+.TH VMSTAT 8 "2020-06-04" "procps-ng" "System Administration"
 .SH NAME
 vmstat \- Report virtual memory statistics
 .SH SYNOPSIS
@@ -98,17 +98,19 @@ b: The number of processes in uninterruptible sleep.
 .PP
 .SS
 .B "Memory"
+These are affected by the \fB\-\-unit\fR option.
 .nf
 swpd: the amount of virtual memory used.
 free: the amount of idle memory.
 buff: the amount of memory used as buffers.
 cache: the amount of memory used as cache.
-inact: the amount of inactive memory.  (\-a option)
-active: the amount of active memory.  (\-a option)
+inact: the amount of inactive memory.  (\fB\-a\fR option)
+active: the amount of active memory.  (\fB\-a\fR option)
 .fi
 .PP
 .SS
 .B "Swap"
+These are affected by the \fB\-\-unit\fR option.
 .nf
 si: Amount of memory swapped in from disk (/s).
 so: Amount of memory swapped to disk (/s).
@@ -182,7 +184,7 @@ size: Size of each object
 pages: Number of pages with at least one active object
 .fi
 .SH NOTES
-.B "vmstat "
+.B vmstat
 does not require special permissions.
 .PP
 These reports are intended to help identify system bottlenecks.  Linux
diff --git a/w.1 b/w.1
index a4a73ef18d89ec0440140409eb758446d129936d..15a94dc176fb7930ce1ac90021c4aaea85fd97b8 100644 (file)
--- a/w.1
+++ b/w.1
@@ -1,6 +1,6 @@
 .\"             -*-Nroff-*-
 .\"
-.TH W "1" "September 2015" "procps-ng" "User Commands"
+.TH W "1" "2020-06-04" "procps-ng" "User Commands"
 .SH NAME
 w \- Show who is logged on and what they are doing.
 .SH SYNOPSIS
@@ -30,8 +30,12 @@ Don't print the header.
 .TP
 \fB\-u\fR, \fB\-\-no\-current\fR
 Ignores the username while figuring out the
-current process and cpu times.  To demonstrate this, do a "su" and do a "w"
-and a "w \-u".
+current process and cpu times.  To demonstrate this, do a
+.B su
+and do a
+.B w
+and a
+.BR "w \-u".
 .TP
 \fB\-s\fR, \fB\-\-short\fR
 Use the short format.  Don't print the login time, JCPU or PCPU times.
diff --git a/watch.1 b/watch.1
index 11b794a10cad88fb34e2c7af429d18fa7264177c..256c36b7f779eecf7d16587fdf18dd49a11b5247 100644 (file)
--- a/watch.1
+++ b/watch.1
@@ -1,4 +1,4 @@
-.TH WATCH 1 "2020-05-12" "procps-ng" "User Commands"
+.TH WATCH 1 "2020-06-04" "procps-ng" "User Commands"
 .SH NAME
 watch \- execute a program periodically, showing output fullscreen
 .SH SYNOPSIS
@@ -13,10 +13,11 @@ allows you to watch the program output change over time.  By default,
 \fIcommand\fR is run every 2 seconds and \fBwatch\fR will run until interrupted.
 .SH OPTIONS
 .TP
-\fB\-d\fR, \fB\-\-differences\fR [\fIpermanent\fR]
-Highlight the differences between successive updates.  Option will read
-optional argument that changes highlight to be permanent, allowing to see what
-has changed at least once since first iteration.
+.BR \-d ", " \-\-differences [ =permanent ]
+Highlight the differences between successive updates. If the optional
+\fB=permanent\fR argument is specified then
+.B watch
+will show all changes since the first iteration.
 .TP
 \fB\-n\fR, \fB\-\-interval\fR \fIseconds\fR
 Specify update interval.  The command will not allow quicker than 0.1 second
@@ -124,7 +125,7 @@ next scheduled update.  All
 .B \-\-differences
 highlighting is lost on that update as well.
 
-Non-printing characters are stripped from program output.  Use "cat -v" as
+Non-printing characters are stripped from program output.  Use \fBcat -v\fR as
 part of the command pipeline if you want to see them.
 
 Combining Characters that are supposed to display on the character at the