From owner-freebsd-doc@FreeBSD.ORG Thu Apr 30 21:41:25 2009 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 952B61065687; Thu, 30 Apr 2009 21:41:25 +0000 (UTC) (envelope-from jhb@freebsd.org) Received: from cyrus.watson.org (cyrus.watson.org [65.122.17.42]) by mx1.freebsd.org (Postfix) with ESMTP id 686398FC17; Thu, 30 Apr 2009 21:41:25 +0000 (UTC) (envelope-from jhb@freebsd.org) Received: from bigwig.baldwin.cx (66.111.2.69.static.nyinternet.net [66.111.2.69]) by cyrus.watson.org (Postfix) with ESMTPSA id 1DD7046B66; Thu, 30 Apr 2009 17:41:25 -0400 (EDT) Received: from jhbbsd.hudson-trading.com (unknown [209.249.190.8]) by bigwig.baldwin.cx (Postfix) with ESMTPA id ECABC8A021; Thu, 30 Apr 2009 17:41:23 -0400 (EDT) From: John Baldwin To: freebsd-doc@freebsd.org Date: Thu, 30 Apr 2009 13:41:48 -0400 User-Agent: KMail/1.9.7 References: <200904290015.n3T0Fl8s093619@www.freebsd.org> In-Reply-To: <200904290015.n3T0Fl8s093619@www.freebsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Content-Disposition: inline Message-Id: <200904301341.48920.jhb@freebsd.org> X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.0.1 (bigwig.baldwin.cx); Thu, 30 Apr 2009 17:41:24 -0400 (EDT) X-Virus-Scanned: clamav-milter 0.95 at bigwig.baldwin.cx X-Virus-Status: Clean X-Spam-Status: No, score=-1.1 required=4.2 tests=AWL,BAYES_00, DATE_IN_PAST_03_06,RDNS_NONE autolearn=no version=3.2.5 X-Spam-Checker-Version: SpamAssassin 3.2.5 (2008-06-10) on bigwig.baldwin.cx Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/134074: [patch] locking.9 man page slight enhancements 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, 30 Apr 2009 21:41:26 -0000 On Tuesday 28 April 2009 8:15:47 pm Haven Hash wrote: > > >Number: 134074 > >Category: docs > >Synopsis: [patch] locking.9 man page slight enhancements > >Confidential: no > >Severity: non-critical > >Priority: low > >Responsible: freebsd-doc > >State: open > >Quarter: > >Keywords: > >Date-Required: > >Class: doc-bug > >Submitter-Id: current-users > >Arrival-Date: Wed Apr 29 00:20:03 UTC 2009 > >Closed-Date: > >Last-Modified: > >Originator: Haven Hash > >Release: SVN rev 191642 > >Organization: > >Environment: > N/A > >Description: > While reading the locking (9) man page. I found a few slight things that could be improved so I did an svn checkout and made a few adjustments. > > 1. The order of Sleep/wakeup and Giant in the Description list is reversed from the order in which they are presented in the document. With no logic other than the Description list seemed to be a better ordering I reversed their order in the document. I haven't looked at this part. > 2. The link to the witness manual page at the bottom is in all capital letters and signifies chapter 9 of the manual. The witness manual page it seems is in chapter 4 of the manual and an all caps reference causes links on the www man page viewer to not find it (witness (4) is appropriately referenced earlier in the document). > > 3. Some slight grammatical additions were made to the explanations in the Usage Table. These parts of the patch are definitely correct. -- John Baldwin