Bug 150124

Summary:	Request for update of "building the kernel" section of the handbook
Product:	Documentation	Reporter:	Jared <blahbleh666>
Component:	Books & Articles	Assignee:	Johann Kois <jkois>
Status:	Closed FIXED
Severity:	Affects Only Me
Priority:	Normal
Version:	Latest
Hardware:	Any
OS:	Any

Description Jared 2010-08-30 18:00:06 UTC

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!

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).
How-To-Repeat: Try building a kernel whilst following the page.  You will not succeed due to lack of additional source code sets.

Comment 1 Johann Kois freebsd_committer

2010-10-29 00:42:48 UTC

-----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-----

Comment 2 Jason 2011-03-08 01:23:45 UTC

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

Comment 3 Johann Kois freebsd_committer

2011-03-08 09:41:25 UTC

-----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-----

Comment 4 Johann Kois freebsd_committer

2011-03-08 09:59:09 UTC

Responsible Changed
From-To: freebsd-doc->jkois

Take this one.

Comment 5 dfilter service freebsd_committer

2011-03-08 17:46:26 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"

Comment 6 Johann Kois freebsd_committer

2011-03-10 08:19:58 UTC

State Changed
From-To: open->closed

The change to the documentation is now online.  Close this PR.