]> git.proxmox.com Git - cargo.git/commit - src/doc/src/commands/cargo-run.md
Stabilize `-Ztimings` as `--timings`
authorJosh Triplett <josh@joshtriplett.org>
Sun, 2 Jan 2022 02:47:04 +0000 (18:47 -0800)
committerJosh Triplett <josh@joshtriplett.org>
Mon, 31 Jan 2022 05:43:48 +0000 (21:43 -0800)
commitc06691897a749f8df425c62106b33813cdf11e3c
tree8d5704474c5a922b404485b4d27bdfcff5f99bc2
parent86bb4a0c2be26d4227fb7dd6d9e45154af646661
Stabilize `-Ztimings` as `--timings`

The `-Ztimings` option has existed for years, and many people use it to
profile and optimize their builds. It's one of the common reasons people
use nightly cargo.

The machine-readable JSON output may warrant further careful inspection
before we commit to a stable format. However, for the human-readable
output we don't need to make any commitment about the exact output.

Add a `--timings` option, as the stable equivalent to `-Ztimings`.
Stabilize the `html` output format, and require `-Zunstable-options` for
the `json` output format.

Document the new option, and update the testsuite.
59 files changed:
src/bin/cargo/commands/bench.rs
src/bin/cargo/commands/build.rs
src/bin/cargo/commands/check.rs
src/bin/cargo/commands/doc.rs
src/bin/cargo/commands/fix.rs
src/bin/cargo/commands/install.rs
src/bin/cargo/commands/run.rs
src/bin/cargo/commands/rustc.rs
src/bin/cargo/commands/rustdoc.rs
src/bin/cargo/commands/test.rs
src/cargo/core/compiler/build_config.rs
src/cargo/core/compiler/job_queue.rs
src/cargo/core/compiler/mod.rs
src/cargo/core/compiler/timings.rs
src/cargo/core/features.rs
src/cargo/util/command_prelude.rs
src/doc/man/cargo-bench.md
src/doc/man/cargo-build.md
src/doc/man/cargo-check.md
src/doc/man/cargo-doc.md
src/doc/man/cargo-fix.md
src/doc/man/cargo-install.md
src/doc/man/cargo-run.md
src/doc/man/cargo-rustc.md
src/doc/man/cargo-rustdoc.md
src/doc/man/cargo-test.md
src/doc/man/generated_txt/cargo-bench.txt
src/doc/man/generated_txt/cargo-build.txt
src/doc/man/generated_txt/cargo-check.txt
src/doc/man/generated_txt/cargo-doc.txt
src/doc/man/generated_txt/cargo-fix.txt
src/doc/man/generated_txt/cargo-install.txt
src/doc/man/generated_txt/cargo-run.txt
src/doc/man/generated_txt/cargo-rustc.txt
src/doc/man/generated_txt/cargo-rustdoc.txt
src/doc/man/generated_txt/cargo-test.txt
src/doc/man/includes/options-timings.md [new file with mode: 0644]
src/doc/src/commands/cargo-bench.md
src/doc/src/commands/cargo-build.md
src/doc/src/commands/cargo-check.md
src/doc/src/commands/cargo-doc.md
src/doc/src/commands/cargo-fix.md
src/doc/src/commands/cargo-install.md
src/doc/src/commands/cargo-run.md
src/doc/src/commands/cargo-rustc.md
src/doc/src/commands/cargo-rustdoc.md
src/doc/src/commands/cargo-test.md
src/doc/src/reference/unstable.md
src/etc/man/cargo-bench.1
src/etc/man/cargo-build.1
src/etc/man/cargo-check.1
src/etc/man/cargo-doc.1
src/etc/man/cargo-fix.1
src/etc/man/cargo-install.1
src/etc/man/cargo-run.1
src/etc/man/cargo-rustc.1
src/etc/man/cargo-rustdoc.1
src/etc/man/cargo-test.1
tests/testsuite/timings.rs