From owner-freebsd-doc Sun Oct 6 20:14:37 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 25B7D37B401 for ; Sun, 6 Oct 2002 20:14:36 -0700 (PDT) Received: from nic.upatras.gr (nic.upatras.gr [150.140.129.30]) by mx1.FreeBSD.org (Postfix) with SMTP id AF78D43E88 for ; Sun, 6 Oct 2002 20:14:34 -0700 (PDT) (envelope-from keramida@freebsd.org) Received: (qmail 3523 invoked from network); 7 Oct 2002 03:07:36 -0000 Received: from upnet-dialinpool-84.upatras.gr (HELO hades.hell.gr) (@150.140.128.170) by nic.upatras.gr with SMTP; 7 Oct 2002 03:07:36 -0000 Received: from hades.hell.gr (hades [127.0.0.1]) by hades.hell.gr (8.12.6/8.12.6) with ESMTP id g972Wr6d006238; Mon, 7 Oct 2002 05:32:53 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by hades.hell.gr (8.12.6/8.12.6/Submit) id g972WqDh006237; Mon, 7 Oct 2002 05:32:52 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Mon, 7 Oct 2002 05:32:50 +0300 (EEST) From: Giorgos Keramidas X-X-Sender: keramida@hades To: Adam Weinberger Cc: doc@freebsd.org Subject: Re: 4.7-RC error In-Reply-To: <20021007004011.GC44643@vectors.cx> Message-ID: <20021007052616.W4202-100000@hades> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On 2002-10-06 17:40, Adam Weinberger wrote: > ** > i'm bringing this over from the -questions list. > ** > > why is the file called /usr/src/UPDATING? that's not a filename that a > new-ish user would check, especially when there's a README in the same > directory. kindof a misnomer IMO. The correct path is the documented path, and cutting-edge chapter of the Handbook clearly references src/UPDATING and not src/README. > makes more sense to me to move src/README to src/REAME.build, and move > src/UPDATING to src/README. or, move src/README to src/README.build and > create a new README file. one that gives very terse instructions for > building world and kernel, and possibly updating the sources. i'd be > happy to provide such a file if it sounds like a good idea. I am not against renaming src/README, but I don't really think there are good reasons to do so. The correct file to read for build instructions is already documented in the Handbook. Not having read the documentation is not a good reason for renaming files around, IMHO. Especially since I don't think that the same people who fail to read the existing documentation will also fail to read the same file if it's called README.first. Giorgos. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message