I've been hacking on this some more, how's this? I simplified the
language and found additional instructions in handbook/cutting-edge.
Details
Details
- Reviewers
grahamperrin - Group Reviewers
releng doceng docs pkgbase
Diff Detail
Diff Detail
- Repository
- R9 FreeBSD doc repository
- Lint
Lint Skipped - Unit
Tests Skipped - Build Status
Buildable 69543 Build 66426: arc lint + arc unit
Event Timeline
| website/content/en/releases/15.0R/relnotes.adoc | ||
|---|---|---|
| 74 | Is the intention to encompass upgrades from 14? | |
| 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. | |
| 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:
| |
| 104–111 | The ABI for PRERELEASE, ALPHA, and BETA was no different from the ABI for RELEASE. Also, we can not assume AMD64. | |
Comment Actions
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 ?
Comment Actions
Orientation
- https://github.com/freebsd/freebsd-doc/tree/main/documentation/content/en/books/handbook/cutting-edge
- https://docs.freebsd.org/en/books/handbook/cutting-edge/ (2025-11-19)
- https://web.archive.org/web/20251205193110/https://docs.freebsd.org/en/books/handbook/cutting-edge/ (2025-12-05)
- https://github.com/freebsd/freebsd-doc/tree/main/documentation/content/en/books/handbook
- https://docs.freebsd.org/en/books/handbook/book/
- https://web.archive.org/web/20260101155011/https://docs.freebsd.org/en/books/handbook/book/ (2026-01-01) 🎉
Comment Actions
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.
Comment Actions
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? | |
Comment Actions
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.
Comment Actions
… to me almost all of these suggestions is going the wrong way towards "explain them to death". …
More to the point:
- did the suggestions help to end misunderstandings?
People who know my style of writing do know that in general, I prefer conciseness. https://people.freebsd.org/~grahamperrin/style/writing/tips/
Comment Actions
What misunderstandings?
Nobody has commented here to say they misunderstood these proposed changes. Or to say they helped, for that matter.
People who know me know that I'm a true Scotsman. https://en.wikipedia.org/wiki/No_true_Scotsman
Please don't do this. Please don't let me do this if I start either.