Date: Sun, 20 Jun 1999 20:18:53 -0400 (EDT) From: Bill Fumerola <billf@jade.chc-chimes.com> To: John Birrell <jb@cimlogic.com.au> Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: doc/en/handbook/ports chapter.sgml Message-ID: <Pine.BSF.3.96.990620201612.16570A-100000@jade.chc-chimes.com> In-Reply-To: <199906210011.KAA07097@cimlogic.com.au>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.BSF.3.96.990620201612.16570A-100000>