From owner-freebsd-doc@FreeBSD.ORG Wed Feb 5 03:01:58 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 1CCE11F1 for ; Wed, 5 Feb 2014 03:01:58 +0000 (UTC) Received: from wonkity.com (wonkity.com [67.158.26.137]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id BB79E1375 for ; Wed, 5 Feb 2014 03:01:57 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id s1531sfE042559; Tue, 4 Feb 2014 20:01:54 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id s1531rPS042556; Tue, 4 Feb 2014 20:01:54 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Tue, 4 Feb 2014 20:01:53 -0700 (MST) From: Warren Block To: Taras Korenko Subject: Re: en/handbook/kernelconfig: proposed corrections In-Reply-To: <20140204101604.GC83803@gamma.ukrhub.net> Message-ID: References: <20140204101604.GC83803@gamma.ukrhub.net> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Tue, 04 Feb 2014 20:01:54 -0700 (MST) Cc: freebsd-doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 05 Feb 2014 03:01:58 -0000 On Tue, 4 Feb 2014, Taras Korenko wrote: > Good morning, doc@ folks. > > The following notes were made while working on russian translation > of kernelconfig chapter. I hope some parts of the following diff > might be useful. > > So, could anyone review that diff? Notes below prefixed with "WB:". 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) @@ -204,8 +204,8 @@ &man.pciconf.8;, which provides more verbose output. For example: - pciconf -lv - ath0@pci0:3:0:0: class=0x020000 card=0x058a1014 chip=0x1014168c rev=0x01 hdr=0x00 + &prompt.user; pciconf -lv WB: This should be a section rather than . +ath0@pci0:3:0:0: class=0x020000 card=0x058a1014 chip=0x1014168c rev=0x01 hdr=0x00 vendor = 'Atheros Communications Inc.' device = 'AR5212 Atheros AR5212 802.11abg wireless' class = network @@ -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 WB: "are not removed as the custom kernel configuration is edited." (to get rid of the informal "you"). 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 . WB: s%svn%Subversion% (svn is the command). Once source is installed, review the contents of /usr/src/sys. This directory contains a number of subdirectories, including those which represent the following @@ -350,7 +346,7 @@ To build a file which contains all available options, run the following command as root: - &prompt.root; cd /usr/src/sys/i386/conf && make LINT + &prompt.root; cd /usr/src/sys/arch/conf && make LINT @@ -521,10 +517,10 @@ options SCSI_DELAY=5000 # Delay (in ms) before probing SCSI This causes the kernel to pause for 5 seconds before probing - each SCSI device in the system. If the system only has IDE hard - drives, ignore this or lower the number to speed up booting. - However, if &os; has trouble recognizing the SCSI devices, the - number will have to be raised again. + each SCSI device in the system. If &os; has trouble recognizing + the SCSI devices, the number will have to be raised. On the + other hand, if the system has only IDE hard drives, ignore this + or lower the number to speed up booting. WB: "If SCSI drives are not recognized, increase the number. If the system does not have any SCSI drives, this value can be ignored or decreased to speed up booting." WB: How or whether this still affects systems with IDE, or more specifically non-SCSI devices, needs to be verified. options KTRACE # ktrace(1) support @@ -577,7 +573,7 @@ processors. - This device exists only on the i386 architecture and this + This device exists only on the &i386; architecture and this configuration line should not be used on other architectures. @@ -743,8 +739,7 @@ The &man.vga.4; video card driver. - -device splash # Splash screen and screen saver support + device splash # Splash screen and screen saver support Required by the boot splash screen and screen savers. @@ -926,7 +921,7 @@ #device le ISA Ethernet drivers. See - /usr/src/sys/i386/conf/NOTES + /usr/src/sys/arch/conf/NOTES for details of which cards are supported by which driver. # Wireless NIC cards @@ -1065,7 +1060,7 @@ For more information and additional devices supported by &os;, see - /usr/src/sys/i386/conf/NOTES. + /usr/src/sys/arch/conf/NOTES. Large Memory Configurations