From owner-freebsd-doc Tue Apr 17 11:11:28 2001 Delivered-To: freebsd-doc@freebsd.org Received: from mailout1-100bt.midsouth.rr.com (mailout1-100bt.midsouth.rr.com [24.92.68.6]) by hub.freebsd.org (Postfix) with ESMTP id 3AC6A37B424 for ; Tue, 17 Apr 2001 11:11:24 -0700 (PDT) (envelope-from dchance@midsouth.rr.com) Received: from mail.midsouth.rr.com (mail.midsouth.rr.com [24.92.68.1]) by mailout1-100bt.midsouth.rr.com (8.11.2/8.11.2) with ESMTP id f3HIBBL00774 for ; Tue, 17 Apr 2001 13:11:12 -0500 (CDT) Received: from satan ([24.165.213.219]) by mail.midsouth.rr.com (Post.Office MTA v3.5.3 release 223 ID# 0-59787U250000L250000S0V35) with SMTP id com for ; Tue, 17 Apr 2001 13:11:15 -0500 Message-ID: <001901c0c769$e2282870$0200000a@satan> From: "Daryl Chance" To: Subject: Programmers Documentation Project Date: Tue, 17 Apr 2001 13:11:53 -0500 MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 6.00.2462.0000 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2462.0000 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi, I was looking through the list of projects to see if one existed for documenting the FBSD code. The closest I came to it was this: http://home.wxs.nl/~asmodai/pdp.html Does anyone know if there has been any recent work done on this? the top of this page: http://home.wxs.nl/~asmodai/source-overview.txt Has a date of 1999/04/01, a little over 2 years. I say this is the closest, because I was looking for something else, something a little more "thourough", like (I realize this would be a HUGE undertaking) commenting all the functions in the FBSD source and running something like ScanDoc against it or some other auto- matic code documentation programs. Anyone have any suggestions? Offer any help? I thought about this which watching the recent discussion on "VM Balance" on -stable. This would be a great project to start so that someone interested in browsing the FBSD source can see more then just the code, they can see the functions, structs, etc etc and read the comments against those. It may help the people doing work on FBSD to learn more about the source. Thoughts? I'd be willing to help out, or even lead this project. I do think this would take a lot of patience from the -stable people answering our questions about things that they would consider trivial :). I'm only on a Cable connection w/ a K6 333 as my most powerful server, but I can offer up this to see this project get off the ground and to show that theres some interest. I'd also have to learn scandoc or whatever documentation tool we plan on using if theres any interest. Thanks, Daryl Chance To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message