From owner-freebsd-stable Wed Apr 18 2:20:33 2001 Delivered-To: freebsd-stable@freebsd.org Received: from garm.bart.nl (garm.bart.nl [194.158.170.13]) by hub.freebsd.org (Postfix) with ESMTP id 6F7FA37B423; Wed, 18 Apr 2001 02:20:25 -0700 (PDT) (envelope-from asmodai@wxs.nl) Received: from daemon.chronias.ninth-circle.org (root@cable.ninth-circle.org [195.38.232.6]) by garm.bart.nl (8.10.1/8.10.1) with ESMTP id f3I9KMi45764; Wed, 18 Apr 2001 11:20:22 +0200 (CEST) Received: (from asmodai@localhost) by daemon.chronias.ninth-circle.org (8.11.3/8.11.3) id f3I9KHw53967; Wed, 18 Apr 2001 11:20:17 +0200 (CEST) (envelope-from asmodai) Date: Wed, 18 Apr 2001 11:20:16 +0200 From: Jeroen Ruigrok/Asmodai To: Daryl Chance Cc: stable@freebsd.org, doc@freebsd.org Subject: Re: Programmers Documentation Project Message-ID: <20010418112016.D45919@daemon.ninth-circle.org> References: <001501c0c76d$58726ab0$0200000a@satan> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <001501c0c76d$58726ab0$0200000a@satan>; from dchance@midsouth.rr.com on Tue, Apr 17, 2001 at 01:36:40PM -0500 Organisation: Ninth-Circle Enterprises Sender: owner-freebsd-stable@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG -On [20010417 20:56], Daryl Chance (dchance@midsouth.rr.com) wrote: >I just posted this on -doc, but I thought I'd ask you all for >thoughts on this since -stable will probably be the main target >for questions while/if this project is going on. Heh, you could've cc:'d me in the emails. :P >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 We moved a lot of that to the Developer's Handbook. Nik Clayton just fixed it to the daily doc build and provided soem links towards it on the webpages. >Has a date of 1999/04/01, a little over 2 years. Mea culpa. Real life sucks. :P >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. That was what I was working on. Until I got dragged into a commit bit. I still need to expand on, and include it in the handbook, my newbus doc at people.freebsd.org/~asmodai/newbus-draft.txt >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. Neil Blakey and me have been looking at the GDK project's way of documenting. Looks interesting. >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. All documentation eventually returns to SGML/DocBook. -- Jeroen Ruigrok van der Werven/Asmodai .oUo. asmodai@[wxs.nl|freebsd.org] Documentation nutter/C-rated Coder BSD: Technical excellence at its best D78D D0AD 244D 1D12 C9CA 7152 035C 1138 546A B867 Of all that is to come, the Dream has just begun... To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-stable" in the body of the message