cvs commit: doc/en_US.ISO8859-1/books/handbook/kernelconfig chapter.sgml

[Johann Kois]

On 08.03.2011 19:48, Remko Lodder wrote:
> 
> On Mar 8, 2011, at 7:24 PM, Johann Kois wrote:
> 
>> -----BEGIN PGP SIGNED MESSAGE-----
>> Hash: SHA1
>>
>> On 03/08/2011 18:51, Kostik Belousov wrote:
>>> On Tue, Mar 08, 2011 at 05:46:12PM +0000, Johann Kois wrote:
>>>> 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.
>>> I do not believe this is true. Kernel should not have dependencies
>>> outside sys/.
>>
>> Well that was definitely true in the old days.  But things have changed
>> a couple of years ago.
>>
>> http://www.freebsd.org/cgi/cvsweb.cgi/doc/en_US.ISO8859-1/books/handbfullook/kernelconfig/chapter.sgml
>> (Revision 1.157).
>>
>> Or http://www.freebsd.org/cgi/query-pr.cgi?pr=75864
>>
>> Regards.
>>
>>
>> jkois
> 
> 
> 
> With Kostik's response included; should we go for the 'alternatively to only build the kernel do the "old" mumbojumbo' ?
> 

Hi all,

what about some hard facts instead of "...may work..."  "...should
work..." and "...I believe..."?  ;-)

Can we guarantee 100 % that the "traditional method" still works?  If
not, then the "traditional way" should stay where it is now (in the
developers handbook):

http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/kernelbuild.html:

"Up to version 4.X of FreeBSD this was the recommended way to build a
new kernel. It can still be used on newer versions (instead of the
“buildkernel” target of the toplevel /usr/src/ makefiles). Building the
kernel this way may be useful when working on the kernel code and it may
actually be faster than the “New” procedure when only a single option or
two were tweaked in the kernel configuration file. On the other hand, it
might lead to unexpected kernel build breakage when used by beginners on
newer versions of FreeBSD."

And the handbook (targeted not only but especially at new/less
experienced users) should describe the method we have recommended for
the last 5 years now (in the handbook and in the developers-handbook).

Regards.

jkois


-- 
Johann Kois
jkois(at)FreeBSD.org
FreeBSD Documentation Project
FreeBSD German Documentation Project - https://doc.bsdgroup.de