From owner-cvs-all Sun Jun 20 17:15:27 1999 Delivered-To: cvs-all@freebsd.org Received: from jade.chc-chimes.com (jade.chc-chimes.com [206.67.97.83]) by hub.freebsd.org (Postfix) with ESMTP id A6C2214F09; Sun, 20 Jun 1999 17:15:16 -0700 (PDT) (envelope-from billf@jade.chc-chimes.com) Received: from localhost (billf@localhost) by jade.chc-chimes.com (8.8.8/8.8.8) with SMTP id UAA18509; Sun, 20 Jun 1999 20:18:53 -0400 (EDT) (envelope-from billf@jade.chc-chimes.com) Date: Sun, 20 Jun 1999 20:18:53 -0400 (EDT) From: Bill Fumerola To: John Birrell Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: doc/en/handbook/ports chapter.sgml In-Reply-To: <199906210011.KAA07097@cimlogic.com.au> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk On Mon, 21 Jun 1999, John Birrell wrote: > > http://www.FreeBSD.org/cgi/cvsweb.cgi/src/sys/sys/param.h > > That won't work because sys/param.h only shows what the latest value > is, not why it is what it is, or why it was what it was. 8-) > It is the RCS file that contains the reason why the developer changed > it, but the commit message is unsuitable for the documentation (no > consistent style). And the commit message is always in (nerdy) English - > we need a structure that allows for translation to other languages. Okay, the above URL is the commit log for the file, not the latest value. I can see however that some sort of strcuture is needed. > As a developer, I would never have thought to look in the ports section > of the handbook for this sort of information. IMHO, the ports section > is for use more often by people creating ports from other people's > code. We need to document things in a way that suits the "other > people" too. Perhaps it does belong in another section, it does however still need to be in or be referenced to in the ports documentation. - bill fumerola - billf@chc-chimes.com - BF1560 - computer horizons corp - - ph:(800) 252-2421 - bfumerol@computerhorizons.com - billf@FreeBSD.org - To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message