From nobody@FreeBSD.org  Sun Jan 17 22:52:23 2010
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 8E85A106566C
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 17 Jan 2010 22:52:23 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 645228FC08
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 17 Jan 2010 22:52:23 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o0HMqMCj025100
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 17 Jan 2010 22:52:22 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o0HMqMUj025099;
	Sun, 17 Jan 2010 22:52:22 GMT
	(envelope-from nobody)
Message-Id: <201001172252.o0HMqMUj025099@www.freebsd.org>
Date: Sun, 17 Jan 2010 22:52:22 GMT
From: vermaden <vermaden@interia.pl>
To: freebsd-gnats-submit@FreeBSD.org
Subject: top(1) man page does not include information about VCSW and IVCSW
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         142917
>Category:       docs
>Synopsis:       [patch] top(1) man page does not include information about VCSW and IVCSW
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    arundel
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jan 17 23:00:13 UTC 2010
>Closed-Date:    
>Last-Modified:  Mon Nov 21 20:27:53 UTC 2011
>Originator:     vermaden
>Release:        8.0-RELEASE
>Organization:
>Environment:
Stock 8.0-RELEASE output.
>Description:
top(1) man page does not include information about VCSW and IVCSW, which can be easily updated for example by by data from here:

http://lists.freebsd.org/pipermail/freebsd-questions/2007-September/158479.html
>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->arundel 
Responsible-Changed-By: arundel 
Responsible-Changed-When: Fri Jul 8 14:22:53 UTC 2011 
Responsible-Changed-Why:  
Over to me, since I'm working on this issue atm. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=142917 

From: Alexander Best <arundel@freebsd.org>
To: bug-followup@freebsd.org
Cc:  
Subject: Re: docs/142917: top(1) man page does not include information about VCSW and IVCSW
Date: Tue, 6 Sep 2011 21:38:04 +0000

 --VS++wcV0S1rZb1Fb
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 i'd like to suggest the following patch. comments regarding the description
 order and the wording are welcome.
 
 cheers.
 alex
 
 --VS++wcV0S1rZb1Fb
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="top.local.1.diff"
 
 diff --git a/usr.bin/top/top.local.1 b/usr.bin/top/top.local.1
 index 015b969..7aeba83 100644
 --- a/usr.bin/top/top.local.1
 +++ b/usr.bin/top/top.local.1
 @@ -50,3 +50,45 @@ bytes paged in from swap devices (last interval)
  .TP
  .B Out: 
  bytes paged out to swap devices (last interval)
 +.SH ORDERING KEYWORDS
 +.TP
 +.B jid:
 +Sort by
 +.IR jail (8)
 +ID.
 +.TP
 +.B threads:
 +Sort by number of threads per process
 +.TP
 +.B pri:
 +Sort by priority
 +.TP
 +.B size:
 +Sort by total size
 +.TP
 +.B res:
 +Sort by resident memory
 +.TP
 +.B cpu:
 +Sort by CPU
 +.TP
 +.B time:
 +Sort by system and user CPU seconds
 +.TP
 +.B total:
 +Sort by total io accesses per second
 +.TP
 +.B vcsw:
 +Sort by number of voluntary context switches per second
 +.TP
 +.B ivcsw:
 +Sort by number of involuntary context switches per second
 +.TP
 +.B read:
 +Sort by number of reads per second
 +.TP
 +.B write:
 +Sort by number of writes per seoncond
 +.TP
 +.B fault:
 +Sort by number of read/write defects per second
 
 --VS++wcV0S1rZb1Fb--
State-Changed-From-To: open->analyzed 
State-Changed-By: arundel 
State-Changed-When: Tue Sep 6 21:43:29 UTC 2011 
State-Changed-Why:  
The problem has been analysed and a patch was submitted. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=142917 

From: Alexander Best <arundel@freebsd.org>
To: bug-followup@freebsd.org
Cc:  
Subject: Re: docs/142917: [patch] top(1) man page does not include information about VCSW and IVCSW
Date: Wed, 7 Sep 2011 19:41:34 +0000

 --SUOF0GtieIMvvwua
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 here's a revised patch which. thanks go out to to jhb@ for his review of the
 previous patch.
 
 cheers.
 alex
 
 --SUOF0GtieIMvvwua
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="top.local.1.diff"
 
 diff --git a/usr.bin/top/top.local.1 b/usr.bin/top/top.local.1
 index 015b969..0a1a1e7 100644
 --- a/usr.bin/top/top.local.1
 +++ b/usr.bin/top/top.local.1
 @@ -50,3 +50,45 @@ bytes paged in from swap devices (last interval)
  .TP
  .B Out: 
  bytes paged out to swap devices (last interval)
 +.SH ORDERING KEYWORDS
 +.TP
 +.B jid:
 +Sort by
 +.IR jail (8)
 +ID.
 +.TP
 +.B threads:
 +Sort by number of threads per process
 +.TP
 +.B pri:
 +Sort by priority
 +.TP
 +.B size:
 +Sort by total virtual memory size
 +.TP
 +.B res:
 +Sort by resident memory
 +.TP
 +.B cpu:
 +Sort by CPU
 +.TP
 +.B time:
 +Sort by system and user CPU seconds
 +.TP
 +.B vcsw:
 +Sort by number of voluntary context switches per second
 +.TP
 +.B ivcsw:
 +Sort by number of involuntary context switches per second
 +.TP
 +.B read:
 +Sort by number of reads per second
 +.TP
 +.B write:
 +Sort by number of writes per seoncond
 +.TP
 +.B fault:
 +Sort by number of page faults per second
 +.TP
 +.B total:
 +Sort by total I/O operations per second
 
 --SUOF0GtieIMvvwua--
State-Changed-From-To: analyzed->open 
State-Changed-By: arundel 
State-Changed-When: Mon Nov 21 20:26:12 UTC 2011 
State-Changed-Why:  
Not really necessary to keep this problem report in the analyzed state, 
since the issues are obvious and don't need to be analyzed. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=142917 
>Unformatted:
