From owner-freebsd-arch@FreeBSD.ORG  Thu May 22 03:06:22 2003
Return-Path: <owner-freebsd-arch@FreeBSD.ORG>
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 7FCB337B401; Thu, 22 May 2003 03:06:22 -0700 (PDT)
Received: from axl.seasidesoftware.co.za (axl.seasidesoftware.co.za
	[196.31.7.201])	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 4596F43F75; Thu, 22 May 2003 03:06:21 -0700 (PDT)
	(envelope-from sheldonh@starjuice.net)
Received: from sheldonh by axl.seasidesoftware.co.za with local (Exim 4.20)
	id 19Imxl-0006lb-K3; Thu, 22 May 2003 12:06:17 +0200
Date: Thu, 22 May 2003 12:06:17 +0200
From: Sheldon Hearn <sheldonh@starjuice.net>
To: Hiten Pandya <hmp@FreeBSD.ORG>
Message-ID: <20030522100617.GO25247@starjuice.net>
Mail-Followup-To: Hiten Pandya <hmp@FreeBSD.ORG>,
	David Schultz <das@FreeBSD.ORG>, arch@FreeBSD.ORG
References: <20030522021829.GA6619@perrin.int.nxad.com>
	<20030522065054.GA9917@HAL9000.homeunix.com>
	<20030522095712.GA39016@perrin.int.nxad.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20030522095712.GA39016@perrin.int.nxad.com>
User-Agent: Mutt/1.5.4i
Sender: Sheldon Hearn <sheldonh@starjuice.net>
cc: arch@FreeBSD.ORG
cc: David Schultz <das@FreeBSD.ORG>
Subject: Re: vnode(9) update
X-BeenThere: freebsd-arch@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Discussion related to FreeBSD architecture
	<freebsd-arch.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-arch>,
	<mailto:freebsd-arch-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-arch>
List-Post: <mailto:freebsd-arch@freebsd.org>
List-Help: <mailto:freebsd-arch-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-arch>,
	<mailto:freebsd-arch-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 22 May 2003 10:06:23 -0000

On (2003/05/22 02:57), Hiten Pandya wrote:

> 	Yes, its really hard to maintain big structures in manual pages.
> 	Only half of struct vnode was explained in the vnode(9) manual
> 	page.  I will commit this change later on today.

You're not alone, feeling that way.  It's an unfortunate limitation of
the tools we use.

One day, we'll have a doc toolset that can include parts of source files
based on metadata embedded in those source files.

Until then, it's just a PITA we have to put up with.  Hang in there,
you're doing good work. :-)

Ciao,
Sheldon.