From owner-freebsd-doc@FreeBSD.ORG Wed Jul 22 06:58:15 2009 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C4FF91065670 for ; Wed, 22 Jul 2009 06:58:15 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from mail-bw0-f219.google.com (mail-bw0-f219.google.com [209.85.218.219]) by mx1.freebsd.org (Postfix) with ESMTP id 453118FC14 for ; Wed, 22 Jul 2009 06:58:14 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: by bwz19 with SMTP id 19so110738bwz.43 for ; Tue, 21 Jul 2009 23:58:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :x-enigmail-version:content-type:content-transfer-encoding; bh=NH6hw/88krrqgKN1KIHBCxnCwZZ1fR5ICbxtV+B5a6E=; b=huxs08Jm6W0+98RlMUPsijWznpwAMZr9YTwJphLjNEVHHXQdgGQWFok8gzTwBC5/8Z O+LGemBnnMXIcgeuuQC8xKqA8vac5r57OaKRlxk0iNQoTEO1NSRBS1XZ8pV7dy3N7Set 1EIlcQSn2pYEgDdJR55+xdwwZ+UZq+uToDnKA= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:x-enigmail-version:content-type :content-transfer-encoding; b=IEwk/6FvGv2JDrBcFadVlqHKR/0mo9D388cXfrlNr94CaACuEll6ipBRMEivz51zg7 cNvsAkRZdDXvOpwQY3asYvkutXkHXdRW9jPw9tK+mLwB2r1XQ62AVWG4/GoTxDdDE2MA tlrCWP2Va5weMz05Pjpm4urZupkQ9j1IkEnbE= Received: by 10.103.107.1 with SMTP id j1mr247098mum.136.1248245893805; Tue, 21 Jul 2009 23:58:13 -0700 (PDT) Received: from atomic.dyndns.org (athedsl-4471200.home.otenet.gr [94.71.121.144]) by mx.google.com with ESMTPS id y2sm1945017mug.46.2009.07.21.23.58.11 (version=TLSv1/SSLv3 cipher=RC4-MD5); Tue, 21 Jul 2009 23:58:12 -0700 (PDT) Message-ID: <4A66B882.70204@gmail.com> Date: Wed, 22 Jul 2009 09:58:10 +0300 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.22 (X11/20090702) MIME-Version: 1.0 To: Glen Barber References: <4ad871310907201847w15ceb0hce73bc4de9de0f0b@mail.gmail.com> In-Reply-To: <4ad871310907201847w15ceb0hce73bc4de9de0f0b@mail.gmail.com> X-Enigmail-Version: 0.95.7 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doc@freebsd.org Subject: Re: Handbook - What's Missing? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Jul 2009 06:58:16 -0000 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