From darklogik@pittgoth.com  Mon Dec 10 10:42:08 2001
Return-Path: <darklogik@pittgoth.com>
Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111])
	by hub.freebsd.org (Postfix) with ESMTP id 89B5B37B416
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 10 Dec 2001 10:42:07 -0800 (PST)
Received: (from darklogik@localhost)
	by pittgoth.com (8.11.6/8.11.6) id fBAIgVn02223;
	Mon, 10 Dec 2001 13:42:31 -0500 (EST)
	(envelope-from darklogik)
Message-Id: <200112101842.fBAIgVn02223@pittgoth.com>
Date: Mon, 10 Dec 2001 13:42:31 -0500 (EST)
From: Tom Rhodes <darklogik@pittgoth.com>
Reply-To: Tom Rhodes <darklogik@pittgoth.com>
To: FreeBSD-gnats-submit@freebsd.org
Subject: Kernel Config chapter could use touching up

>Number:         32679
>Category:       docs
>Synopsis:       Kernel Config chapter could use touching up
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    murray
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Dec 10 10:50:01 PST 2001
>Closed-Date:    Thu Dec 20 03:42:33 PST 2001
>Last-Modified:  Thu Dec 20 03:43:15 PST 2001
>Originator:     
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
>Environment:
>Description:
Handbook, Kernel config could use improvement

>How-To-Repeat:
Read, pretent your new, and ask youself "what if" and "could I"

>Fix:
Read this patch, if you like it, commit it, if you don't, edit or complain to me




*** chapter.old	Thu Dec  6 19:35:16 2001
--- chapter.sgml	Thu Dec  6 20:49:19 2001
***************
*** 111,117 ****
        </listitem>
  
        <listitem>
! 	<para>Less memory use.  A custom kernel often uses less memory
  	  than the <literal>GENERIC</literal> kernel, which is important
  	  because the kernel is one process that must always be present in
  	  memory.  For this reason, a custom kernel is especially useful
--- 111,117 ----
        </listitem>
  
        <listitem>
! 	<para>Less memory usage.  A custom kernel often uses less memory
  	  than the <literal>GENERIC</literal> kernel, which is important
  	  because the kernel is one process that must always be present in
  	  memory.  For this reason, a custom kernel is especially useful
***************
*** 160,166 ****
  	<username>root</username>, choosing <literal>Configure</literal>,
  	then <literal>Distributions</literal>, then
  	<literal>src</literal>, then <literal>sys</literal>.</para>
!     </note>
  
      <para>Next, move to the
        <filename><replaceable>arch</replaceable>/conf</filename> directory
--- 160,177 ----
  	<username>root</username>, choosing <literal>Configure</literal>,
  	then <literal>Distributions</literal>, then
  	<literal>src</literal>, then <literal>sys</literal>.</para>
!       <para>Another way we could do this is by using the commandline and
! 	typing out <screen><procedure>
! 	&prompt.root; <userinput>mount</userinput> /cdrom
! 	&prompt.root; <userinput>mkdir -p</userinput>
! 	    <filename>/usr/src/sys</filename>
!  	&prompt.root; <userinput>ln -s</userinput> /usr/src/sys
! 	     /sys
!  	&prompt.root; <userinput>cat /mnt/cdrom/sys/ssys.[a-d]* | tar
! 	     -xzvf</userinput>
! 	</procedure>
!  	</screen><para>
!      </note>
  
      <para>Next, move to the
        <filename><replaceable>arch</replaceable>/conf</filename> directory
***************
*** 202,210 ****
  	denied</errortype> errors.</para>
      </note>
  
!     <para>Now, edit <filename>MYKERNEL</filename> with your favorite text
!       editor.  If you are just starting out, the only editor available
!       will probably be <command>vi</command>, which is too complex to
        explain here, but is covered well in many books in the <link
        linkend="bibliography">bibliography</link>.  However, FreeBSD does
        offer an easier editor called <quote>ee</quote> which, if you are a
--- 213,227 ----
  	denied</errortype> errors.</para>
      </note>
  
!     <para>Alternativly you could store your entire config file inside the
! kernel itself and then use a command to extract it later.  This is a great
! idea if you have a significantly small <filename>/usr</filename> partition,
! and don't really wish to keep the sources around.  We will explain this
! procedure later.</para>
! 
!      <para>Now, edit <filename>MYKERNEL</filename> with
!       your favorite text editor.  If you are just starting out, the only editor
!       available will probably be <command>vi</command>, which is too complex to
        explain here, but is covered well in many books in the <link
        linkend="bibliography">bibliography</link>.  However, FreeBSD does
        offer an easier editor called <quote>ee</quote> which, if you are a
***************
*** 976,981 ****
--- 993,1008 ----
      <para>This is for an Iomega Zip drive.  It requires
        <literal>scbus</literal> and <literal>da</literal> support.  Best
        performance is achieved with ports in EPP 1.9 mode.</para>
+ 
+ 
+      <para>Uncomment this line to store this configuration file into your
+ 	kernel, you will be able to extract it later using the command
+ 	<screen><userinput>&prompt.root; strings -n 3 /kernel |sed 's/^__//p' >
+ 	<replaceable>MYKERNEL</replaceable</userinput></screen>
+ 	<programlist>#options	 INCLUDEC_CONFIG_FILE	 #Include this config
+ 	file</programlist></para>
+ 
+ 
  
      <programlisting># PCI Ethernet NICs.
  device          de         # DEC/Intel DC21x4x (<quote>Tulip</quote>)
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->feedback 
State-Changed-By: murray 
State-Changed-When: Mon Dec 10 22:46:03 PST 2001 
State-Changed-Why:  
Most of this patch has been committed.  Awaiting an updated patch from 
the submitter for the remaining part. 



Responsible-Changed-From-To: freebsd-doc->murray 
Responsible-Changed-By: murray 
Responsible-Changed-When: Mon Dec 10 22:46:03 PST 2001 
Responsible-Changed-Why:  
I'll follow up on this. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32679 

From: Murray Stokely <murray@FreeBSD.org>
To: Tom Rhodes <darklogik@pittgoth.com>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/32679: Kernel Config chapter could use touching up
Date: Mon, 10 Dec 2001 22:45:55 -0800

 On Mon, Dec 10, 2001 at 01:42:31PM -0500, Tom Rhodes wrote:
 > Read this patch, if you like it, commit it, if you don't, edit or complain to me
 
   Thanks for taking the time to do this.  I modified your patch and
 committed about half of it.  There were several problems.
 
 * It didn't even build, there were many structural problems.  Please
   test future patches before submitting, if you can.
 
 * There were many typos, in words and in SGML tags.
 
 * Your <screen> sections are all messed up, actually building the SGML
   that you write is essential to make sure it looks OK.
 
 * There were some whitespace problems with the way you indented
   paragraphs and such, please follow the standard way to do this
   described in the Doc Primer.
 
 * The part about INCLUDE_CONFIG and the reference to it in the
   previous section were akward but I couldn't immediately find a
   better place to stick this information.  If you can submit another
   patch with this stuff then it will be much easier to review
   (especially if you take care of the above). ;)
 
 Thanks for the submission!
 
        - Murray
State-Changed-From-To: feedback->closed 
State-Changed-By: murray 
State-Changed-When: Thu Dec 20 03:42:33 PST 2001 
State-Changed-Why:  
Please supply an updated patch for the remaining changes.  Thanks for 
your continued interest in helping us out! 


http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32679 
>Unformatted:
 >System: FreeBSD  5.0-CURRENT FreeBSD
 
