From owner-cvs-all Wed Apr 10 0:19: 0 2002 Delivered-To: cvs-all@freebsd.org Received: from mao.stokely.org (mao.stokely.org [65.84.64.228]) by hub.freebsd.org (Postfix) with ESMTP id F0F4037B416; Wed, 10 Apr 2002 00:18:10 -0700 (PDT) Received: by mao.stokely.org (Postfix, from userid 2074) id C20424B669; Wed, 10 Apr 2002 00:18:05 -0700 (PDT) Date: Wed, 10 Apr 2002 00:18:05 -0700 From: Murray Stokely To: Jeroen Ruigrok/asmodai Cc: Greg 'groggy' Lehey , Poul-Henning Kamp , John Baldwin , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: Feature removal without replacement (was: cvs commit: src/sys/alpha/alpha machdep.c src/sys/conf NOTES) Message-ID: <20020410071805.GE22522@freebsdmall.com> References: <20020410143519.B22430@wantadilla.lemis.com> <4868.1018415500@critter.freebsd.dk> <20020410145747.C22430@wantadilla.lemis.com> <20020410054248.GY40979@daemon.ninth-circle.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20020410054248.GY40979@daemon.ninth-circle.org> User-Agent: Mutt/1.3.25i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On Wed, Apr 10, 2002 at 07:42:48AM +0200, Jeroen Ruigrok/asmodai wrote: > Doc does not document CURRENT. Unless policy changed while I was gone. :) > [Or if I never paid really close attention in the first place. :) ] The FreeBSD Handbook attempts to document some -CURRENT features. Some of the articles go out of the way to talk about devfs, the md vs vn devices, and other assorted differences. If doc does not document -CURRENT, I think it is because the authors are unfamiliar with the code. We should certainly encourage the documenting of -CURRENT features. We certainly aren't going to be able to catch up with 2.5 years worth of changes immediately after 5.0 is released. The only way for us to continue to have relevant documentation is to accept -CURRENT submissions now. A few days ago I submitted a PR for us to document FFS snapshots and background fsck in the Handbook. The 2nd Edition FreeBSD Handbook was printed with additional 5.0-CURRENT material added, so that it could have a longer shelf life. - Murray To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message