From owner-freebsd-doc@FreeBSD.ORG  Wed Jan 12 17:12:14 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 16E0416A4CE; Wed, 12 Jan 2005 17:12:14 +0000 (GMT)
Received: from kane.otenet.gr (kane.otenet.gr [195.170.0.27])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 3695443D46; Wed, 12 Jan 2005 17:12:13 +0000 (GMT)
	(envelope-from keramida@FreeBSD.org)
Received: from orion.daedalusnetworks.priv (aris.bedc.ondsl.gr
	[62.103.39.226])j0CHCAOv028673;	Wed, 12 Jan 2005 19:12:10 +0200
Received: from orion.daedalusnetworks.priv (orion [127.0.0.1])
	j0CHCBTi001864;	Wed, 12 Jan 2005 19:12:11 +0200 (EET)
	(envelope-from keramida@FreeBSD.org)
Received: (from keramida@localhost)j0CHCBfn001863;
	Wed, 12 Jan 2005 19:12:11 +0200 (EET)
	(envelope-from keramida@FreeBSD.org)
Date: Wed, 12 Jan 2005 19:12:11 +0200
From: Giorgos Keramidas <keramida@FreeBSD.org>
To: "Simon L. Nielsen" <simon@FreeBSD.org>,
	Ruslan Ermilov <ru@FreeBSD.org>
Message-ID: <20050112171211.GA1673@orion.daedalusnetworks.priv>
References: <84dead720501111830323a37b1@mail.gmail.com>
	<20050112112923.GB81953@ip.net.ua> <20050112121410.GA6704@eddie.nitro.dk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20050112121410.GA6704@eddie.nitro.dk>
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 17:12:14 -0000

On 2005-01-12 13:14, "Simon L. Nielsen" <simon@freebsd.org> wrote:
>On 2005.01.12 13:29:23 +0200, Ruslan Ermilov wrote:
>>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?
>>>
>>> What do folks think of a ".Sh LOCKING" section like
>>> the existing ".Sh RETURN VALUES"?
>>
>> 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.
>
> Actually we don't have a section 9 example, only 1, 3, and 4.  I guess
> it should be fairly simple for somebody to make an example.9 based on
> one of the other pages.

Shamelessly copied from example.3, how does the following look?

	http://people.freebsd.org/~keramida/example.9

- Giorgos