From owner-freebsd-doc@FreeBSD.ORG  Sun Oct 10 00:09:03 2010
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 32A6B1065673
	for <freebsd-doc@freebsd.org>; Sun, 10 Oct 2010 00:09:03 +0000 (UTC)
	(envelope-from mvoorhis@cs.wpi.edu)
Received: from MAIL1.WPI.EDU (MAIL1.WPI.EDU [130.215.36.91])
	by mx1.freebsd.org (Postfix) with ESMTP id E9E778FC19
	for <freebsd-doc@freebsd.org>; Sun, 10 Oct 2010 00:09:02 +0000 (UTC)
Received: from SMTP.WPI.EDU (SMTP.WPI.EDU [130.215.36.186])
	by MAIL1.WPI.EDU (8.14.4/8.14.4) with ESMTP id o99NmVq6013004
	for <freebsd-doc@freebsd.org>; Sat, 9 Oct 2010 19:48:31 -0400
Received: from cs.wpi.edu (CS.WPI.EDU [130.215.28.181])
	by SMTP.WPI.EDU (8.14.4/8.14.4) with ESMTP id o99NmU6R006451
	for <freebsd-doc@freebsd.org>; Sat, 9 Oct 2010 19:48:31 -0400
	(envelope-from mvoorhis@cs.wpi.edu)
Received: from cs.wpi.edu (localhost [127.0.0.1])
	by cs.wpi.edu (8.14.3/8.14.3/SuSE Linux 0.8) with ESMTP id
	o99NmU78017966
	for <freebsd-doc@freebsd.org>; Sat, 9 Oct 2010 19:48:30 -0400
Received: (from mvoorhis@localhost)
	by cs.wpi.edu (8.14.3/8.14.3/Submit) id o99NmU53017965;
	Sat, 9 Oct 2010 19:48:30 -0400
Date: Sat, 9 Oct 2010 19:48:30 -0400
Message-Id: <201010092348.o99NmU53017965@cs.wpi.edu>
From: Michael C Voorhis <mvoorhis@cs.wpi.edu>
To: freebsd-doc@freebsd.org
Subject: Manpage for top(1) does not descripe "io" mode.
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 10 Oct 2010 00:09:03 -0000


Hi;

The manpage for top(1) doesn't describe the output provided by top's
"IO" mode, which is reached by running top and then pressing the "m"
key.

Reaching IO mode is described in the manpage, but the fields therein:

VCSW (voluntary context switches)
IVCSW (invulntary ....
READ 
WRITE
FAULT (page faults)
TOTAL (of what?)
PERCENT (of what?)

are described nowhere on the manpage.  The "cpu" mode appears to be
convered.  THere's even a special "FreeBSD" section at the bottom of
the manpage.

This stuff has to be described someplace (i.e., manpage for vmstat?).
A pointer to a different manpage would be better than nothing.

	Michael Voorhis (mvoorhis@cs.wpi.edu)
	Lab Manager, WPI Dept of Computer Science