From nobody@FreeBSD.org  Mon Aug 30 16:51:53 2010
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id E5EBC1065693
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 30 Aug 2010 16:51:53 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id D5C2E8FC34
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 30 Aug 2010 16:51:53 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o7UGprTF005644
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 30 Aug 2010 16:51:53 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o7UGpr3e005643;
	Mon, 30 Aug 2010 16:51:53 GMT
	(envelope-from nobody)
Message-Id: <201008301651.o7UGpr3e005643@www.freebsd.org>
Date: Mon, 30 Aug 2010 16:51:53 GMT
From: Jared  <blahbleh666@hotmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Request for update of "building the kernel" section of the handbook
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         150124
>Category:       docs
>Synopsis:       Request for update of "building the kernel" section of the handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    jkois
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Mon Aug 30 17:00:06 UTC 2010
>Closed-Date:    Thu Mar 10 08:21:14 UTC 2011
>Last-Modified:  Thu Mar 10 08:21:14 UTC 2011
>Originator:     Jared
>Release:        i386 8.1-REL
>Organization:
>Environment:
(sorry I don't have this handy, but I don't think it's necessary)
>Description:
I'm having difficulty building and installing a new kernel while following the handbook:

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-building.html

it appears that this page especially is out of date.  It only mentions the requirement of ssys and sbase distribution sets, but much googling (as I run into each problem) suggests that more sets of sources are necessary.  I eventually installed them all, because I don't know which are necessary.  Another page that could use some help is the description of the configuration file:

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-config.html

as it no longer matches the config file in i386 very closely.

I (and probably many others) would appreciate if these pages were corrected.  Pretty please? :)

Much thanks for all that you do!
>How-To-Repeat:
Try building a kernel whilst following the page.  You will not succeed due to lack of additional source code sets.
>Fix:
I installed all the sources and it satisfied all requirements.  Surely not every set is necessary for a vanilla compile (I was just adding sound support and removing support for hardware i don't have).

>Release-Note:
>Audit-Trail:

From: Johann Kois <jkois@FreeBSD.org>
To: bug-followup@FreeBSD.org, blahbleh666@hotmail.com
Cc:  
Subject: Re: docs/150124: Request for update of "building the kernel" section
 of the handbook
Date: Thu, 28 Oct 2010 23:42:48 +0000

 -----BEGIN PGP SIGNED MESSAGE-----
 Hash: SHA1
 
 Well, as a matter of fact you DO need all the sources to build a custom
 kernel (this has been changed some time ago).  And
 http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-building.html
 is telling you that (as a note, maybe it should be a warning and at the
 beginning of this section):
 
 "Note: It is required to have full FreeBSD source tree to build the kernel."
 
 See also
 http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/kernelbuild.html
 
 
 jkois
 
 - -- 
  Johann Kois
  jkois(at)FreeBSD.org
  FreeBSD Documentation Project
  FreeBSD German Documentation Project - https://doc.bsdgroup.de
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v2.0.15 (FreeBSD)
 Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
 
 iEYEARECAAYFAkzKCngACgkQ/rDr791hwtjIMwCePbUVGOzy+w1jeUfb+hu+LANS
 JyYAoJQLW7F075xZrBuqlH/9b7ub2aEe
 =wBRM
 -----END PGP SIGNATURE-----

From: Jason Helfman <jhelfman@e-e.com>
To: bug-followup@freebsd.org
Cc: docs@freebsd.org
Subject: Re: docs/150124
Date: Mon, 7 Mar 2011 17:23:45 -0800

 Is there any reason this pr remains open?
 
 -jgh
 -- 
 Jason Helfman
 System Administrator
 experts-exchange.com
 http://www.experts-exchange.com/M_4830110.html
 E4AD 7CF1 1396 27F6 79DD  4342 5E92 AD66 8C8C FBA5

From: Johann Kois <jkois@FreeBSD.org>
To: Jason Helfman <jhelfman@e-e.com>
Cc: bug-followup@FreeBSD.org, docs@FreeBSD.org
Subject: Re: docs/150124
Date: Tue, 08 Mar 2011 10:41:25 +0100

 -----BEGIN PGP SIGNED MESSAGE-----
 Hash: SHA1
 
 On 03/08/2011 02:23, Jason Helfman wrote:
 > Is there any reason this pr remains open?
 > 
 > -jgh
 
 No special reason.  The same as with all other open PRs.  Lack of
 manpower and no patch provided.  :(
 
 But I will take this one now and see if can come up with something
 better.  But this will again take some time.
 
 jkois
 
 
 - -- 
  Johann Kois
  jkois(at)FreeBSD.org
  FreeBSD Documentation Project
  FreeBSD German Documentation Project - https://doc.bsdgroup.de
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v2.0.17 (FreeBSD)
 Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
 
 iEYEARECAAYFAk11+cUACgkQ/rDr791hwtiZDwCfVqv7B9GTWMlaB9IUTGqzATE5
 SCkAni1hfOU087IxhILVuUliriWMp6Tw
 =Gdbx
 -----END PGP SIGNATURE-----
Responsible-Changed-From-To: freebsd-doc->jkois 
Responsible-Changed-By: jkois 
Responsible-Changed-When: Tue Mar 8 09:59:09 UTC 2011 
Responsible-Changed-Why:  
Take this one. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=150124 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/150124: commit references a PR
Date: Tue,  8 Mar 2011 17:46:26 +0000 (UTC)

 jkois       2011-03-08 17:46:12 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/kernelconfig chapter.sgml 
   Log:
   PR:     docs/150124
   
   Fix/Update the instructions on "how to build a custom kernel".
   
   - The fact that you need the whole source tree for this is well hidden at the moment.
   - The instructions on how to extract the src tree from a CD are wrong (changed pathnames).
   - In order to extract the full src tree you would need 20 cat/tar commands.  So remove that part.
   - While here do some additional rewording.
   
   Noticed by:     Jared (blahbleh666 ett hotmail dott com)
   
   Revision  Changes    Path
   1.196     +24 -28    doc/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: jkois 
State-Changed-When: Thu Mar 10 08:19:58 UTC 2011 
State-Changed-Why:  
The change to the documentation is now online.  Close this PR. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=150124 
>Unformatted:
