From owner-freebsd-current@FreeBSD.ORG Fri Feb 13 10:04:34 2004 Return-Path: Delivered-To: freebsd-current@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9CA9816A4CE for ; Fri, 13 Feb 2004 10:04:34 -0800 (PST) Received: from out009.verizon.net (out009pub.verizon.net [206.46.170.131]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5556543D1D for ; Fri, 13 Feb 2004 10:04:34 -0800 (PST) (envelope-from cswiger@mac.com) Received: from mac.com ([68.160.202.196]) by out009.verizon.net (InterMail vM.5.01.06.06 201-253-122-130-106-20030910) with ESMTP id <20040213180433.DNIB11926.out009.verizon.net@mac.com>; Fri, 13 Feb 2004 12:04:33 -0600 Message-ID: <402D11A5.6030803@mac.com> Date: Fri, 13 Feb 2004 13:04:21 -0500 From: Chuck Swiger Organization: The Courts of Chaos User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.6) Gecko/20040113 X-Accept-Language: en-us, en MIME-Version: 1.0 References: <07b801c3f0c5$50b88780$471b3dd4@dual> <20040211181705.GC69282@xor.obsecurity.org> <087f01c3f14d$3ba3c430$471b3dd4@dual> <0b1401c3f218$ddbdb480$471b3dd4@dual> <20040213051135.F34361@alpha.siliconlandmark.com> In-Reply-To: <20040213051135.F34361@alpha.siliconlandmark.com> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit X-Authentication-Info: Submitted using SMTP AUTH at out009.verizon.net from [68.160.202.196] at Fri, 13 Feb 2004 12:04:33 -0600 cc: current@freebsd.org cc: imp@village.org Subject: Re: Upgrading world from 5.0-dp1 to 5.1-RELEASE X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 13 Feb 2004 18:04:34 -0000 Andre Guibert de Bruet wrote: [ ... ] > I'm of the opinion that UPDATING should be shortened for CURRENT. We > stopped supporting 5.0-RELEASE, why are we including every change since > 4.x? What there should be is an UPGRADING file for users that are running > anything other than what's current (5.2-CURRENT as it currently stands) > and an UPDATING file for users that don't need the two tons of steps and > FYIs. For HEAD, for example, UPDATING would only include the changes since > the last release (Currently 5.2-RELEASE, soon 5.2.1). The UPDATING file contains a prologue and reference to "COMMON ITEMS", followed by a cronological ChangeLog, then followed by the COMMON ITEMS section. Your mileage may vary, but I suspect that starting with COMMON ITEMS, and then making reference to a seperate ChangeLog file would be easier to maintain and would be more readable. A user who wanted to update their system would receive prompt gratification by seeing a section on how to build the kernel and how to build and install world on the first page of UPDATING, rather than ~1300 lines into that file. How much of the ChangeLog to include is a seperate question, but it would be reasonable to rotate it when needed, or perhaps even have a ChangeLog-4 and ChangeLog-5 if it's easier on people to track changes made to -CURRENT versus -STABLE seperately. -- -Chuck