In message <[EMAIL PROTECTED]> John Baldwin writes:
: On 22-Jan-01 Warner Losh wrote:
: > In message <[EMAIL PROTECTED]> Mike Meyer writes:
: >: Warner Losh <[EMAIL PROTECTED]> 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
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

Fortunately the doc changes are relatively easy to make.


P.S.  The following should do the trick:

Index: chapter.sgml
RCS file: 
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 [EMAIL PROTECTED]
with "unsubscribe freebsd-current" in the body of the message

Reply via email to