Adjust 'after' so that it tries more rigorously to parse the input

[sgt/utils] / pid / pid.but

diff --git a/pid/pid.but b/pid/pid.but
index 1302a2d..c8075c9 100644 (file)
--- a/pid/pid.but
+++ b/pid/pid.but
@@ -10,8 +10,8 @@
 
 \U SYNOPSIS
 
-\c pid [ -a ] command [ arg... ]
-\e bbbb   bb  iiiiiii   iii
+\c pid [ options ] command [ arg... ]
+\e bbbb  iiiiiii   iiiiiii   iii
 
 \U DESCRIPTION
 
@@ -37,12 +37,12 @@ By default, \cw{pid} outputs exactly one process ID, or the word
 \cq{NONE} or \cq{MULTIPLE} if it finds no matching process or more
 than one. This is a mode suitable for use as an argument to
 \cw{strace} (which expects exactly one process ID after its \cw{-p}
-argument) or \cw{gdb} (which expects a single pid too); the \cq{NONE}
-or \cq{MULTIPLE} answers will provoke a command-line parsing error
-rather than trying to trace the wrong process or expanding to a less
-obviously wrong command line. Use the \cw{-a} option to instead make
-\cw{pid} output a full list of pids that match (e.g. if you want to
-pass them all to \cw{kill}(\e{1}).
+argument) or \cw{gdb} or \cw{after} (which expect a single pid as an
+argument); the \cq{NONE} or \cq{MULTIPLE} answers will provoke a
+command-line parsing error rather than trying to trace the wrong
+process or expanding to a less obviously wrong command line. Use the
+\cw{-a} option to instead make \cw{pid} output a full list of pids
+that match (e.g. if you want to pass them all to \cw{kill}(\e{1}).
 
 You can also provide arguments to the command you're searching for, to
 narrow your search further. For example, if you have several
@@ -58,6 +58,12 @@ its command line.
 \cq{MULTIPLE} if there is more than one. This also disables the
 behaviour of filtering out apparent forks of the same script.
 
+\dt \cw{-U}
+
+\dd Report pids belonging to any user. By default, \cw{pid} will only
+report processes owned by the same user as the one running it (except
+when root, when it defaults to reporting everybody's).
+
 \U BUGS
 
 \cw{pid} is currently completely specific to the Linux kernel, since