Bug 254276

Summary: FreeBSD 13.0-RELEASE Release Notes should mention OpenZFS, and loader incompatibility with zstd
Product: Documentation Reporter: Graham Perrin <grahamperrin>
Component: Books & ArticlesAssignee: FreeBSD Release Engineering <re>
Status: Closed FIXED    
Severity: Affects Many People CC: allanjude, freebsd, lwhsu
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   
URL: https://www.freebsd.org/releases/13.0R/relnotes/#storage

Description Graham Perrin freebsd_committer freebsd_triage 2021-03-14 12:24:17 UTC 
<https://www.freebsd.org/releases/13.0R/relnotes/> there's not yet any mention of OpenZFS (or ZFS). 

<https://cgit.freebsd.org/src/commit/UPDATING?id=5db7b015e9aa18e129d73992583491702e4a5206> recalls: 

> OpenZFS support has been integrated. 

… in particular: 

> Do not upgrade root pools until the loader is updated to support zstd. …
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2021-03-23 01:17:16 UTC 
<https://cgit.freebsd.org/doc/commit/website/content/en/releases/13.0R/relnotes.adoc?id=e0f1a3ae3b709e316b1db7b9a361d31f3fdb6d36> noted with thanks. 

The reference to <https://cgit.freebsd.org/src/commit/?id=9e5787d2284e> can be complemented with words to this effect (if still true): 

> The loader does not yet support zstd. Exercise caution with root pools. 

Note that two anchor points have identical subheadings 'Boot Loader Changes': 

<https://www.freebsd.org/releases/13.0R/relnotes/#boot>
<https://www.freebsd.org/releases/13.0R/relnotes/#boot-loader>
Comment 2 Graham Perrin freebsd_committer freebsd_triage 2021-03-25 17:11:28 UTC 
/usr/src/UPDATING still shows the warning, 

> Do not upgrade root pools until the loader is updated to support zstd. …

Today I discovered that support was added five months ago: 

<https://cgit.freebsd.org/src/commit/?id=2fec3ae8964c8864a9e75d6a2f0ed137ede489a7>
Comment 3 Graham Perrin freebsd_committer freebsd_triage 2021-03-25 17:12:51 UTC 
(In reply to Graham Perrin from comment #1)

> Note that two anchor points have identical subheadings 'Boot Loader Changes': 

The duplication is mentioned in another bug, which remains open.