Date: Wed, 5 Feb 2014 00:37:48 +0400 From: Sergey Kandaurov <pluknet@freebsd.org> To: Taras Korenko <ds@ukrhub.net> Cc: freebsd-doc@freebsd.org Subject: Re: en/handbook/kernelconfig: proposed corrections Message-ID: <20140204203748.GA16522@omg> In-Reply-To: <20140204101604.GC83803@gamma.ukrhub.net> References: <20140204101604.GC83803@gamma.ukrhub.net>
next in thread | previous in thread | raw e-mail | index | archive | help
--UugvWAfsgieZRqgk Content-Type: text/plain; charset=koi8-r Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Feb 04, 2014 at 12:16:04PM +0200, Taras Korenko wrote: > Good morning, doc@ folks. >=20 > The following notes were made while working on russian translation > of kernelconfig chapter. I hope some parts of the following diff > might be useful. >=20 > So, could anyone review that diff? Hi, see my 2c inline. > Index: en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > --- en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml (revision 437= 45) > +++ 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:</para> > =20 > - <programlisting><command>pciconf -lv</command> > - ath0@pci0:3:0:0: class=3D0x020000 card=3D0x058a1014 chip=3D0x= 1014168c rev=3D0x01 hdr=3D0x00 > + <programlisting>&prompt.user; pciconf -lv > +ath0@pci0:3:0:0: class=3D0x020000 card=3D0x058a1014 chip=3D0x1014= 168c rev=3D0x01 hdr=3D0x00 > vendor =3D 'Atheros Communications Inc.' > device =3D 'AR5212 Atheros AR5212 802.11abg wireless' > class =3D network > @@ -226,7 +226,7 @@ > ath_hal(4) - Atheros Hardware Access Layer (HAL)</programl= isting> > =20 > <para>Once the hardware inventory list is created, refer to it > - to ensure that installed hardware is not removed as you edit the c= ustom > + to ensure that drivers for installed hardware are not removed as y= ou edit the custom Or rather "drivers OR installed hardware"? :) Both may be removed I guess. > kernel configuration file.</para> > </sect1> > =20 > @@ -250,11 +250,7 @@ > <para>If <filename>/usr/src/</filename> does > not exist or it is empty, source has not been installed. > Source can be installed using > - <application>svn</application>, which is described in <xref linkend=3D"= svn"/>, or by installing the > - <literal>src</literal> distribution using &man.sysinstall.8;. This > - distribution can be selected by navigating to the=20 > - <literal>Configuration</literal> and then to the > - <literal>Distributions</literal> menu within &man.sysinstall.8;.</para> > + <application>svn</application>, which is described in <xref linkend=3D"= svn"/>.</para> 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 <xref linked=3D"bsdinstall-components"/>. It would be fine with simply removing sysinstall part, but this leaves the reader without options. The rest looks good to me, given that you will split the changes into markup and content changes :). --UugvWAfsgieZRqgk Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.22 (FreeBSD) iQEcBAEBAgAGBQJS8U+cAAoJED9Ol7oQYHQZZNoIAJnwbd0NuY5/cvyMHa6Pmmos BUxx9FashmQRzJWNjvfWZQ5L+XyssvG5VEEmYveGovZuCRb8ZJu9GRD2eYBMDc+p qI05Mq60iHBxzKvDwDlWNIYsGlXZvBTo3kCszbA+ID7j3T3JaEmsIytcMcoZzFSV hGlwThmgI5d4aTbBEVTYmUY8+zkeyeEGBmYhsK5yGb9KDIQdOBXI/QEhgdrV9qel jEdJsOPKiNu7GNOaGagv8RfGuD56dEBZtZMsHBbfdm6jZJnBKnsIQ5WpSMatz2c5 u1ALKXcUpEeCErqWIj9Dmlt7Lj5n8jlssiRkQlbvCE4NJjzAwVe6oBJG9DB3cfQ= =9ivO -----END PGP SIGNATURE----- --UugvWAfsgieZRqgk--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20140204203748.GA16522>