-
-
Notifications
You must be signed in to change notification settings - Fork 5k
explodepkg, pkgdiff, pkgtool, upgradepkg: add pages #19984
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Conversation
|
Do that in a separate PR |
pages/linux/pkgdiff.md
Outdated
|
|
||
| > Compare the contents of two Slackware packages. | ||
| > See also: `installpkg`, `removepkg`, `upgradepkg`, `makepkg`, `pkgtool`. | ||
| > More information: <https://www.slackbook.org/html/package-management-package-utilities.html>. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I wasn't able to find any mention of pkgdiff from the entire book. https://www.slackbook.org/html/book.html
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
pkgdiff does exist in Slackware's pkgtools - it's authored by Patrick Volkerding. The man page is here: https://slackware.nl/slackware/slackware64-current/source/a/pkgtools/manpages/pkgdiff.8
It's just not documented in the Slackbook. Should I update the More information URL to point to this man page?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not this page. It's not very readable. If you could find a link where the groff page is preformatted in a way that it's browser accessible, that would be great.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I couldn't find a browser-formatted version of the man page. Should I remove pkgdiff from this PR for now?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Removed pkgdiff from this PR - no browser-readable documentation available.
|
Noted, I'll handle the makepkg disambiguation in a separate PR. |
Co-authored-by: Managor <[email protected]>
Co-authored-by: Managor <[email protected]>
Co-authored-by: Managor <[email protected]>
|
|
||
| > Interactive menu-driven tool for managing Slackware packages. | ||
| > See also: `installpkg`, `removepkg`, `upgradepkg`, `makepkg`. | ||
| > More information: <https://www.slackbook.org/html/book.html#PACKAGE-MANAGEMENT-PACKAGE-UTILITIES-PKGTOOL>. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Would you happen to know of a link that instructs more on how to use this from the CLI. This is very barebones and I need something to verify the page.
The best I could find was this but it's not very official. https://cleveruptime.com/docs/commands/pkgtool
I also found this, but it's not very browser accessible nor does the documentation match this page or the previous link https://mirror.ihost.md/?dir=slackware/slackware64/source/a/pkgtools/manpages
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The official Slackware config page has some CLI info: https://www.slackware.com/config/packages.php
The pkgtool section in the Slackbook also covers it (though it focuses on the interactive menu): https://www.slackbook.org/html/book.html#PACKAGE-MANAGEMENT-PACKAGE-UTILITIES-PKGTOOL
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Didn't realize the slackbook link was already referenced, apologies. But yes it is the best official documentation available for pkgtool.
| `sudo upgradepkg --install-new {{path/to/package.tgz}}` | ||
|
|
||
| - Reinstall a package (even if the same version is already installed): | ||
|
|
||
| `sudo upgradepkg --reinstall {{path/to/package.tgz}}` | ||
|
|
||
| - Preview what would happen without actually upgrading: | ||
|
|
||
| `upgradepkg --dry-run {{path/to/package.tgz}}` | ||
|
|
||
| - Upgrade a package and show detailed progress: | ||
|
|
||
| `sudo upgradepkg --verbose {{path/to/package.tgz}}` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Where do these options come from?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
From the Slackware man page: https://slackware.nl/slackware/slackware64-current/source/a/pkgtools/manpages/upgradepkg.8
The options are documented there:
- --dry-run: "Output a report about which packages would be installed or upgraded but don't actually perform the upgrades."
- --verbose: "Show all the gory details of the upgrade."
|
Nono, the pkgdiff page can stay. We just need to find the best available documentation. If it is the groff link, then so be it. |
|
|
||
| > Upgrade Slackware packages by replacing existing packages with new versions. | ||
| > See also: `installpkg`, `removepkg`, `makepkg`, `pkgtool`. | ||
| > More information: <https://www.slackbook.org/html/book.html#PACKAGE-MANAGEMENT-PACKAGE-UTILITIES-UPGRADEPKG>. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| > More information: <https://www.slackbook.org/html/book.html#PACKAGE-MANAGEMENT-PACKAGE-UTILITIES-UPGRADEPKG>. | |
| > More information: <https://slackware.nl/slackware/slackware64-current/source/a/pkgtools/manpages/upgradepkg.8>. |
As much as it pains me, lets use the groff page for this too. I'll email the guy who runs manned.org if he's willing to take in slackware man pages. For now, this will have to do.
Adds documentation pages for Slackware package management utilities.
Checklist
common,linux,osx,windows,sunos,android, etc.