Date: Wed, 22 Jul 2009 09:58:10 +0300 From: Manolis Kiagias <sonic2000gr@gmail.com> To: Glen Barber <glen.j.barber@gmail.com> Cc: doc@freebsd.org Subject: Re: Handbook - What's Missing? Message-ID: <4A66B882.70204@gmail.com> In-Reply-To: <4ad871310907201847w15ceb0hce73bc4de9de0f0b@mail.gmail.com> References: <4ad871310907201847w15ceb0hce73bc4de9de0f0b@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
Glen Barber wrote: > Hi folks, > > Short of PRs and list posts, is there a central location to find > documentation that may be missing (or may need updating) for the > transition to the 8.X branch? > > None I am aware of. The major enhancements are always in the release announcement, though not all of these call for a handbook section (and there are other more subtle changes that may need existing sections to be modified). Most of the time the changes in the Handbook are introduced when someone notices the difference and submits a question, PR or a patch. Sometimes even seemingly 'random' events contribute to this. As an example, some debug messages concerning the new ufsid labels were inadvertently left in the kernel of 7.2-RELEASE. I would have never noticed this otherwise (how often do you go searching in /dev?) but it resulted in the update of this section: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/geom-glabel.html (see final paragraphs below the example) If you have a good idea of what is in the Handbook, you can probably find some sections that need to be updated by using the betas. For example, trying out 8.0-BETA1 I was surprised that I could not configure my wireless card like I always did. Then I found out about the new virtual wifi and the changes needed in ifconfig etc. These will definitely need to be documented in the Handbook. A very good page to start looking is Ivan Voras' "What's cooking for FreeBSD 8?" http://ivoras.sharanet.org/freebsd/freebsd8.html
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4A66B882.70204>