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

Mention brew install rustup-init in the user guide #3466

Merged
merged 2 commits into from
Oct 5, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions doc/user-guide/book.toml
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,6 @@ title = "The rustup book"
edit-url-template = "https://github.com/rust-lang/rustup/edit/master/doc/user-guide/{path}"
git-repository-url = "https://github.com/rust-lang/rustup/tree/master/doc/user-guide"
site-url = "https://rust-lang.github.io/rustup/"

[output.html.redirect]
"/installation/package-managers.html" = "already-installed-rust.html"
4 changes: 2 additions & 2 deletions doc/user-guide/src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@
[Introduction](index.md)
- [Installation](installation/index.md)
- [Windows](installation/windows.md)
- [MSVC Prerequistes](installation/windows-msvc.md)
- [MSVC prerequisites](installation/windows-msvc.md)
- [Other installation methods](installation/other.md)
- [Package managers](installation/package-managers.md)
- [Already installed Rust?](installation/already-installed-rust.md)
- [Concepts](concepts/index.md)
- [Channels](concepts/channels.md)
- [Toolchains](concepts/toolchains.md)
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Package managers
# Already installed Rust?

Several Linux distributions package Rust, and you may wish to use the packaged
toolchain, such as for distribution package development. You may also wish to
Expand Down
28 changes: 28 additions & 0 deletions doc/user-guide/src/installation/other.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,32 @@ $ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --default
$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --profile minimal --default-toolchain nightly
```


## Using a package manager

> Please note that the rustup project is not maintaining any package mentioned in this section.
> If you have encountered any problems installing `rustup` with a package manager,
> please contact the package maintainer(s) for further information.
rami3l marked this conversation as resolved.
Show resolved Hide resolved

### Homebrew

You can use `brew` to install `rustup-init`[^not-rust]:

```sh
$ brew install rustup-init
```

Then execute `rustup-init` to proceed with the installation.

When the installation is complete,
make sure that `$HOME/.cargo/bin` is in your `$PATH`,
and you should be able to use `rustup` normally.

[^not-rust]: This is not to be confused with the `rust` package,
which is a `brew`-managed `rust` toolchain installation.

## Manual installation

If you prefer you can directly download `rustup-init` for the platform of your
choice:

Expand Down Expand Up @@ -106,6 +132,8 @@ choice:
You can fetch an older version from
`https://static.rust-lang.org/rustup/archive/{rustup-version}/{target-triple}/rustup-init[.exe]`

## Self-compiled installation

To install `rustup` from source, check out the git repository from
<https://github.com/rust-lang/rustup> and run `cargo run --release`. Note that
after installation the `rustup` toolchains will supersede any pre-existing
Expand Down