small ps(1) man page adjustment

[Alexander Best]

On Sat Oct  1 11, Glen Barber wrote:
> Hi Alex,
> 
> I can look later, unless someone else gets to it first.

thanks. ed reminded me that i need to make sure a sentence always ends with a
new line.

here's an updated patch.

cheers.
alex

> 
> Regards,
> 
> Glen
> 
> On 10/1/11 6:03 PM, Alexander Best wrote:
> > On Sat Oct  1 11, Alexander Best wrote:
> >> hi there,
> >>
> >> this small adjustment to the ps(1) man page sorts the fields being displayed
> >> by merely typing 'ps' correctly.
> > 
> > this patch cleans up the ps(1) man page some more:
> > 
> > O there's no reason the semantics of the -x flag are being explained in the
> >   -a flag description
> > 
> > O be more precise regarding the relation between the -a flag and the
> >   security.bsd.see_other_uids sysctl
> > 
> > O describe the format of the -t flag's argument
> > 
> > O 'con' no longer is a possible entry in the 'TT' column
> > 
> > O explain that the 'TT' column refers to pseudo-terminals via mere numbers
> > 
> > O add a hint in the 'tt' keyword description that a keyword 'tty' exists,
> >   which will give the full terminal pathname
> > 
> > cheers.
> > alex
> > 
> >>
> >> cheers.
> >> alex
> > 
> >> diff --git a/bin/ps/ps.1 b/bin/ps/ps.1
> >> index a66ed5d..8c27186 100644
> >> --- a/bin/ps/ps.1
> >> +++ b/bin/ps/ps.1
> >> @@ -90,8 +90,8 @@ and
> >>  .Fl o
> >>  options).
> >>  The default output format includes, for each process, the process' ID,
> >> -controlling terminal, CPU time (including both user and system time),
> >> -state, and associated command.
> >> +controlling terminal, state, CPU time (including both user and system time)
> >> +and associated command.
> >>  .Pp
> >>  The process file system (see
> >>  .Xr procfs 5 )
> > 
> 
> 
> -- 
> Glen Barber | gjb at FreeBSD.org
> FreeBSD Documentation Project
> 


-------------- next part --------------
diff --git a/bin/ps/ps.1 b/bin/ps/ps.1
index 8c27186..948ffad 100644
--- a/bin/ps/ps.1
+++ b/bin/ps/ps.1
@@ -29,7 +29,7 @@
 .\"     @(#)ps.1	8.3 (Berkeley) 4/18/94
 .\" $FreeBSD$
 .\"
-.Dd July 1, 2011
+.Dd October 1, 2011
 .Dt PS 1
 .Os
 .Sh NAME
@@ -53,7 +53,9 @@ The
 utility
 displays a header line, followed by lines containing information about
 all of your
-processes that have controlling terminals.
+processes that have controlling terminals, or, if the
+.Fl x
+options was specified, also processes that do not have controlling terminals.
 .Pp
 A different set of processes can be selected for display by using any
 combination of the
@@ -103,13 +105,9 @@ The options are as follows:
 .Bl -tag -width indent
 .It Fl a
 Display information about other users' processes as well as your own.
-This will skip any processes which do not have a controlling terminal,
-unless the
-.Fl x
-option is also specified.
-This can be disabled by setting the
+If the
 .Va security.bsd.see_other_uids
-sysctl to zero.
+sysctl is set to zero, this option is honored only if the UID of the user is 0.
 .It Fl c
 Change the
 .Dq command
@@ -216,6 +214,9 @@ with the standard input.
 .It Fl t
 Display information about processes attached to the specified terminal
 devices.
+Full pathnames, as well as abbreviations (see explanation of the
+.Cm tt
+keyword) can be specified.
 .It Fl U
 Display the processes belonging to the specified usernames.
 .It Fl u
@@ -427,12 +428,15 @@ The process is being traced or debugged.
 An abbreviation for the pathname of the controlling terminal, if any.
 The abbreviation consists of the three letters following
 .Pa /dev/tty ,
-or, for the console,
-.Dq Li con .
+or, for psuedo-terminals, the corresponding entry in
+.Pa /dev/pts .
 This is followed by a
 .Ql -
 if the process can no longer reach that
 controlling terminal (i.e., it has been revoked).
+The full pathname of the controlling terminal is available via the
+.Cm tty
+keyword.
 .It Cm wchan
 The event (an address in the system) on which a process waits.
 When printed numerically, the initial part of the address is