From owner-freebsd-doc@FreeBSD.ORG Wed Dec 7 21:30:12 2011 Return-Path: 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 60C89106566B for ; Wed, 7 Dec 2011 21:30:12 +0000 (UTC) (envelope-from jkois@FreeBSD.org) Received: from tux15.hoststar.at (tux15.hoststar.at [213.239.217.242]) by mx1.freebsd.org (Postfix) with ESMTP id DE6B98FC14 for ; Wed, 7 Dec 2011 21:30:11 +0000 (UTC) Received: from freebsd.bsdkisten.at (chello084115173108.graz.surfer.at [84.115.173.108]) (authenticated bits=0) by tux15.hoststar.at (8.13.8/8.12.11) with ESMTP id pB7L9TRe029656; Wed, 7 Dec 2011 22:09:31 +0100 Message-ID: <4EDFD5FD.1010809@FreeBSD.org> Date: Wed, 07 Dec 2011 22:09:17 +0100 From: Johann Kois User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:8.0) Gecko/20111111 Thunderbird/8.0 MIME-Version: 1.0 To: Frank Leonhardt References: <4EDFCB27.3030803@fjl.co.uk> In-Reply-To: <4EDFCB27.3030803@fjl.co.uk> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org Subject: Re: 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 07 Dec 2011 21:30:12 -0000 Hello Frank, that sounds great. the correct procedure for that would be to create patches and send them in via send-pr. This way they will be registered in our "problem report database (GNATS) and won't get lost. A committer will then check them and (if they are fine) commit them. This way they will be included in the next release. For more information on how to create/send PR (problem reports) please read the article "Writing FreeBSD Problem Reports" under http://www.freebsd.org/doc/en/articles/problem-reports/index.html and maybe "Problem Report Handling Guidelines" for some technical information. Regards. Johann -- Johann Kois jkois(at)FreeBSD.org FreeBSD Documentation Project FreeBSD German Documentation Project - https://doc.bsdgroup.de "On 12/07/2011 21:23, Frank Leonhardt wrote: > 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. > > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" >