From owner-freebsd-doc@FreeBSD.ORG  Wed Jan 12 11:29:46 2005
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 1BF6216A4CE
	for <freebsd-doc@freebsd.org>; Wed, 12 Jan 2005 11:29:46 +0000 (GMT)
Received: from tigra.ip.net.ua (tigra.ip.net.ua [82.193.96.10])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 0221C43D1F
	for <freebsd-doc@freebsd.org>; Wed, 12 Jan 2005 11:29:45 +0000 (GMT)
	(envelope-from ru@ip.net.ua)
Received: from localhost (rocky.ip.net.ua [82.193.96.2])
	by tigra.ip.net.ua (8.12.11/8.12.11) with ESMTP id j0CBTfC6003466;
	Wed, 12 Jan 2005 13:29:41 +0200 (EET)
	(envelope-from ru@ip.net.ua)
Received: from tigra.ip.net.ua ([82.193.96.10])
 by localhost (rocky.ipnet [82.193.96.2]) (amavisd-new, port 10024) with LMTP
 id 09924-09; Wed, 12 Jan 2005 13:29:37 +0200 (EET)
Received: from heffalump.ip.net.ua (heffalump.ip.net.ua [82.193.96.213])
	by tigra.ip.net.ua (8.12.11/8.12.11) with ESMTP id j0CBTa0C003461
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO);
	Wed, 12 Jan 2005 13:29:36 +0200 (EET)
	(envelope-from ru@ip.net.ua)
Received: (from ru@localhost)
	by heffalump.ip.net.ua (8.13.1/8.13.1) id j0CBTNoI082042;
	Wed, 12 Jan 2005 13:29:23 +0200 (EET)
	(envelope-from ru)
Date: Wed, 12 Jan 2005 13:29:23 +0200
From: Ruslan Ermilov <ru@freebsd.org>
To: Joseph Koshy <joseph.koshy@gmail.com>
Message-ID: <20050112112923.GB81953@ip.net.ua>
References: <84dead720501111830323a37b1@mail.gmail.com>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="W/nzBZO5zC0uMSeA"
Content-Disposition: inline
In-Reply-To: <84dead720501111830323a37b1@mail.gmail.com>
User-Agent: Mutt/1.5.6i
X-Virus-Scanned: by amavisd-new at ip.net.ua
cc: freebsd-doc@freebsd.org
Subject: Re: Documenting locking requirements in section 9 manual pages
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 12 Jan 2005 11:29:46 -0000


--W/nzBZO5zC0uMSeA
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Wed, Jan 12, 2005 at 02:30:19AM +0000, Joseph Koshy wrote:
> Do we have a standard place in our section 9 manual page format
> to describe locking requirements of kernel interfaces?
>=20
> What do folks think of a ".Sh LOCKING" section like
> the existing ".Sh RETURN VALUES"?
>=20
I think this is important enough to be worth a separate section.
Fine with me.  Make sure to update share/examples/mdoc/example.9
if you go this way.


Cheers,
--=20
Ruslan Ermilov
ru@FreeBSD.org
FreeBSD committer

--W/nzBZO5zC0uMSeA
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.6 (FreeBSD)

iD8DBQFB5QoTqRfpzJluFF4RAnX5AKCI2cdocVLCs42xzQ9j2yrxyF+dLwCeOBGX
u/+oqpcCuUZuhNB0VSRxaNA=
=8LIo
-----END PGP SIGNATURE-----

--W/nzBZO5zC0uMSeA--