From owner-freebsd-libh Wed Sep 26 9: 2:25 2001 Delivered-To: freebsd-libh@freebsd.org Received: from tomts13-srv.bellnexxia.net (tomts13.bellnexxia.net [209.226.175.34]) by hub.freebsd.org (Postfix) with ESMTP id 56EE737B410 for ; Wed, 26 Sep 2001 09:02:20 -0700 (PDT) Received: from khan.anarcat.dyndns.org ([65.92.169.79]) by tomts13-srv.bellnexxia.net (InterMail vM.4.01.03.16 201-229-121-116-20010115) with ESMTP id <20010926160219.FNTS12483.tomts13-srv.bellnexxia.net@khan.anarcat.dyndns.org>; Wed, 26 Sep 2001 12:02:19 -0400 Received: from shall.anarcat.dyndns.org (shall.anarcat.dyndns.org [192.168.0.1]) by khan.anarcat.dyndns.org (Postfix) with ESMTP id 969871AE1; Wed, 26 Sep 2001 12:02:13 -0400 (EDT) Received: by shall.anarcat.dyndns.org (Postfix, from userid 1000) id 7735520B36; Wed, 26 Sep 2001 12:02:12 -0400 (EDT) Date: Wed, 26 Sep 2001 12:02:12 -0400 From: The Anarcat To: Alexander Langer Cc: Libh Subject: Re: libdisk doc Message-ID: <20010926120211.B40172@shall.anarcat.dyndns.org> Mail-Followup-To: The Anarcat , Alexander Langer , Libh References: <20010926003636.B499@shall.anarcat.dyndns.org> <20010926115533.B7582@zerogravity.kawo2.rwth-aachen.de> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="QTprm0S8XgL7H0Dt" Content-Disposition: inline In-Reply-To: <20010926115533.B7582@zerogravity.kawo2.rwth-aachen.de> User-Agent: Mutt/1.3.22.1i Sender: owner-freebsd-libh@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG --QTprm0S8XgL7H0Dt Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed Sep 26, 2001 at 11:55:33AM +0200, Alexander Langer wrote: > Thus spake The Anarcat (anarcat@anarcat.dyndns.org): >=20 > > I'm digging around libdisk because (correct me if I'm wrong) libhdisk is > > not really documented and pretty much only a wrapper for libdisk. Now, >=20 > It's not documented, correct.=20 A first part of the doc might be the little drawing. I think it is still appliable to the Disk and Disk_Chunk classes. I might Dia some nice UML stuff out of these classe to have a reference. Could that be put in CVS? Dia native format is xml... > But IIRC, it's more than a wrapper to libdisk. Yes. > libhdisk also does newfs stuff. Indeed. Actually, it's some kind of GUI wrapper. It takes does not directly act on the disk as libdisk does, it takes into account "modifications" to the structure, has "undo" caps, etc. > A SIMPLE documentation is provided for each function (-argument) > in Disk.cd.cc I will make it more documented. The problem is that there is not much documentation of the underlying calls to libdisk. And that's why I'm having trouble "getting into it". :) I think libdisk, disklabel, slices, etc, should be documented in man pages. The scheme is not trivial and should be heavily documented. As a side note, is libhdisk "splittable" from libh? Could it be possible to use it as a simple libdisk C++ class? I don't think so. :) > > All this and more (disklabel.h FS_* macros), should be documented > > somewhere (is it?). >=20 > Don't know. Where should I ask/look? > Content-Description: release/labeledit/algo.txt > > We have the structures: >=20 > Nice one. > Hmm, that could be cool stuff for the Developers handbook :) Thanks, I take it as a compliment. :) > You might ask the -doc folks. I'll repost to -doc. > We can also put it into our doc/ dir, but so no other users > had advantage of this :-/ I think it should still be put in doc/ since it could be the basis for future class documentation. Any thoughts on using a "code documentation system" such as Doxygen? A. --QTprm0S8XgL7H0Dt Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: For info see http://www.gnupg.org iEYEARECAAYFAjux/AIACgkQttcWHAnWiGc/jACaAjBS42jnVlCKmyZakyJlILl/ ZiEAoKAN2kxeExqgHwBru6m6JTb5i8SX =XJLI -----END PGP SIGNATURE----- --QTprm0S8XgL7H0Dt-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-libh" in the body of the message