From nobody@FreeBSD.ORG  Fri Aug  4 06:54:00 2000
Return-Path: <nobody@FreeBSD.ORG>
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id 397CC37B5F6; Fri,  4 Aug 2000 06:54:00 -0700 (PDT)
Message-Id: <20000804135400.397CC37B5F6@hub.freebsd.org>
Date: Fri,  4 Aug 2000 06:54:00 -0700 (PDT)
From: jeffblaine@mediaone.net
Sender: nobody@FreeBSD.ORG
To: freebsd-gnats-submit@FreeBSD.org
Subject: Tracking STABLE instructions should explicitly state you need src-all for STABLE
X-Send-Pr-Version: www-1.0

>Number:         20398
>Category:       docs
>Synopsis:       Tracking STABLE instructions should explicitly state you need src-all for STABLE
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Aug 04 07:00:01 PDT 2000
>Closed-Date:    Fri Aug 4 15:30:03 PDT 2000
>Last-Modified:  Fri Aug  4 15:40:01 PDT 2000
>Originator:     Jeff Blaine
>Release:        4.0-RELEASE
>Organization:
>Environment:
FreeBSD kickflop 4.0-RELEASE FreeBSD 4.0-RELEASE #0: Fri Jul 28 09:39:54 EDT 200
0     root@kickflop:/usr/src/sys/compile/BUNK  i386
>Description:
In the Handbook, under advanced topics, the docs on tracking -STABLE
do not mention that you _must_ CVS update src-all.  There is only a
pointer to a stable-cvsupfile, inside of which it is not clear at
all what you _have_ to do to track STABLE (and maybe other branches?).

The stable-cvsupfile leads one to believe that there are choices,
yet when wanting to track STABLE, there are not (that I can tell).
It's src-all or nothing.
>How-To-Repeat:
Try to upgrade your 4.0-RELEASE machine's kernel to 4.0-STABLE by
only CVS updating from src-sys.  It doesn't work.
>Fix:


>Release-Note:
>Audit-Trail:

From: Jim Mock <jim@jmock.com>
To: jeffblaine@mediaone.net
Cc: freebsd-gnats-submit@FreeBSD.ORG
Subject: Re: docs/20398: Tracking STABLE instructions should explicitly state you need src-all for STABLE
Date: Fri, 4 Aug 2000 14:59:22 -0700

 On Fri, 04 Aug 2000 at 06:54:00 -0700, jeffblaine@mediaone.net wrote:
 > >Number:         20398
 > >Category:       docs
 > >Synopsis:       Tracking STABLE instructions should explicitly state you need src-all for STABLE
 > >Confidential:   no
 > >Severity:       non-critical
 > >Priority:       low
 > >Responsible:    freebsd-doc
 > >State:          open
 
 [snip..]
 
 > >Description:
 > In the Handbook, under advanced topics, the docs on tracking -STABLE
 > do not mention that you _must_ CVS update src-all.  There is only a
 > pointer to a stable-cvsupfile, inside of which it is not clear at
 > all what you _have_ to do to track STABLE (and maybe other branches?).
 > 
 > The stable-cvsupfile leads one to believe that there are choices,
 > yet when wanting to track STABLE, there are not (that I can tell).
 > It's src-all or nothing.
 > >How-To-Repeat:
 > Try to upgrade your 4.0-RELEASE machine's kernel to 4.0-STABLE by
 > only CVS updating from src-sys.  It doesn't work.
 
 That's part of your problem right there.  You don't update to -STABLE by
 just upgrading your kernel.  You build world which is explained in the
 handbook.  At any rate, here's a proposed patch for the stable-supfile.
 Comments are appreciated.
 
 Index: stable-supfile
 ===================================================================
 RCS file: /mnt/src/share/examples/cvsup/stable-supfile,v
 retrieving revision 1.21
 diff -u -r1.21 stable-supfile
 --- stable-supfile	2000/07/09 16:03:53	1.21
 +++ stable-supfile	2000/08/04 21:58:55
 @@ -78,7 +78,8 @@
  #
  # The easiest way to get the main source tree is to use the "src-all"
  # mega-collection.  It includes all of the individual "src-*" collections,
 -# except the export-restricted collections.
 +# except the export-restricted collections.  Please note:  If you want
 +# to track -STABLE, you will want to leave "src-all" uncommented.
  src-all
  
  # These are the individual collections that make up "src-all".  If you
 
 - jim
 
 -- 
 jim mock <jim@jmock.com>        work: jim@osd.bsdi.com | jim@FreeBSD.org
 http://soupnazi.org/              BSDi Open Source Div | http://bsdi.com
 

From: "Jeff Blaine" <jeffblaine@mediaone.net>
To: <jim@jmock.com>
Cc: <freebsd-gnats-submit@FreeBSD.ORG>
Subject: Re: docs/20398: Tracking STABLE instructions should explicitly state you need src-all for STABLE
Date: Fri, 4 Aug 2000 18:22:22 -0700

 > > How to repeat:
 > > Try to upgrade your 4.0-RELEASE machine's kernel to 4.0-STABLE by
 > > only CVS updating from src-sys.  It doesn't work.
 > 
 > That's part of your problem right there.  You don't update to -STABLE by
 > just upgrading your kernel.  You build world which is explained in the
 > handbook.  At any rate, here's a proposed patch for the stable-supfile.
 > Comments are appreciated.
 
 Right, all I was getting at is...I don't see anywhere in the handbook
 where it says, "Kernel-only upgrades are not done in the FreeBSD world.
 To upgrade your kernel, you need to start tracking sys-all entirely
 in either -CURRENT or -STABLE entirely."
 
 Seems silly until you consider how many people use Linux where upgrading
 only the kernel very much a part of monthly life for those people who
 live on the bleeding edge (by choice, I'm not one of those people of
 course).
 
 Maybe I didn't look hard enough, but I really didn't find anything
 like that, so I was left in the land of wing-it.
 
 ...and your patch _should_ do the trick to stop this from happening,
 but I'm wondering if something more obvious than a trailing comment
 in the CVS update file isn't order.  But that's not my call.
 
 Thanks for your time.
 
 
State-Changed-From-To: open->closed 
State-Changed-By: jim 
State-Changed-When: Fri Aug 4 15:30:03 PDT 2000 
State-Changed-Why:  
Notes added to the relevant supfiles.  Thanks! 

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

From: Jim Mock <jim@jmock.com>
To: Jeff Blaine <jeffblaine@mediaone.net>
Cc: freebsd-gnats-submit@FreeBSD.ORG
Subject: Re: docs/20398: Tracking STABLE instructions should explicitly state you need src-all for STABLE
Date: Fri, 4 Aug 2000 15:27:23 -0700

 On Fri, 04 Aug 2000 at 18:22:22 -0700, Jeff Blaine wrote:
 > > > How to repeat:
 > > > Try to upgrade your 4.0-RELEASE machine's kernel to 4.0-STABLE by
 > > > only CVS updating from src-sys.  It doesn't work.
 > > 
 > > That's part of your problem right there.  You don't update to
 > > -STABLE by just upgrading your kernel.  You build world which is
 > > explained in the handbook.  At any rate, here's a proposed patch for
 > > the stable-supfile.  Comments are appreciated.
 > 
 > Right, all I was getting at is...I don't see anywhere in the handbook
 > where it says, "Kernel-only upgrades are not done in the FreeBSD
 > world.  To upgrade your kernel, you need to start tracking sys-all
 > entirely in either -CURRENT or -STABLE entirely."
 
 Hmm, I think it's there somewhere, but I can't remember off-hand where.
 Maybe it's in the FAQ.  I'll have to look.
 
 > Seems silly until you consider how many people use Linux where
 > upgrading only the kernel very much a part of monthly life for those
 > people who live on the bleeding edge (by choice, I'm not one of those
 > people of course).
 > 
 > Maybe I didn't look hard enough, but I really didn't find anything
 > like that, so I was left in the land of wing-it.
 > 
 > ...and your patch _should_ do the trick to stop this from happening,
 
 Ok, I'll commit it in a few minutes.
 
 > but I'm wondering if something more obvious than a trailing comment
 > in the CVS update file isn't order.  But that's not my call.
 
 Agreed.  If I can't find it in the FAQ or handbook, I'll add it in there
 somewhere.
 
 - jim
 
 -- 
 jim mock <jim@jmock.com>        work: jim@osd.bsdi.com | jim@FreeBSD.org
 http://soupnazi.org/              BSDi Open Source Div | http://bsdi.com
 
>Unformatted:
