We should document that double-clicking rustup-init may not work properly
Open
Nobody has claimed this yet.
E-easy
E-mentor
enhancement
- Dominant language
- Rust
- Stars
- 7k
- Forks
- 1.1k
- Avg merge
- 22h 40m
- Merged PRs (30d)
- 46
Description
Problem
On Windows, if you run rustup-init.exe by double clicking the executable, it wouldn't detect custom paths in CARGO_HOME and RUSTUP_HOME and install to the default path.
Steps
- Set the variables
CARGO_HOMEandRUSTUP_HOMEvia command line (setx ... /m) or Windows GUI - Double click the
rustup-init.exeexecutable - Answer
Yto the initial prompt regarding having to install additional dependencies - On the next screen, observe the incorrect paths being presented
- Proceed with the installation. Choose default installation
- Observe the absence of the installed app in the paths described by
CARGO_HOMEandRUSTUP_HOME - Observe the app being located in the default location (
%USERPROFILE%\.cargo\and%USERPROFILE%\.rustup\respectively)
Workaround
- Open a separate
cmdinstance - Navigate to the
rustup-init.exefile and run it - Observe correct paths being displayed
- Observe the app being installed into
CARGO_HOMEandRUSTUP_HOMEproperly
Notes
Windows version: Version 10.0.19042 Build 19042
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Review the existing Windows installation documentation for rustup-init.exe and the reproduction steps in this issue. Document that double-clicking may ignore CARGO_HOME and RUSTUP_HOME, while running the executable from cmd respects them; verify the wording against both launch methods.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- cli, documentation, operating-systems
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100