From owner-freebsd-doc@FreeBSD.ORG Thu Apr 30 21:50:04 2009 Return-Path: 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 DE8331065670 for ; Thu, 30 Apr 2009 21:50:02 +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 CD4338FC14 for ; Thu, 30 Apr 2009 21:50:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id n3ULo2kH001686 for ; Thu, 30 Apr 2009 21:50:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id n3ULo2Uo001679; Thu, 30 Apr 2009 21:50:02 GMT (envelope-from gnats) Date: Thu, 30 Apr 2009 21:50:02 GMT Message-Id: <200904302150.n3ULo2Uo001679@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: John Baldwin Cc: 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 Reply-To: John Baldwin List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 30 Apr 2009 21:50:05 -0000 The following reply was made to PR docs/134074; it has been noted by GNATS. From: John Baldwin To: freebsd-doc@freebsd.org Cc: Haven Hash , freebsd-gnats-submit@freebsd.org Subject: Re: docs/134074: [patch] locking.9 man page slight enhancements Date: Thu, 30 Apr 2009 13:41:48 -0400 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