From owner-freebsd-doc@FreeBSD.ORG Thu Dec 8 02:59:29 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 459C51065672 for ; Thu, 8 Dec 2011 02:59:29 +0000 (UTC) (envelope-from linimon@lonesome.com) Received: from mail.soaustin.net (pancho.soaustin.net [76.74.250.40]) by mx1.freebsd.org (Postfix) with ESMTP id 283438FC08 for ; Thu, 8 Dec 2011 02:59:29 +0000 (UTC) Received: by mail.soaustin.net (Postfix, from userid 502) id 02CDB5615E; Wed, 7 Dec 2011 20:41:04 -0600 (CST) Date: Wed, 7 Dec 2011 20:41:04 -0600 From: Mark Linimon To: Frank Leonhardt Message-ID: <20111208024103.GB24418@lonesome.com> References: <4EDFCB27.3030803@fjl.co.uk> <4EDFD794.3070102@FreeBSD.org> <4EDFE647.4080701@fjl.co.uk> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4EDFE647.4080701@fjl.co.uk> User-Agent: Mutt/1.5.20 (2009-06-14) 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: Thu, 08 Dec 2011 02:59:29 -0000 On Wed, Dec 07, 2011 at 10:18:47PM +0000, Frank Leonhardt wrote: > I dare say that some of these are listed as problem reports already. FreeBSD does indeed have a backlog. To some extent this is because it's more fun to create new things than to fix bugs. But you can browse the existing PRs: http://www.freebsd.org/cgi/query-pr-summary.cgi?query resulting in e.g.: http://www.freebsd.org/cgi/query-pr-summary.cgi?category=docs It's sorted old-to-new, so starting at the bottom is probably better. Note the ones in green have already been committed, and are awaiting merge to all useful FreeBSD branches. (In some cases this has already been done.) If you want to see a prototype of another way of looking at the above but classified by manpage reference: http://people.freebsd.org/~linimon/studies/prs/pr_manpage_index.html It uses some grep magic over the Synopses in the docs PRs, so it is probably missing some. As PRs come in we try to canonicalize the Synopses but we miss some. We're always looking for fresh energy to help work on the FreeBSD documentation (as well as many other areas). Don't be daunted by the fact that there is a backlog -- just look at it as an opportunity to be able to have a big impact :-) mcl