Skip to content
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

docs: use pacman -Syu in Arch Linux install instructions #7406

Draft
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

daemonburrito
Copy link

Use safest pacman incantation, '-Syu'. The outcome in package list state could be okay for a majority, but it's 100% safe to upgrade when installing.

From the Arch wiki:

Trivial docs, no issue.

Fix: #0000
Ref: #0000
Close: #0000


  • [ x] I searched the issue tracker and this hasn't been PRed before.

Use safest pacman incantation, '-Syu'. The outcome in package list state could be okay for a majority, but it's 100% safe to upgrade when installing.

From the Arch wiki:

* https://wiki.archlinux.org/title/Pacman#Installing_packages
* https://wiki.archlinux.org/title/System_maintenance#Partial_upgrades_are_unsupported (could happen...)
@daemonburrito daemonburrito requested a review from a team as a code owner September 11, 2023 17:23
@MithicSpirit
Copy link
Contributor

pacman -S is completely safe, the only issue is pacman -Sy since that updates the package list without updating the packages themselves. There is no need to update the system in this case (unless the system is so old that it cannot find the packages to install).

@daemonburrito
Copy link
Author

pacman -S is completely safe, the only issue is pacman -Sy since that updates the package list without updating the packages themselves. There is no need to update the system in this case (unless the system is so old that it cannot find the packages to install).

tldr Feel free to reject, read below for rationale to approve.

I did expect some push-back, and I stated my feelings about "100%" reliability when comes to the packages list. The "unless" is important, as is possible accidental "y"s. But in the end, it's legal to do -Sy. It just seems like it would be in a project's interest to instruct users in installation instructions with foolproof steps, especially with a "high impact, low probability" event like a broken packages list.

Thanks anyway for your time.

@MithicSpirit
Copy link
Contributor

Considering that these instructions are for Arch Linux, which is the very antonym of "foolproof", I think that this is fine. Maybe having an additional caveat to use pacman -Syu to update the system if the latest version is desired or if it cannot find the packages (exact message is warning: failed to retrieve some files followed by error: failed to commit transaction (failed to retrieve some files)), with possibly a warning against pacman -Sy, would be a good compromise though.

@hlissner hlissner added is:docs Pertains to the project's manual, output of help commands, or API documentation was:moved Is, was, or will be addressed elsewhere labels Sep 11, 2023
@hlissner hlissner marked this pull request as draft December 1, 2023 18:34
@hlissner hlissner added this to the core v3.0 milestone Dec 1, 2023
@hlissner hlissner changed the title Arch install, change pacman '-S' to '-Syu' docs: use pacman -Syu in Arch Linux install instructions Sep 1, 2024
@hlissner hlissner added the do not pr Not accepting PRs like this (check our do-not-PR list) label Sep 1, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
do not pr Not accepting PRs like this (check our do-not-PR list) is:docs Pertains to the project's manual, output of help commands, or API documentation was:moved Is, was, or will be addressed elsewhere
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants