FreeBSD Handbook: OS upgrades: kernel modules #164
Conversation
<https://docs.freebsd.org/en/books/handbook/cutting-edge/#freebsdupdate-portsrebuild> for major OS upgrades includes: # pkg-static upgrade -f – but does not forewarn that a FreeBSD-provided package of a kernel module might be unusable with the upgraded OS. Add a warning to an earlier part of this section of the chapter.
|
This will partially fix FreeBSD bug 270338 – FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements. |
lsalvadore
requested review from
dbaio and
sergio-carlavilla
and removed request for
dbaio and
sergio-carlavilla
|
Sorry for the added reviewers: it was a mistake, I wanted to add them on another pull request. |
This comment was marked as outdated.
This comment was marked as outdated.
Change stable/9 to stable/13. Change most other examples that are relevant to current situation – 13.2-RELEASE announcement expected tomorrow. (Where this commit intentionally refrains from changing relevant examples: additional minor changes to wording may be appropriate. These can be drafted post-release.)
Remove trailing white spaces.
| @@ -259,7 +259,7 @@ Both types of upgrade can be performed by providing `freebsd-update` with a rele | |||
|
|
|||
| [WARNING] | |||
| ==== | |||
| After each new `RELEASE`, FreeBSD package build servers will, for a limited period, *not* use the newest version of the operating system. | |||
| After each new `RELEASE`, FreeBSD package build servers will, for a limited period, *not* use the newer version of the operating system. | |||
There was a problem hiding this comment.
For future reference:
- this first sentence is not accurate – not entirely true.
If I had made the paragraph accurate, then the (relative) complexity would have detracted from the key point of the warning.
Generally, I try to avoid warning boxes and note boxes – their presence sometimes signals an underlying need to restructure things.
In this case, I chose a warning box because we were approaching the date of release of 13.2.
(It's easier/quicker to gain approval to commit a condensed warning, than it is to gain approval for a broader restructure.)
https://docs.freebsd.org/en/books/handbook/cutting-edge/#freebsdupdate-portsrebuild for major OS upgrades includes:
# pkg-static upgrade -f– but does not forewarn that a FreeBSD-provided package of a kernel module might be unusable with the upgraded OS.
Add a warning to an earlier part of this section of the chapter.