Subject: bin/13230: Query on BUGS in systat(1)
To: None <gnats-bugs@gnats.netbsd.org>
From: None <kre@munnari.OZ.AU>
List: netbsd-bugs
Date: 06/17/2001 20:19:05
>Number:         13230
>Category:       bin
>Synopsis:       odd wording in bugs section of systat(1)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bin-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sun Jun 17 06:17:01 PDT 2001
>Closed-Date:
>Last-Modified:
>Originator:     Robert Elz
>Release:        NetBSD-current 2001-06-17
>Organization:
	University of Melbourne
>Environment:
	
System: NetBSD kre.coe.psu.ac.th 1.5V NetBSD 1.5V (KRE) #3: Mon May 14 13:49:49 ICT 2001 kre@kre.coe.psu.ac.th:/usr/obj/sys/compile/KRE i386
Architecture: i386
Machine: i386
>Description:
	The BUGS section of systat(1) says ...

     Consumes CPU resources and thus may skew statistics.  Certain displays
     presume a minimum of 80 characters per line.  The vmstat display looks
     out of place because it is (it was added in as a separate display rather
     than created as a new program).

	Of the sentences there, the first is kind of obvious, and unavoidable
	and hence, not really a bug, just a fact - but that isn't what this
	send-pr is about.

	The second is a bug, but is too trivial to think about.

	The third sentence is correct, or its major part is, but the
	parenthetical comment is either badly written, or straight out
	wrong.

	The vmstat display started out life as a separate program, and
	was later merged into systat (which I don't think yet existed when
	the separate program was created).

	I'm not sure exactly what the BUGS comment is trying to say,
	but it doesn't suggest to me what I know to be the facts, so ...

>How-To-Repeat:
	RTFM.
	(I always wanted to say that in send-pr ...)
>Fix:
	Apply the following patch to usr.bin/systat/systat.1

--- systat.1.OLD	Tue May  8 04:10:26 2001
+++ systat.1	Sun Jun 17 20:16:44 2001
@@ -526,4 +526,4 @@
 The
 .Ic vmstat
 display looks out of place because it is (it was added in as
-a separate display rather than created as a new program).
+a separate display from what used to be a different program).
>Release-Note:
>Audit-Trail:
>Unformatted: