docs/99631: [patch] document jid option in top(1)

[Cheng-Lung Sung]

>Number:         99631
>Category:       docs
>Synopsis:       [patch] document jid option in top(1)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jun 30 05:20:17 GMT 2006
>Closed-Date:
>Last-Modified:
>Originator:     Cheng-Lung Sung
>Release:        FreeBSD 6.1-STABLE i386
>Organization:
committer idling
>Environment:
System: FreeBSD going04.iis.sinica.edu.tw 6.1-STABLE FreeBSD 6.1-STABLE #20: Tue Jun 6 10:27:46 CST 2006 root at going04.iis.sinica.edu.tw:/usr/obj/usr/src/sys/GOING04 i386

>Description:
	document my jid patch for top(1). 
	ref: bin/98489
>How-To-Repeat:
	% man top
>Fix:

--- top.X.orig	Wed Jun 28 08:57:54 2006
+++ top.X	Fri Jun 30 13:15:10 2006
@@ -96,6 +96,11 @@
 Do not display idle processes.
 By default, top displays both active and idle processes.
 .TP
+.B \-j
+Display the
+.IR jail (8)
+id.
+.TP
 .B \-t
 Do not display the
 .I top
@@ -170,7 +175,8 @@
 The default for
 .I count
 on an intelligent terminal is, in fact,
-.BI infinity .
+.BI infinity
+.
 .PP
 The environment variable
 .B TOP
@@ -221,7 +227,8 @@
 .TP
 .B q
 Quit
-.IR top.
+.IR top
+.
 .TP
 .B d
 Change the number of displays to show (prompt for new number).
@@ -277,6 +284,11 @@
 .BR I )
 Toggle the display of idle processes.
 .TP
+.B j
+Toggle the display of
+.IR jail (8)
+id.
+.TP
 .B t
 Toggle the display of the
 .I top
@@ -302,8 +314,11 @@
 The remainder of the screen displays information about individual
 processes.  This display is similar in spirit to
 .IR ps (1)
-but it is not exactly the same.  PID is the process id, USERNAME is the name
-of the process's owner (if
+but it is not exactly the same.  PID is the process id, 
+JID, when displayed, is the 
+.IR jail (8)
+ID corresponding to the process,
+USERNAME is the name of the process's owner (if
 .B \-u
 is specified, a UID column will be substituted for USERNAME),
 PRI is the current priority of the process,


>Release-Note:
>Audit-Trail:
>Unformatted: