docs/134074: [patch] locking.9 man page slight enhancements

[John Baldwin]

The following reply was made to PR docs/134074; it has been noted by GNATS.

From: John Baldwin <jhb at freebsd.org>
To: freebsd-doc at freebsd.org
Cc: Haven Hash <havenster at gmail.com>,
 freebsd-gnats-submit at 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