From owner-freebsd-doc@FreeBSD.ORG Tue Feb 4 22:51:50 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 0D508F2; Tue, 4 Feb 2014 22:51:50 +0000 (UTC) Received: from boomer.ukrhub.net (boomer.ukrhub.net [94.125.121.14]) by mx1.freebsd.org (Postfix) with ESMTP id 7A19A171B; Tue, 4 Feb 2014 22:51:49 +0000 (UTC) Received: by boomer.ukrhub.net (Postfix, from userid 58) id D598D24DC28; Wed, 5 Feb 2014 00:51:47 +0200 (EET) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on boomer.ukrhub.net X-Spam-Level: X-Spam-Status: No, score=-2.9 required=5.0 tests=ALL_TRUSTED,BAYES_00 autolearn=ham version=3.3.1 Received: from gamma.ukrhub.net (unknown [10.100.1.91]) by boomer.ukrhub.net (Postfix) with ESMTP id B8AE624DC1E; Wed, 5 Feb 2014 00:51:45 +0200 (EET) Received: from gamma.ukrhub.net (localhost [127.0.0.1]) by gamma.ukrhub.net (8.14.7/8.14.7) with ESMTP id s14MpjR1038305 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Wed, 5 Feb 2014 00:51:45 +0200 (EET) (envelope-from ds@ukrhub.net) Received: (from ds@localhost) by gamma.ukrhub.net (8.14.7/8.14.7/Submit) id s14MpjtM038304; Wed, 5 Feb 2014 00:51:45 +0200 (EET) (envelope-from ds@ukrhub.net) Date: Wed, 5 Feb 2014 00:51:45 +0200 From: Taras Korenko To: Sergey Kandaurov Subject: Re: en/handbook/kernelconfig: proposed corrections Message-ID: <20140204225145.GA38028@gamma.ukrhub.net> References: <20140204101604.GC83803@gamma.ukrhub.net> <20140204203748.GA16522@omg> MIME-Version: 1.0 Content-Type: text/plain; charset=koi8-u Content-Disposition: inline In-Reply-To: <20140204203748.GA16522@omg> User-Agent: Mutt/1.5.22 (2013-10-16) Cc: freebsd-doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list Reply-To: Taras Korenko List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 04 Feb 2014 22:51:50 -0000 On Wed, Feb 05, 2014 at 12:37:48AM +0400, Sergey Kandaurov wrote: > On Tue, Feb 04, 2014 at 12:16:04PM +0200, Taras Korenko wrote: > > ... > > So, could anyone review that diff? > > Hi, see my 2c inline. > > > Index: en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml > > =================================================================== > > --- en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml (revision 43745) > > +++ en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml (working copy) > > ... > > @@ -226,7 +226,7 @@ > > ath_hal(4) - Atheros Hardware Access Layer (HAL) > > > > Once the hardware inventory list is created, refer to it > > - to ensure that installed hardware is not removed as you edit the custom > > + to ensure that drivers for installed hardware are not removed as you edit the custom > Or rather "drivers OR installed hardware"? :) Both may be removed I guess. I guess user's task at this moment is to create a subset from all available drivers, noone is to add/pull_out NICs, videocards, etc... > > > kernel configuration file. > > > > > > @@ -250,11 +250,7 @@ > > If /usr/src/ does > > not exist or it is empty, source has not been installed. > > Source can be installed using > > - svn, which is described in , or by installing the > > - src distribution using &man.sysinstall.8;. This > > - distribution can be selected by navigating to the > > - Configuration and then to the > > - Distributions menu within &man.sysinstall.8;. > > + svn, which is described in . > You removed reference to sysinstall, but it is still in use in 9.x and 8.x > (well ok, only in 8.x but it also exists in 9.x). > If you want to touch this place, I would suggest to specify &os; version > this is applicable for and briefly mention bsdinstall with referring to > . It would be fine with simply > removing sysinstall part, but this leaves the reader without options. Well, OS 8.X: sysinstall allows us to install sources. OS 9.X: according to our hb, sysinstall is deprecated. Bsdinstall cannot install sources because it does not have such a post-install procedure. OS 10.X: we've svnlite (but cannot refer to it's man page). So, we've to provide detailed description of all available options, or keep just one. > ... -- WBR, Taras Korenko