Skip to content

Conversation

tim-blackbird
Copy link
Contributor

As of rust-lang/cargo#10245 --timings has been stabilized.
Update profiling.md to reflect this.

## Project Compile Times

This requires nightly rust (`rustup default nightly`). Append ```-Ztimings``` to your app's cargo command (ex: `cargo build -Ztimings`). If you want a "full" profile, make sure you run `cargo clean` first. Open the produced `cargo-timing.html` file in your browser of choice. This will show how much time each crate in your app's dependency tree took to build.
Append ```--timings``` to your app's cargo command (ex: `cargo build --timings`). If you want a "full" profile, make sure you run `cargo clean` first. Open the produced `cargo-timing.html` file in your browser of choice. This will show how much time each crate in your app's dependency tree took to build.
Copy link
Contributor

Choose a reason for hiding this comment

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

With the stabilized --timings option cargo doesn't save a cargo-timing.html in the currect directory anymore, but instead writes it to the target directory and logs its location:

Timing report saved to /home/user/.cache/rust/cargo-timings/cargo-timing-20220526T190433Z.html

We should tweak the text to make that more clear.

@alice-i-cecile alice-i-cecile added C-Docs An addition or correction to our documentation C-Performance A change motivated by improving speed, memory usage or compile times A-Meta About the project itself labels May 30, 2022
@alice-i-cecile
Copy link
Member

Once the comment above is addressed I'm happy to merge this.

@alice-i-cecile
Copy link
Member

bors r+

bors bot pushed a commit that referenced this pull request May 30, 2022
…4850)

As of rust-lang/cargo#10245 `--timings` has been stabilized.
Update profiling.md to reflect this.

Co-authored-by: devil-ira <[email protected]>
@bors
Copy link
Contributor

bors bot commented May 30, 2022

Build failed (retrying...):

bors bot pushed a commit that referenced this pull request May 30, 2022
…4850)

As of rust-lang/cargo#10245 `--timings` has been stabilized.
Update profiling.md to reflect this.

Co-authored-by: devil-ira <[email protected]>
@bors
Copy link
Contributor

bors bot commented May 30, 2022

Build failed:

Co-authored-by: Alice Cecile <[email protected]>
@alice-i-cecile
Copy link
Member

bors r+

bors bot pushed a commit that referenced this pull request May 30, 2022
…4850)

As of rust-lang/cargo#10245 `--timings` has been stabilized.
Update profiling.md to reflect this.

Co-authored-by: devil-ira <[email protected]>
@bors bors bot changed the title Cargo --timings option has been stabilized. Update profiling.md. [Merged by Bors] - Cargo --timings option has been stabilized. Update profiling.md. May 30, 2022
@bors bors bot closed this May 30, 2022
@tim-blackbird tim-blackbird deleted the patch-1 branch May 30, 2022 22:05
james7132 pushed a commit to james7132/bevy that referenced this pull request Jun 7, 2022
…evyengine#4850)

As of rust-lang/cargo#10245 `--timings` has been stabilized.
Update profiling.md to reflect this.

Co-authored-by: devil-ira <[email protected]>
ItsDoot pushed a commit to ItsDoot/bevy that referenced this pull request Feb 1, 2023
…evyengine#4850)

As of rust-lang/cargo#10245 `--timings` has been stabilized.
Update profiling.md to reflect this.

Co-authored-by: devil-ira <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-Meta About the project itself C-Docs An addition or correction to our documentation C-Performance A change motivated by improving speed, memory usage or compile times
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants