From owner-cvs-all Sun Jun 20 17: 4:17 1999 Delivered-To: cvs-all@freebsd.org Received: from janus.syracuse.net (janus.syracuse.net [205.232.47.15]) by hub.freebsd.org (Postfix) with ESMTP id E6A0314F09; Sun, 20 Jun 1999 17:04:12 -0700 (PDT) (envelope-from green@unixhelp.org) Received: from localhost (green@localhost) by janus.syracuse.net (8.9.2/8.8.7) with ESMTP id UAA30231; Sun, 20 Jun 1999 20:03:45 -0400 (EDT) Date: Sun, 20 Jun 1999 20:03:45 -0400 (EDT) From: "Brian F. Feldman" X-Sender: green@janus.syracuse.net To: John Birrell Cc: Bill Fumerola , 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: > 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