From owner-freebsd-arch@FreeBSD.ORG Wed May 21 10:54:14 2003 Return-Path: Delivered-To: freebsd-arch@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C62F437B401; Wed, 21 May 2003 10:54:14 -0700 (PDT) Received: from odin.ac.hmc.edu (Odin.AC.HMC.Edu [134.173.32.75]) by mx1.FreeBSD.org (Postfix) with ESMTP id 19E4B43F93; Wed, 21 May 2003 10:54:14 -0700 (PDT) (envelope-from brdavis@odin.ac.hmc.edu) Received: from odin.ac.hmc.edu (IDENT:brdavis@localhost.localdomain [127.0.0.1]) by odin.ac.hmc.edu (8.12.9/8.12.3) with ESMTP id h4LHsBUO029108; Wed, 21 May 2003 10:54:11 -0700 Received: (from brdavis@localhost) by odin.ac.hmc.edu (8.12.9/8.12.3/Submit) id h4LHsB5d029107; Wed, 21 May 2003 10:54:11 -0700 Date: Wed, 21 May 2003 10:54:11 -0700 From: Brooks Davis To: Mike Makonnen Message-ID: <20030521175411.GA3076@Odin.AC.HMC.Edu> References: <20030520203418.GA92706@perrin.int.nxad.com> <20030521165252.GJEW25800.out006.verizon.net@kokeb.ambesa.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="ZPt4rx8FFjLCG7dd" Content-Disposition: inline In-Reply-To: <20030521165252.GJEW25800.out006.verizon.net@kokeb.ambesa.net> User-Agent: Mutt/1.5.4i X-Virus-Scanned: by amavisd-milter (http://amavis.org/) on odin.ac.hmc.edu cc: Hiten Pandya cc: arch@freebsd.org Subject: Re: ALQ manual page review X-BeenThere: freebsd-arch@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Discussion related to FreeBSD architecture List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 May 2003 17:54:15 -0000 --ZPt4rx8FFjLCG7dd Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, May 21, 2003 at 12:52:51PM -0400, Mike Makonnen wrote: > On Tue, 20 May 2003 13:34:18 -0700 > Hiten Pandya wrote: >=20 > > Hi gang. > >=20 > > I have written a manual page for the Asynchronous Logging Queues (ALQ) > > facility, available in FreeBSD 5.x. I have been trying to reach Jeff by > > various methods of contact (IRC, mail etc) but I have not had a response > > from him. > >=20 > > Viewing copy is available: > >=20 > > http://people.FreeBSD.ORG/~hmp/manpages/alq.9.pdf > > http://people.FreeBSD.ORG/~hmp/manpages/alq.9.txt >=20 > This is really more of an "observation" than a request to do something ab= out it. >=20 > Most (all) manual pages have separate sections for 'RETURN VALUES' and 'E= RRORS.' > I find this very useful. While including return values and errors with the > description of the function does make sense, the former makes it much > easier for me to find what I'm looking for. For example, a lot of times I > already know what the function does, and I just want to quickly find out = what > values it returns and the possible errors. I second this. I find the RETURN VALUES sections especialy useful. Thanks for the good work Hiten! -- Brooks --=20 Any statement of the form "X is the one, true Y" is FALSE. PGP fingerprint 655D 519C 26A7 82E7 2529 9BF0 5D8E 8BE9 F238 1AD4 --ZPt4rx8FFjLCG7dd Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (GNU/Linux) iD8DBQE+y71AXY6L6fI4GtQRAtLhAKDChRbWeeE6nanPX0BOuT+3j2aw+gCgrRGc RiEaxYPucg9Lc6X7jEUfP+4= =AfEj -----END PGP SIGNATURE----- --ZPt4rx8FFjLCG7dd--