Skip to content

Mention sccache in the guide #4464

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

Merged
merged 1 commit into from
Sep 9, 2017
Merged

Conversation

matklad
Copy link
Member

@matklad matklad commented Sep 3, 2017

Closes #4307

@rust-highfive
Copy link

r? @steveklabnik

(rust_highfive has picked a reviewer for you, use r? to override)

src/doc/guide.md Outdated
Cargo shares build artifacts among all the packages of a single workspaces.
If you want to share build results across different workspaces, you can use
[sccache]. For the minimal setup, install sccache with `cargo install sccache`
and add `export RUSTC_WRAPPER=sccache` to the shell init script.
Copy link
Member Author

@matklad matklad Sep 3, 2017

Choose a reason for hiding this comment

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

export RUSTC_WRAPPER=sccache is horribly Unix specific, but I don't know a better way of saying: "Hey, you need to set up this env var to this value, and you must do it on every login, it's not a one-time thing".

Copy link
Member

Choose a reason for hiding this comment

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

Perhaps this could mention the environment variable and then say something like "for example if you're using a bash shell you can do..."

@matklad
Copy link
Member Author

matklad commented Sep 5, 2017

r? @alexcrichton

src/doc/guide.md Outdated
## Build cache

Cargo shares build artifacts among all the packages of a single workspaces.
If you want to share build results across different workspaces, you can use
Copy link
Member

Choose a reason for hiding this comment

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

Perhaps this could explicitly call out that this feature isn't built-in to cargo today but sccache, a third party tool, can be used to achieve similar results?

@matklad matklad force-pushed the document-all-the-things branch from f86e5e3 to 13bb7bd Compare September 9, 2017 14:45
@matklad
Copy link
Member Author

matklad commented Sep 9, 2017

Updated!

@alexcrichton
Copy link
Member

@bors: r+

@bors
Copy link
Contributor

bors commented Sep 9, 2017

📌 Commit 13bb7bd has been approved by alexcrichton

@bors
Copy link
Contributor

bors commented Sep 9, 2017

⌛ Testing commit 13bb7bd with merge db2e07f...

bors added a commit that referenced this pull request Sep 9, 2017
@bors
Copy link
Contributor

bors commented Sep 9, 2017

☀️ Test successful - status-appveyor, status-travis
Approved by: alexcrichton
Pushing db2e07f to master...

@bors bors merged commit 13bb7bd into rust-lang:master Sep 9, 2017
@matklad matklad deleted the document-all-the-things branch September 14, 2017 23:21
@ehuss ehuss added this to the 1.22.0 milestone Feb 6, 2022
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.

Document how to use sccache with Cargo
6 participants