ps: Document -P option

The -P option for ps has been in there for decades but neither the
man page nor the help option explained what it did.

Amazing what crops up even now!

References:
 https://unix.stackexchange.com/questions/701422/what-does-p-mean-in-the-context-of-the-ps-command

diff --git a/ps/help.c b/ps/help.c
index e283c2cb22bbcbbfc4e8c5deded4e752bf729efa..b64833d37e59c5d05417f3a53ff4deec716ea25f 100644 (file)
--- a/ps/help.c
+++ b/ps/help.c
@@ -139,6 +139,7 @@ void do_help (const char *opt, int rc) {
     fputs(_("  O <format>          as -O, with BSD personality\n"), out);
     fputs(_(" -o, o, --format <format>\n"
             "                      user-defined format\n"), out);
+    fputs(_("  -P                  add psr column\n"), out);
     fputs(_("  s                   signal format\n"), out);
     fputs(_("  u                   user-oriented format\n"), out);
     fputs(_("  v                   virtual memory format\n"), out);

diff --git a/ps/ps.1 b/ps/ps.1
index 3031191abd239874f6377fed9dd0eb4031ff2f3e..9ca5a6c0c4a47568c00f27242da7a3a67e4ac425 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" "January 2022" "procps-ng" "User Commands"
+.TH PS "1" "2022-05-11" "procps-ng" "User Commands"
 .\"
 .\" To render this page:
 .\"    groff -t -b -man -X -P-resolution -P100 -Tps ps.1 &
@@ -539,6 +539,9 @@ options when in doubt.  Use the
 environment variable to specify a default as desired; DefSysV and DefBSD are
 macros that may be used to choose the default UNIX or BSD columns.
 .TP
+.B \-P
+Add a column showing \fBpsr\fR.
+.TP
 .B s
 Display signal format.
 .TP