Page MenuHomeFreeBSD
Files F163806223

D39474.id120060.diff
No OneTemporary
Actions

D39474.id120060.diff
View Options

diff --git a/documentation/content/en/books/handbook/cutting-edge/_index.adoc b/documentation/content/en/books/handbook/cutting-edge/_index.adoc
--- a/documentation/content/en/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/en/books/handbook/cutting-edge/_index.adoc
@@ -245,11 +245,35 @@
This is particularly helpful when maintaining multiple systems, as it allows for a quick assessment of the updates installed in each one.
[[freebsdupdate-upgrade]]
-=== Performing Major and Minor Version Upgrades
+=== Performing Minor and Major Version Upgrades
-Upgrades from one minor version of FreeBSD to another, like from FreeBSD 9.0 to FreeBSD 9.1, are called _minor version_ upgrades.
-_Major version_ upgrades occur when FreeBSD is upgraded from one major version to another, like from FreeBSD 9.X to FreeBSD 10.X.
-Both types of upgrades can be performed by providing `freebsd-update` with a release version target.
+Upgrades from one minor version of FreeBSD to another are called _minor version_ upgrades. An example:
+
+- FreeBSD 13.1 to 13.2.
+
+_Major version_ upgrades increase the major version number. An example:
+
+- FreeBSD 12.4 to 13.2.
+
+Both types of upgrade can be performed by providing `freebsd-update` with a release version target.
+
+[WARNING]
+====
+After each new `RELEASE`, FreeBSD package build servers will, for a limited period, *not* use newest version of the operating system.
+This provides continuity for the many users who do not upgrade immediately after a release announcement.
+For example:
+
+* packages for users of 13.1 and 13.2 will be built on a server running 13.1, until 13.1 reaches end of life
+
+-- and, critically:
+
+* a kernel module that is built on 13.1 might *not* be suitable for 13.2.
+
+So, with any minor or major OS upgrade, if your package requirements include any kernel module:
+
+* *be prepared to build the module from source*.
+
+====
[NOTE]
====

File Metadata

Mime Type
text/plain
Expires
Mon, Jul 27, 5:29 AM (9 h, 5 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
35572818
Default Alt Text
D39474.id120060.diff (1 KB)

Event Timeline