Skip to content

Commit

Permalink
update doc
Browse files Browse the repository at this point in the history
  • Loading branch information
leonzchang committed Dec 18, 2023
1 parent 291350b commit b0d78f1
Show file tree
Hide file tree
Showing 32 changed files with 0 additions and 370 deletions.
8 changes: 0 additions & 8 deletions src/doc/src/commands/cargo-add.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
# cargo-add(1)

## NAME

cargo-add --- Add dependencies to a Cargo.toml manifest file
Expand Down Expand Up @@ -67,7 +66,6 @@ which is defined by the <code>registry.default</code> config key which defaults
<code>crates-io</code>.</dd>



</dl>

### Section options
Expand Down Expand Up @@ -166,7 +164,6 @@ terminal.</li>
<p>May also be specified with the <code>term.color</code>
<a href="../reference/config.html">config value</a>.</dd>


</dl>

### Manifest Options
Expand All @@ -177,7 +174,6 @@ terminal.</li>
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>



<dt class="option-term" id="option-cargo-add--p"><a class="option-anchor" href="#option-cargo-add--p"></a><code>-p</code> <em>spec</em></dt>
<dt class="option-term" id="option-cargo-add---package"><a class="option-anchor" href="#option-cargo-add---package"></a><code>--package</code> <em>spec</em></dt>
<dd class="option-desc">Add dependencies to only the specified package.</dd>
Expand Down Expand Up @@ -206,7 +202,6 @@ See the <a href="cargo-fetch.html">cargo-fetch(1)</a> command to download depend
offline.</p>
<p>May also be specified with the <code>net.offline</code> <a href="../reference/config.html">config value</a>.</dd>


</dl>

