Subject: Re: chap-kernel fixes
To: Daniel de Kok <danieldk@pobox.com>
From: Pavel Cahyna <pavel.cahyna@st.cuni.cz>
List: netbsd-docs
Date: 08/13/2004 19:09:17
On Fri, 13 Aug 2004 12:08:37 +0000, Daniel de Kok wrote:

> I propose to make the changes in the attached patch to fix chap-kern
> a bit. Any comments/objections/...?

Thanks.

> ...
> @@ -313,31 +300,32 @@
>  ...
>  options PCKBD_LAYOUT="KB_IT"</programlisting>

the section about modifying kernel sources looks a bit scary here, and
also unprofessional (if the modification is so desirable, why hasn't
it been integrated already?). Maybe it should be moved to the chapter
about wscons?

>  
> -    <para>The <filename>adjustkernel</filename> Perl script, which can be
> -      found at <ulink url="http://www.feyrer.de/Misc/adjustkernel"></ulink>,
> -      analizes the output of &man.dmesg.8; and
> +    <para>
> +      The <filename>adjustkernel</filename> Perl script, which is

I don't know almost anything about Docbook, but why <filename> here
and <command> a few lines lower?

> +      available through pkgsrc analyzes the output of &man.dmesg.8; and
>        automatically generates a minimal configuration file.
> -      To run it you need to have Perl installed on your system.
> -      The installation of new software is described in detail
> -      in the <xref linkend="chap-pack" />.
> -      If you want to install Perl now, download the pre-compiled package
> -      <filename>perl-5.00404.tgz</filename> and write the following command:</para>
> -
> -    <screen>&rprompt; <userinput>pkg_add perl-5.00404.tgz</userinput></screen>
> +      The installation of packages is described extensively in 
> +      in the <xref linkend="chap-pack" />, but installing
> +      <command>adjustkernel</command> basically boils down to:
> +    </para>

Also, the table which gives kernel compile times on various hardware
seems really too optimistic.

Bye	Pavel