From owner-freebsd-doc  Tue Apr 17 22: 2:40 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 4E8ED37B422
	for <doc@FreeBSD.ORG>; Tue, 17 Apr 2001 22:02:36 -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 f3I52LL20104;
	Wed, 18 Apr 2001 00:02:21 -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;
          Wed, 18 Apr 2001 00:02:30 -0500
Message-ID: <002101c0c7c4$dabada50$0200000a@satan>
From: "Daryl Chance" <dchance@midsouth.rr.com>
To: <doc@FreeBSD.ORG>, "Jordan Hubbard" <jkh@osd.bsdi.com>
References: <001901c0c769$e2282870$0200000a@satan> <20010417144932C.jkh@osd.bsdi.com> <000701c0c78f$de88ec60$0200000a@satan>
Subject: Re: Programmers Documentation Project
Date: Wed, 18 Apr 2001 00:03:05 -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

So does anyone see a use for this type of documentation?  I would
like to know before I start work on this :).

Jordan?

> so basically, if you want to do it, heres your straight-jacket
> and path to your favorite editor eh? :)
> 
> I really would like to do this, but I don't want to do it alone :).
> What I eventually want, is understanding enough of the code to be
> able to commit code back to the FBSD community and I figured that
> commenting code would be an easy way to get in there, tinker with
> code, without actually breaking anything.
> 
> Btw, I did check the info you gave me Murray, and it's not what I
> was looking for :).  What I'm lookin for is something like this:
> http://www.blur.com/blurbeta/Beta/source/maxclasslib/docs/html/index.html
> 
> and AFAIK, it doesn't exists for FBSD.  To any of the commiters
> to FreeBSD, does this seem useful?  Or just wasted time?
> 
> If it doesn't seem like wasted time to people, I start on it :).
> 
> One last question, should I follow the -current tree with all the
> documentation and have it go into -stable when it's MFC'd?  Or
> make my patches against -stable and -current?
> 
> Thanks,
> Daryl
> ----- Original Message ----- 
> From: "Jordan Hubbard" <jkh@osd.bsdi.com>
> To: <dchance@midsouth.rr.com>
> Cc: <doc@FreeBSD.ORG>
> Sent: Tuesday, April 17, 2001 4:49 PM
> Subject: Re: Programmers Documentation Project
> 
> 
> > > Thoughts?  I'd be willing to help out, or even lead this project.
> > 
> > That one last clause will count for more than anything else you
> > said. :-)
> > 
> > The effort is a noble and worthy one, but you must also be willing to
> > sacrifice yourself to a cruel, uncaring and demanding elder god who
> > will break you daily upon the rack in repayment for your labors.
> > 
> > In short, you must be the kind of person who is willing to go to
> > insane, masochistic lengths for just the slightest feeling of
> > satisfaction at a job well done.  If you are, I say "Welcome aboard,
> > and CHARGE!!" :-)
> > 
> > - Jordan
> > 
> > To Unsubscribe: send mail to majordomo@FreeBSD.org
> > with "unsubscribe freebsd-doc" in the body of the message
> > 
> 
> 
> To Unsubscribe: send mail to majordomo@FreeBSD.org
> with "unsubscribe freebsd-doc" in the body of the message
> 


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message