From owner-cvs-all Wed Apr 10 5: 1:24 2002 Delivered-To: cvs-all@freebsd.org Received: from fledge.watson.org (fledge.watson.org [204.156.12.50]) by hub.freebsd.org (Postfix) with ESMTP id 3025D37B400; Wed, 10 Apr 2002 05:01:13 -0700 (PDT) Received: from fledge.watson.org (fledge.pr.watson.org [192.0.2.3]) by fledge.watson.org (8.11.6/8.11.6) with SMTP id g3AC10w66206; Wed, 10 Apr 2002 08:01:01 -0400 (EDT) (envelope-from robert@fledge.watson.org) Date: Wed, 10 Apr 2002 08:01:00 -0400 (EDT) From: Robert Watson X-Sender: robert@fledge.watson.org To: hiten@uk.FreeBSD.org Cc: freebsd-doc@freebsd.org, Jeroen Ruigrok/asmodai , "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) In-Reply-To: <20020410075148.86487.qmail@web21107.mail.yahoo.com> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII 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, 10 Apr 2002, Hiten Pandya wrote: > --- Murray Stokely wrote: > > Point those people to the Handbook, tell them to search for 'devfs', > > etc.. If they can't find the material they are looking for, then ask > > them to submit minor patches to clarify 5.0 functionality, rather than > > write a whole new book. > > I do understand, but wouldn't be useful to have a chapter, which points > out the new features with short/medium sized descriptions, rather than > bits lurking around the whole handbook? Those would be the release notes. The typical model is that you want a document that lasts after the release process, and becomes the "normal" documentation. There will be many new chapters for 5.0-RELEASE features, we just need to note that they came into existence in 5.0. That way you get a volume at the end of the day that covers 4.x and 5.0, since they'll co-exist for some time. For the TrustedBSD features, we anticipate a number of new handbook chapters, each carefully marked "FreeBSD 5.0 and higher" :-). I don't see a conflict here: many of the underlying paradigms of the system remain the same from the user perspective. There are marked differences, but they can be clearly identified, and are often in the form of new chapters rather than specific changes to existing management procedure (assuming that libh and sysinstallng don't turn up :-). Robert N M Watson FreeBSD Core Team, TrustedBSD Project robert@fledge.watson.org NAI Labs, Safeport Network Services To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message