Bug 290915 - Handbook page for Jails uses 14.4-RELEASE in all example code
Summary: Handbook page for Jails uses 14.4-RELEASE in all example code
Status: New
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-doc (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2025-11-09 14:07 UTC by Andre Parker
Modified: 2025-11-12 06:54 UTC (History)
2 users (show)

See Also:


Attachments
Screeshot of a handbook page, showing example of above (150.89 KB, image/png)
2025-11-09 14:07 UTC, Andre Parker
no flags Details
0001-Handbook-use-existing-release-at-jail-examples.patch (21.80 KB, patch)
2025-11-12 06:54 UTC, Paavo-Einari Kaipila
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Andre Parker 2025-11-09 14:07:28 UTC
Created attachment 265291 [details]
Screeshot of a handbook page, showing example of above

Hi,

On a handbook page for Jails, all code examples use 14.4-RELEASE.
Which doesn't exists yet.

> # fetch https://download.freebsd.org/ftp/releases/amd64/amd64/14.4-RELEASE/base.txz -o /usr/local/jails/media/14.4-RELEASE-base.txz

It's confusing, because URL was the last thing I checked, when command didn't work. And when I see 14.4, my first reacrion was, "Wait, 14.4 released?"
I might expect older version an examples, but not future one.

It's not a big deal, but should probably be fixed.

Thx.
Comment 1 Marek Zarychta 2025-11-09 14:40:45 UTC
No worries, 14.4 will be released soon. 
And it's even better when a non-existent release is in examples. For network docs and examples, we also have specific address pools and subnets; the same applies to placeholders for programmers. We should appreciate such a clever approach and be grateful to the author of this section.
Comment 2 Andre Parker 2025-11-09 14:49:00 UTC
(In reply to Marek Zarychta from comment #1)
> No worries, 14.4 will be released soon.

> RELEASE announcement	10 March 2026

Four months of broken docs... ¯\_(ツ)_/¯
Comment 3 Marek Zarychta 2025-11-09 14:51:10 UTC
(In reply to Andre Parker from comment #2)
That's not broken, probably. When 14.4 is out, the handbook page will be updated with this regard and either 14.5 or 15.1 will appear in this section.
Comment 4 Paavo-Einari Kaipila 2025-11-12 06:54:37 UTC
Created attachment 265351 [details]
0001-Handbook-use-existing-release-at-jail-examples.patch