Date: Sun, 20 Jun 1999 20:03:45 -0400 (EDT) From: "Brian F. Feldman" <green@unixhelp.org> To: John Birrell <jb@cimlogic.com.au> Cc: Bill Fumerola <billf@jade.chc-chimes.com>, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: doc/en/handbook/ports chapter.sgml Message-ID: <Pine.BSF.4.10.9906201959290.30045-100000@janus.syracuse.net> 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: > Bill Fumerola wrote: > > On Mon, 21 Jun 1999, John Birrell wrote: > > > > > I understand that it is useful to have the history of __FreeBSD_version > > > documented in a manner that is convenient for ports people, but when > > > you look at it from the other direction, doc/en/handbook/ports seems > > > a bit odd. > > > > *shrug* At this point it's only to help people understand what happened > > when. > > > > Perhaps that whole section could be replaced with a link to > > 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. Ahem, that's nerdy BROKEN English to you! ;) Some commit messages are worse than others. But most _are_ good enough for use as an explanation for a version bump. > > 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. But __FreeBSD_version is mainly for the ports system anyway! > > -- > John Birrell - jb@cimlogic.com.au; jb@freebsd.org http://www.cimlogic.com.au/ > CIMlogic Pty Ltd, GPO Box 117A, Melbourne Vic 3001, Australia +61 418 353 137 > > Brian Fundakowski Feldman _ __ ___ ____ ___ ___ ___ green@FreeBSD.org _ __ ___ | _ ) __| \ FreeBSD: The Power to Serve! _ __ | _ \._ \ |) | http://www.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.4.10.9906201959290.30045-100000>