docs: Update ps.1 to warn about command name length

Previous versions of ps used to only match on the first 15 characters
because that's what the kernel used to provide. Newer kernels have a
longer length for this field so procps has been updated to suit.

References:
 procps-ng/procps#101
 https://bugzilla.suse.com/show_bug.cgi?id=1099091

diff --git a/NEWS b/NEWS
index d4b15612bd43fbff5985894075598f359156acc2..201e7467f06dc815c990041d59502fd91ab3c630 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,6 +1,7 @@
 procps-ng-NEXT
 ----------------
   * docs: Use correct symbols for -h option in free.1      Debian #898774
+  * docs: ps.1 now warns about command name length         issue #101
   * top: can now exploit 256-color terminals               issue #96
   * top: preserves 'other filters' in configuration file   issue #99
   * top: can now collapse/expand forest view children      issue #99

diff --git a/ps/ps.1 b/ps/ps.1
index b358d2f185a0928944f2a82774135dce9293347e..844341c18c05775754ff59cbffaa39f2e04de95d 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-05-31 "procps-ng" "User Commands"
+.TH PS 1 2018-08-08 "procps-ng" "User Commands"
 .\"
 .\" To render this page:
 .\"    groff -t -b -man -X -P-resolution -P100 -Tps ps.1 &
@@ -236,6 +236,10 @@ Identical to
 Select by command name.  This selects the processes whose executable name is
 given in
 .IR cmdlist .
+NOTE: The command name is not the same as the command line. Previous versions
+of procps and the kernel truncated this command name to 15 characters. This
+limitation is no longer present in both. If you depended on matching only
+15 characters, you may no longer get a match.
 .TP
 .BI \-G \ grplist
 Select by real group ID (RGID) or name.  This selects the processes whose