From owner-freebsd-doc@FreeBSD.ORG  Sun Feb 10 20:00:07 2008
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 6A81716A417
	for <freebsd-doc@hub.freebsd.org>; Sun, 10 Feb 2008 20:00:07 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
	[IPv6:2001:4f8:fff6::28])
	by mx1.freebsd.org (Postfix) with ESMTP id 7141F13C45B
	for <freebsd-doc@hub.freebsd.org>; Sun, 10 Feb 2008 20:00:07 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.14.2/8.14.2) with ESMTP id m1AK07Ks038513
	for <freebsd-doc@freefall.freebsd.org>; Sun, 10 Feb 2008 20:00:07 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.14.2/8.14.1/Submit) id m1AK07F0038512;
	Sun, 10 Feb 2008 20:00:07 GMT (envelope-from gnats)
Date: Sun, 10 Feb 2008 20:00:07 GMT
Message-Id: <200802102000.m1AK07F0038512@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: Giorgos Keramidas <keramida@FreeBSD.org>
Cc: 
Subject: Re: docs/118332: man page for top does not describe STATE column
	wait events
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: Giorgos Keramidas <keramida@FreeBSD.org>
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 Feb 2008 20:00:07 -0000

The following reply was made to PR docs/118332; it has been noted by GNATS.

From: Giorgos Keramidas <keramida@freebsd.org>
To: Andrew Hammond <andrew.george.hammond@gmail.com>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/118332: man page for top does not describe STATE column
	wait events
Date: Sun, 10 Feb 2008 21:51:17 +0200

 On 2007-11-29 18:27, Andrew Hammond <andrew.george.hammond@gmail.com> wrote:
 > >Number:         118332
 > >Category:       docs
 > >Synopsis:       man page for top does not describe STATE column wait events
 
 > The manual page for top does not describe or provide a pointer to
 > descriptions of STATEs such as swread, nanslp, select, piperd, etc.
 
 The manpage describes `STATE' with the somewhat cryptic text:
 
     STATE is the current state (one of "START", "RUN" (shown as "CPUn"
     on SMP systems), "SLEEP", "STOP", "ZOMB", "WAIT", "LOCK" or the
     event on which the process waits),
 
 Any lowercase string is the name of a kernel-related event, and it would
 be a very daunting task to list them *all* in the manpage.  Do you think
 we can phrase this particular part of the manpage in a way that is more
 helpful?  If yes, we are open to suggestions.