From owner-freebsd-geom@FreeBSD.ORG  Wed Nov 13 09:32:16 2013
Return-Path: <owner-freebsd-geom@FreeBSD.ORG>
Delivered-To: freebsd-geom@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id D6059BA1
 for <freebsd-geom@freebsd.org>; Wed, 13 Nov 2013 09:32:16 +0000 (UTC)
Received: from mout.gmx.net (mout.gmx.net [212.227.15.15])
 (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA (128/128 bits))
 (No client certificate requested)
 by mx1.freebsd.org (Postfix) with ESMTPS id 70F02218F
 for <freebsd-geom@freebsd.org>; Wed, 13 Nov 2013 09:32:16 +0000 (UTC)
Received: from lemon ([80.7.17.14]) by mail.gmx.com (mrgmx103) with ESMTPSA
 (Nemesis) id 0MLvLE-1VoFV62tUC-007nve for <freebsd-geom@freebsd.org>; Wed, 13
 Nov 2013 10:32:08 +0100
Received: by lemon (Postfix, from userid 1001)
 id CD8A3EB27E; Wed, 13 Nov 2013 09:32:07 +0000 (GMT)
Date: Wed, 13 Nov 2013 09:32:07 +0000
From: symbolics@gmx.com
To: freebsd-geom@freebsd.org
Subject: Re: documentation of GEOM data structures needed
Message-ID: <20131113093207.GA60246@lemon>
References: <20131111162400.0bc7dfef@X220.ovitrap.com>
 <20131111091836.GA83261@lemon>
 <20131111183216.5ec80e9e@X220.ovitrap.com>
 <20131111151141.GA1381@lemon>
 <20131111235032.6a6f26f7@X220.ovitrap.com>
 <20131111164805.GB1381@lemon>
 <20131112111658.4cb1ef95@X220.ovitrap.com>
 <20131112094050.GA1808@lemon>
 <20131113125536.01a43e4b@X220.ovitrap.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20131113125536.01a43e4b@X220.ovitrap.com>
X-Provags-ID: V03:K0:6GsZxtIWSpuQnjdF/UQR5tcXg5E4d9DlCQRPlvDZJIDb0Rq6pZD
 HXfFihkQjimdxEnCpgGzYtcDdm6z4TLMcimYXzaPF4v3cekKVpAZ5yfFTV/NpNjTX44NSke
 Ipwe+LmYN8ROyKrGHMsqJJYzLVVZEYOdOUJpbtQQdgG53yDOKWiFIway+6ZN6UUS5Hg7QqJ
 pYrU0Sf76kjBhll85aukw==
X-BeenThere: freebsd-geom@freebsd.org
X-Mailman-Version: 2.1.16
Precedence: list
List-Id: GEOM-specific discussions and implementations
 <freebsd-geom.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-geom>,
 <mailto:freebsd-geom-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-geom/>
List-Post: <mailto:freebsd-geom@freebsd.org>
List-Help: <mailto:freebsd-geom-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-geom>,
 <mailto:freebsd-geom-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 13 Nov 2013 09:32:16 -0000

On Wed, Nov 13, 2013 at 12:55:36PM +0800, Erich Dollansky wrote:
[...]
> I noticed that in FreeBSD data structures are hardly documented. When I
> was still programming, the first step during development was the
> documentation of the data structures. I kept this documentation in the
> header files.

Hi,

I agree, I would like more comprehensive documentation too.

--sym