### Common Options
Expand Down Expand Up @@ -249,19 +244,16 @@ requires the <code>-Z unstable-options</code> flag to enable (see

</dl>


## ENVIRONMENT

See [the reference](../reference/environment-variables.html) for
details on environment variables that Cargo reads.


## EXIT STATUS

* `0`: Cargo succeeded.
* `101`: Cargo failed to complete.


## EXAMPLES

1. Add `regex` as a dependency
Expand Down
22 changes: 0 additions & 22 deletions src/doc/src/commands/cargo-bench.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
# cargo-bench(1)

## NAME

cargo-bench --- Execute benchmarks of a package
Expand Down Expand Up @@ -80,7 +79,6 @@ as a whole.</dd>

</dl>


### Package Selection

By default, when no package selection options are given, the packages selected
Expand Down Expand Up @@ -109,12 +107,10 @@ double quotes around each pattern.</dd>
<dd class="option-desc">Benchmark all members in the workspace.</dd>



<dt class="option-term" id="option-cargo-bench---all"><a class="option-anchor" href="#option-cargo-bench---all"></a><code>--all</code></dt>
<dd class="option-desc">Deprecated alias for <code>--workspace</code>.</dd>



<dt class="option-term" id="option-cargo-bench---exclude"><a class="option-anchor" href="#option-cargo-bench---exclude"></a><code>--exclude</code> <em>SPEC</em>…</dt>
<dd class="option-desc">Exclude the specified packages. Must be used in conjunction with the
<code>--workspace</code> flag. This flag may be specified multiple times and supports
Expand All @@ -125,7 +121,6 @@ single quotes or double quotes around each pattern.</dd>

</dl>


### Target Selection

When no target selection options are given, `cargo bench` will build the
Expand Down Expand Up @@ -160,7 +155,6 @@ is set when the integration test is built so that it can use the
[`env` macro](https://doc.rust-lang.org/std/macro.env.html) to locate the
executable.


Passing target selection flags will benchmark only the specified
targets.

Expand All @@ -184,7 +178,6 @@ and supports common Unix glob patterns.</dd>
<dd class="option-desc">Benchmark all binary targets.</dd>



<dt class="option-term" id="option-cargo-bench---example"><a class="option-anchor" href="#option-cargo-bench---example"></a><code>--example</code> <em>name</em>…</dt>
<dd class="option-desc">Benchmark the specified example. This flag may be specified multiple times
and supports common Unix glob patterns.</dd>
Expand Down Expand Up @@ -230,7 +223,6 @@ manifest settings for the target.</dd>

</dl>


### Feature Selection

The feature flags allow you to control which features are enabled. When no
Expand Down Expand Up @@ -259,7 +251,6 @@ be specified multiple times, which enables all specified features.</dd>

</dl>


### Compilation Options

<dl>
Expand All @@ -275,19 +266,16 @@ target artifacts are placed in a separate directory. See the
<a href="../guide/build-cache.html">build cache</a> documentation for more details.</dd>



<dt class="option-term" id="option-cargo-bench---profile"><a class="option-anchor" href="#option-cargo-bench---profile"></a><code>--profile</code> <em>name</em></dt>
<dd class="option-desc">Benchmark with the given profile.
See <a href="../reference/profiles.html">the reference</a> for more details on profiles.</dd>



<dt class="option-term" id="option-cargo-bench---ignore-rust-version"><a class="option-anchor" href="#option-cargo-bench---ignore-rust-version"></a><code>--ignore-rust-version</code></dt>
<dd class="option-desc">Benchmark the target even if the selected Rust compiler is older than the
required Rust version as configured in the project’s <code>rust-version</code> field.</dd>



<dt class="option-term" id="option-cargo-bench---timings=fmts"><a class="option-anchor" href="#option-cargo-bench---timings=fmts"></a><code>--timings=</code><em>fmts</em></dt>
<dd class="option-desc">Output information how long each compilation takes, and track concurrency
information over time. Accepts an optional comma-separated list of output
Expand All @@ -306,7 +294,6 @@ information about timing information.</li>




</dl>

### Output Options
Expand All @@ -318,7 +305,6 @@ specified with the <code>CARGO_TARGET_DIR</code> environment variable, or the
<code>build.target-dir</code> <a href="../reference/config.html">config value</a>.
Defaults to <code>target</code> in the root of the workspace.</dd>


</dl>

### Display Options
Expand Down Expand Up @@ -358,7 +344,6 @@ terminal.</li>
<a href="../reference/config.html">config value</a>.</dd>



<dt class="option-term" id="option-cargo-bench---message-format"><a class="option-anchor" href="#option-cargo-bench---message-format"></a><code>--message-format</code> <em>fmt</em></dt>
<dd class="option-desc">The output format for diagnostic messages. Can be specified multiple times
and consists of comma-separated values. Valid values:</p>
Expand All @@ -382,7 +367,6 @@ coming from rustc are still emitted. Cannot be used with <code>human</code> or <
</ul></dd>



</dl>

### Manifest Options
Expand All @@ -393,7 +377,6 @@ coming from rustc are still emitted. Cannot be used with <code>human</code> or <
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>



<dt class="option-term" id="option-cargo-bench---frozen"><a class="option-anchor" href="#option-cargo-bench---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-bench---locked"><a class="option-anchor" href="#option-cargo-bench---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
Expand All @@ -417,7 +400,6 @@ See the <a href="cargo-fetch.html">cargo-fetch(1)</a> command to download depend
offline.</p>
<p>May also be specified with the <code>net.offline</code> <a href="../reference/config.html">config value</a>.</dd>


</dl>

### Common Options
Expand Down Expand Up @@ -460,7 +442,6 @@ requires the <code>-Z unstable-options</code> flag to enable (see

</dl>


### Miscellaneous Options

The `--jobs` argument affects the building of the benchmark executable but
Expand All @@ -477,7 +458,6 @@ parallel jobs to the number of logical CPUs plus provided value. If
a string <code>default</code> is provided, it sets the value back to defaults.
Should not be 0.</dd>


</dl>

While `cargo bench` involves compilation, it does not provide a `--keep-going`
Expand All @@ -493,13 +473,11 @@ stopping at the first failure. To "compile" as many benchmarks as possible, use
See [the reference](../reference/environment-variables.html) for
details on environment variables that Cargo reads.


## EXIT STATUS

* `0`: Cargo succeeded.
* `101`: Cargo failed to complete.


## EXAMPLES

1. Build and execute all the benchmarks of the current package:
Expand Down
Loading

0 comments on commit b0d78f1

Please sign in to comment.