From owner-freebsd-doc@FreeBSD.ORG  Wed Dec  7 20:35:22 2011
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 2D21D106566B
	for <freebsd-doc@freebsd.org>; Wed,  7 Dec 2011 20:35:22 +0000 (UTC)
	(envelope-from freebsd-doc@fjl.co.uk)
Received: from bs1.fjl.org.uk (bs1.fjl.org.uk [84.45.41.196])
	by mx1.freebsd.org (Postfix) with ESMTP id BD7B08FC08
	for <freebsd-doc@freebsd.org>; Wed,  7 Dec 2011 20:35:21 +0000 (UTC)
Received: from [192.168.1.31] (mux.fjl.org.uk [62.3.120.246])
	(authenticated bits=0)
	by bs1.fjl.org.uk (8.14.4/8.14.4) with ESMTP id pB7KMv2H041773
	(version=TLSv1/SSLv3 cipher=DHE-DSS-CAMELLIA256-SHA bits=256 verify=NO)
	for <freebsd-doc@freebsd.org>; Wed, 7 Dec 2011 20:22:57 GMT
	(envelope-from freebsd-doc@fjl.co.uk)
Message-ID: <4EDFCB27.3030803@fjl.co.uk>
Date: Wed, 07 Dec 2011 20:23:03 +0000
From: Frank Leonhardt <freebsd-doc@fjl.co.uk>
User-Agent: Mozilla/5.0 (Windows NT 5.1; rv:8.0) Gecko/20111105 Thunderbird/8.0
MIME-Version: 1.0
To: freebsd-doc@freebsd.org
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Subject: The state of some of the man pages
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: Wed, 07 Dec 2011 20:35:22 -0000

I've been moved to join this list because some of the man pages are 
driving me crazy; they're out of date.

Fortunately I speak fluent 'C', so I often end up diving into the source 
code in order to find out what's really going on. But I'm currently in 
the mood to do something more positive about it.

But how?

I'm not talking about fixing typos here; I'm referring to large chunks 
of information that are simply missing. For example, 'top' does so much 
more than the current documentation suggests.

If someone would be good enough to tell me how, I'm volunteering to 
update the man pages as I go.

For the avoidance of doubt, I don't want to know how to create a man 
page, I want to know how to submit updated man pages for eventual 
inclusion in the next release.

Thanks, Frank.