Date: Thu, 30 Apr 2009 21:50:02 GMT From: John Baldwin <jhb@freebsd.org> To: freebsd-doc@FreeBSD.org Subject: Re: docs/134074: [patch] locking.9 man page slight enhancements Message-ID: <200904302150.n3ULo2Uo001679@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/134074; it has been noted by GNATS. From: John Baldwin <jhb@freebsd.org> To: freebsd-doc@freebsd.org Cc: Haven Hash <havenster@gmail.com>, 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200904302150.n3ULo2Uo001679>