Skip to content

Conversation

@osmium1
Copy link

@osmium1 osmium1 commented Dec 13, 2025

Adds documentation pages for Slackware package management utilities.

Checklist

  • The page(s) are in the correct platform directories: common, linux, osx, windows, sunos, android, etc.
  • The page description(s) have links to documentation or a homepage.
  • The page(s) follow the content guidelines.
  • The page(s) follow the style guide.
  • The PR contains at most 5 new pages.
  • The PR is authored by me, or has been human-reviewed if it was created with AI or machine translation software.
  • The PR title conforms to the recommended templates.
  • Version of the command being documented (if known): Slackware 15.0
  • Reference issue: Let's document: pkgtools #11874, Reach parity with cheat cheatsheets #3689

@github-actions github-actions bot added new command Issues requesting creation of a new page or PRs adding a new page for a command. review needed Prioritized PRs marked for reviews from maintainers. labels Dec 13, 2025
@Managor Managor mentioned this pull request Dec 13, 2025
7 tasks
@Managor
Copy link
Member

Managor commented Dec 13, 2025

makepkg will have to become a disambiguation page https://github.com/tldr-pages/tldr/blob/main/contributing-guides/style-guide.md#disambiguations

Do that in a separate PR


> 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>.
Copy link
Member

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

Copy link
Author

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?

Copy link
Member

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.

Copy link
Author

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?

Copy link
Author

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.

@osmium1
Copy link
Author

osmium1 commented Dec 13, 2025

Noted, I'll handle the makepkg disambiguation in a separate PR.


> 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>.
Copy link
Member

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

Copy link
Author

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

Copy link
Author

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.

Comment on lines +13 to +25
`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}}`
Copy link
Member

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?

Copy link
Author

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."

@Managor
Copy link
Member

Managor commented Dec 13, 2025

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>.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> 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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new command Issues requesting creation of a new page or PRs adding a new page for a command. review needed Prioritized PRs marked for reviews from maintainers.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants