Date: Mon, 22 Jan 2001 16:25:10 -0700 From: Warner Losh <imp@harmony.village.org> To: John Baldwin <jhb@FreeBSD.ORG> Cc: Peter Wemm <peter@netplex.com.au>, The Hermit Hacker <scrappy@hub.org>, freebsd-current@FreeBSD.ORG, "Donald J . Maddox" <dmaddox@sc.rr.com>, Kris Kennaway <kris@FreeBSD.ORG>, Mike Meyer <mwm@mired.org> Subject: Re: lastest kernel from cvs ( sh exists with signal 8 ) Message-ID: <200101222325.f0MNPA913286@harmony.village.org> In-Reply-To: Your message of "Mon, 22 Jan 2001 13:34:17 PST." <XFMail.010122133417.jhb@FreeBSD.org> References: <XFMail.010122133417.jhb@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
In message <XFMail.010122133417.jhb@FreeBSD.org> John Baldwin writes: : : On 22-Jan-01 Warner Losh wrote: : > In message <14956.39955.318792.388889@guru.mired.org> Mike Meyer writes: : >: Warner Losh <imp@harmony.village.org> types: : >: > It is in the handbook, and has been for some time. I'm reviewing the : >: > recent KERNEL -> KERNCONF changes to make sure that they make it into : >: > the handbook properly (I assume there will be a MFC in a few days, : >: > since putting KERNEL in /etc/make.conf is a setup for disaster right : >: > now). : >: : >: Could you also make sure it makes it into /etc/defaults/make.conf : >: (KERNEL isn't mentioned there at all) and make.conf(5)? : > : > That's really Peter's job since he made the change without any lead : > time at all to resolve issues like this. I'll see what I can do to : > backstop things, but it really isn't my baby. When people change : > things that have impact in different parts of the whole tree, they : > should be the ones to make the changes to those different parts of the : > tree, or at least submit patches to the maintainers of those parts of : > the tree. : : Erm, if it wasn't documented in the first place, making a change doesn't : put the burden of documenting the old behavior on the person making the change. It was in the handbook, explicitly documented. Nothing undocumented about it. If I were to change how ls worked in some way, I'd be exepcted to update the man page for ls. This is no different than that. This is the documented way to build kernels, see http://www.freebsd.org/handbook/kernelconfig-building.html for the current instructions. They have been in there since at least 1.29 (alex 15-Jul-00): &prompt.root; <userinput>make... 1.29 (alex 15-Jul-00): &prompt.root; <userinput>make... when alex added them. That's at least 6 months ago. They have been in UPDATING longer than that. : Are there any kernel manpages for all of the oldcard and newcard API's floating : around btw? (As an example.) Neither have ever been documented. Eventually newcard will be documented. However, that's fundamentally different. We have maybe 5 NEWCARD folks hacking drivers right now. We have easily 50,000 folks running current, following the previously published instructions which are now inaccurate. Fortunatley, the change is now in UPDATING. : I agree it should be documented, but just : because Peter made the change doesn't mean that the onus that the people who : originally did buildkernel didn't bother to document it in places like : make.conf(5) should fall on Peter. I disagree. Peter made a fairly major change that needs many documentation changes to document the change. Yes, it was a small change, but it is how we are telling people to build things in the handbook. Fortunately the doc changes are relatively easy to make. Warner P.S. The following should do the trick: Index: chapter.sgml =================================================================== RCS file: /home/imp/FreeBSD/CVS/doc/en_US.ISO_8859-1/books/handbook/kernelconfig/chapter.sgml,v retrieving revision 1.36 diff -u -r1.36 chapter.sgml --- chapter.sgml 2000/08/10 02:09:18 1.36 +++ chapter.sgml 2001/01/22 23:20:48 @@ -167,8 +167,8 @@ following commands:</para> <screen>&prompt.root; <userinput>cd /usr/src</userinput> -&prompt.root; <userinput>make buildkernel KERNEL=MYKERNEL</userinput> -&prompt.root; <userinput>make installkernel KERNEL=MYKERNEL</userinput></screen> +&prompt.root; <userinput>make buildkernel KERNCONF=MYKERNEL</userinput> +&prompt.root; <userinput>make installkernel KERNCONF=MYKERNEL</userinput></screen> <para>If you have <emphasis>not</emphasis> upgraded your source tree in any way (you have not run <application>CVSup</application>, To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200101222325.f0MNPA913286>