15.0R/relnote: Improve upgrading with packages

[ziaee]

Summary

I've been hacking on this some more, how's this? I simplified the
language and found additional instructions in handbook/cutting-edge.

[grahamperrin]

website/content/en/releases/15.0R/relnotes.adoc

74

Is the intention to encompass upgrades from 14?

[ziaee]

website/content/en/releases/15.0R/relnotes.adoc

74

The change on this line is to simplify the text. What we have currently is too much, and it isn't even complete, right?

IIUC, *all* pkgbase upgrades to 15.0R from any previous version are unsupported.

[grahamperrin]

website/content/en/releases/15.0R/relnotes.adoc

74

78

80

The published edition seemed clearer, although it needs a minor correction, and can be rephrased in a different way.

89

Avoid this word in the context of pkg-add(8).

103

As explained in a previous review, and elsewhere:

• an existing /usr/local/etc/pkg/repos/FreeBSD.conf should not be overwritten.

104–111

The ABI for PRERELEASE, ALPHA, and BETA was no different from the ABI for RELEASE.

Also, we can not assume AMD64.

[grahamperrin]

website/content/en/releases/15.0R/relnotes.adoc

90

91

The phrase system software is vague. It can mean the combination of base + the ports collection.

[pi]

Will it also explain pkgbasify ? what is needed if after an fbsd-up from 14.x to 15.0, we want to convert to pkgbase ?

[grahamperrin]

Orientation

1. https://github.com/freebsd/freebsd-doc/tree/main/documentation/content/en/books/handbook/cutting-edge
2. https://docs.freebsd.org/en/books/handbook/cutting-edge/ (2025-11-19)
3. https://web.archive.org/web/20251205193110/https://docs.freebsd.org/en/books/handbook/cutting-edge/ (2025-12-05)
4. https://github.com/freebsd/freebsd-doc/tree/main/documentation/content/en/books/handbook
5. https://docs.freebsd.org/en/books/handbook/book/
6. https://web.archive.org/web/20260101155011/https://docs.freebsd.org/en/books/handbook/book/ (2026-01-01) 🎉

[grahamperrin]

In D54433#1244080, @pi wrote:

Will it also explain pkgbasify ?

https://docs.freebsd.org/en/books/handbook/cutting-edge/#_converting_a_host_to_use_freebsd_base includes a link to https://github.com/FreeBSDFoundation/pkgbasify.

The FreeBSD Handbook describes six main tasks. The inconsistency between the Handbook and the authoritative page was noted in a previous review, it can be corrected in a separate review.

[ziaee]

I think my text still could use improvement, but to me almost all of these suggestions is going the wrong way towards "explain them to death".

website/content/en/releases/15.0R/relnotes.adoc

89

Which word?

[ziaee]

In D54433#1244080, @pi wrote:

Will it also explain pkgbasify ?

Not as far as I've planned. Each subsection only explains updating systems through their upgrade path. Maybe we should say something to that effect?

what is needed if after an fbsd-up from 14.x to 15.0, we want to convert to pkgbase ?

I have no idea.