[howtos] Add some instructions regarding ABI changes #5

Merged
meena merged 2 commits from evilham/pkgbase-website:main into main 3 months ago
evilham commented 3 months ago

These instructions are a tad friendlier and have a more "I want to upgrade my
system" perspective than what is on the FreeBSD wiki at:
https://wiki.freebsd.org/PkgBase#Major_version_upgrades

These instructions are a tad friendlier and have a more "I want to upgrade my system" perspective than what is on the FreeBSD wiki at: https://wiki.freebsd.org/PkgBase#Major_version_upgrades
evilham added 1 commit 3 months ago
72b1647908
[howtos] Add some instructions regarding ABI changes
evilham force-pushed main from 72b1647908 to 1ae8bac379 3 months ago
Poster

Bah :-D git and signing are hard things. Supposedly my forced push fixes it, but it is not updating here, it did update on the fork though

Bah :-D git and signing are hard things. Supposedly my forced push fixes it, but it is not updating here, it did update on the [fork](https://codeberg.org/evilham/website/commit/1ae8bac379b39aed95afcde20d9423f399ccb4f0) though
meena requested changes 3 months ago
meena left a comment

just adding the document won't make it build

you'll have to add it to the makefile

i'd also add a see also section to the bootstrapping document that links to this upgrading document

---
title: "Howto: freebsd-update (-ish). ABI changes"
meena commented 3 months ago
Poster
Owner

let's follow the pr description here , and call this an upgrade

we can add use cases, or draw comparisons in the text

let's follow the pr description here , and call this an upgrade we can add use cases, or draw comparisons in the text
evilham marked this conversation as resolved
If instead of using `"https://alpha.pkgbase.live/release/${ABI}/latest"` as the [`pkg(8)`][pkg8] repository we hardcode the `ABI` (by using `FreeBSD:13:amd64` instead of `${ABI}`), we may get an error like:
pkg8: https://man.freebsd.org/pkg(8)
meena commented 3 months ago
Poster
Owner

please stick to the existing link style of using inline links

this breaks the reading flow of the markdown document

so if you want to introduce them, they need to all go at the end of a section or the end of the document

please stick to the existing link style of using inline links this breaks the reading flow of the markdown document so if you want to introduce them, they need to all go at the end of a section or the end of the document
evilham marked this conversation as resolved
This will enable us to upgrade (possibly even downgrade, that's likely not officially supported!) to a different FreeBSD version.
E.g. to change from 12.1-RELEASE to 13.0-RELEASE, we can run:
meena commented 3 months ago
Poster
Owner

i can never remember what eg vs ie means , so let's expand this to "for example"

i can never remember what eg vs ie means , so let's expand this to "for example"
evilham marked this conversation as resolved
howto/index.md Outdated
Due to its size, we'll split this howto into three parts:
- [Bootstrapping an Existing Installation](/howto/bootstrap.html)
- [freebsd-update (-ish): ABI changes](/howto/abi-changes.html)
meena commented 3 months ago
Poster
Owner

as mentioned above, I'm not happy with this title

as mentioned above, I'm not happy with this title
evilham marked this conversation as resolved
evilham added 1 commit 3 months ago
Poster

Sounds good, thanks for taking the time; hope it looks alright now ^^.

PS: Emacs did its thing and removed tariling space >,< didn't notice before commit, hope that's alright.

Sounds good, thanks for taking the time; hope it looks alright now ^^. PS: Emacs did its thing and removed tariling space >,< didn't notice before commit, hope that's alright.
meena approved these changes 3 months ago
meena left a comment

👍

meena merged commit d2ac1c09ff into main 3 months ago

Reviewers

meena approved these changes 3 months ago
The pull request has been merged as d2ac1c09ff.
Sign in to join this conversation.
No reviewers
No Label
No Milestone
No project
No Assignees
2 Participants
Notifications
Due Date

No due date set.

Dependencies

This pull request currently doesn't have any dependencies.

Loading…
There is no content yet.