Skip to content

docs: explain using symlinks for the usual command names - #1697

Open
ddy314 wants to merge 1 commit into
trifectatechfoundation:mainfrom
ddy314:docs/symlink-command-names
Open

ddy314 wants to merge 1 commit into
trifectatechfoundation:mainfrom
ddy314:docs/symlink-command-names

Conversation

@ddy314

@ddy314 ddy314 commented Oct 3, 2026

Copy link
Copy Markdown

Describe the changes done on this pull request

Document using /usr/local/bin symlinks when a distribution packages sudo-rs with suffixed command names. Explain PATH ordering, absolute-path invocations, existing aliases, and how to undo the setup; prefer the distribution's selection mechanism when one is available.

Fixes #1478, following the maintainer's suggestion to document system-wide symlinks.

Validated the example in temporary directories with dummy executables: PATH lookup selects the linked executable, absolute paths still select the original, ln -s refuses an existing destination, and removing the links restores the original PATH lookup. No system installation was changed. git diff --check passes; Rust checks are not applicable to this README-only change.

Pull Request Checklist

  • I have read and accepted the code of conduct for this project.
  • I have tested, formatted and ran clippy over my changes. (Documentation-only validation described above.)
  • I have commented and documented my changes.
  • This pull request will fix an issue where a proper discussion about a solution has taken place: Recommend to set as symlink rather than alias #1478.

Document the /usr/local/bin option discussed in trifectatechfoundation#1478, including PATH precedence and distribution-managed alternatives.

This branch has not been deployed

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Recommend to set as symlink rather than alias

1 participant