[PATCH] www: mention /usr/src in upgrade notes

classic Classic list List threaded Threaded
6 messages Options
Reply | Threaded
Open this post in threaded view
|

[PATCH] www: mention /usr/src in upgrade notes

Simon Ruderich
Hello,

I'm a relatively new OpenBSD user and just updated my system from
5.9 to 6.0 but forgot to update the files in /usr/src. Thus when
I applied the latest patches (001-006) I actually built an old
5.9 kernel which failed to boot. The following patch mentions
/usr/src in the upgrade notes.

Regards
Simon

Index: upgrade60.html
===================================================================
RCS file: /cvs/www/faq/upgrade60.html,v
retrieving revision 1.11
diff -u -r1.11 upgrade60.html
--- upgrade60.html 14 Sep 2016 15:53:09 -0000 1.11
+++ upgrade60.html 18 Sep 2016 23:55:55 -0000
@@ -41,7 +41,8 @@
 <a href="faq8.html#Bootloader">boot loader</a> to boot this kernel.
 Once this kernel is booted, choose the <tt>(U)pgrade</tt> option and follow the
 prompts.
-Finish up by upgrading the packages: <tt><b>pkg_add -u</b></tt>.
+Finish up by upgrading the packages: <tt><b>pkg_add -u</b></tt>. Don't forget
+to update <tt>/usr/src</tt> if you're using it to build from source.
 
 <p>
 Alternatively, you can use the <a href="#NoInstKern">manual upgrade process</a>.

--
+ privacy is necessary
+ using gnupg http://gnupg.org
+ public key id: 0x92FEFDB7E44C32F9

signature.asc (817 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: [PATCH] www: mention /usr/src in upgrade notes

Theo Buehler
On Mon, Sep 19, 2016 at 01:59:20AM +0200, Simon Ruderich wrote:
> I'm a relatively new OpenBSD user and just updated my system from
> 5.9 to 6.0 but forgot to update the files in /usr/src. Thus when
> I applied the latest patches (001-006) I actually built an old
> 5.9 kernel which failed to boot. The following patch mentions
> /usr/src in the upgrade notes.

Thanks a lot for taking the time and submitting a patch. I will need to
think about this a little. I will probably end up adding a link to
errata.html since that is a more glaring omission on that page.

I think the real problem is that our documentation of -stable is
suboptimal in that there is this tangle of very similar, but
not-quite-the-same, information on stable.html, anoncvs.html and
faq5.html and none of these pages really cuts to the chase.

Improving this is on my to-do list for 6.1, but I haven't gotten around
to figuring out a good solution for that.  Moreover, I'm holding off
because there is ongoing work that might affect this:
http://undeadly.org/cgi?action=article&sid=20160911012316

Reply | Threaded
Open this post in threaded view
|

Re: [PATCH] www: mention /usr/src in upgrade notes

Simon Ruderich
On Mon, Sep 19, 2016 at 03:00:40AM +0200, Theo Buehler wrote:

> On Mon, Sep 19, 2016 at 01:59:20AM +0200, Simon Ruderich wrote:
>> I'm a relatively new OpenBSD user and just updated my system from
>> 5.9 to 6.0 but forgot to update the files in /usr/src. Thus when
>> I applied the latest patches (001-006) I actually built an old
>> 5.9 kernel which failed to boot. The following patch mentions
>> /usr/src in the upgrade notes.
>
> Thanks a lot for taking the time and submitting a patch. I will need to
> think about this a little. I will probably end up adding a link to
> errata.html since that is a more glaring omission on that page.
Hello,

I saw the addition of the errata and stable links. I think that's
an improvement, thanks.

However I still would like to see a quick note telling the user
that he should remember to update all source-based data because
the installer won't do it for them . Maybe something like "The
installer doesn't automatically update source files, for example
in /usr/src".

Regards
Simon
--
+ privacy is necessary
+ using gnupg http://gnupg.org
+ public key id: 0x92FEFDB7E44C32F9

signature.asc (817 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: [PATCH] www: mention /usr/src in upgrade notes

Theo de Raadt-2
> However I still would like to see a quick note telling the user
> that he should remember to update all source-based data because
> the installer won't do it for them . Maybe something like "The
> installer doesn't automatically update source files, for example
> in /usr/src".

Yeah, we could add a quick note.

Then when the next person suggests so, add another quick note.

And a quick note, and a quick note, and a quick note, and a quick
note, and soon the total isn't so quick.

That's what the FAQ is for.

Reply | Threaded
Open this post in threaded view
|

Re: [PATCH] www: mention /usr/src in upgrade notes

Philip Guenther-2
In reply to this post by Simon Ruderich
On Mon, Sep 19, 2016 at 7:12 PM, Simon Ruderich <[hidden email]> wrote:
...
> However I still would like to see a quick note telling the user
> that he should remember to update all source-based data because
> the installer won't do it for them . Maybe something like "The
> installer doesn't automatically update source files, for example
> in /usr/src".

Listing what something *doesn't* do is generally a bad plan, because
the list has no end, so where to draw the line becomes a matter of
opinion.  Better to list what the installer does update and say that's
the complete list, and then perhaps "Anything else previously
installed will need to be updated separately."


Philip Guenther

Reply | Threaded
Open this post in threaded view
|

Re: [PATCH] www: mention /usr/src in upgrade notes

Simon Ruderich
On Mon, Sep 19, 2016 at 07:25:08PM -0700, Philip Guenther wrote:
> Listing what something *doesn't* do is generally a bad plan, because
> the list has no end, so where to draw the line becomes a matter of
> opinion.  Better to list what the installer does update and say that's
> the complete list, and then perhaps "Anything else previously
> installed will need to be updated separately."

Sounds fine to me.

Regards
Simon
--
+ privacy is necessary
+ using gnupg http://gnupg.org
+ public key id: 0x92FEFDB7E44C32F9

signature.asc (817 bytes) Download Attachment