Auto merge of #13168 - leonzchang:handlebars-v4, r=epage

chore(deps): update rust crate handlebars to `v4.5.0`

In the latest version of `handlebars`, rules for whitespace auto elimination is to check if the directive `{{# xxx}}`` and ``{{/ xxx}}` is holding a whole line, with leading and trailing whitespaces counted, and then remove the trailing NEWLINE (See [`template.rs`](9d7d555628/src/template.rs (L568-L889))).

```md
{{#options}}
                              <--- this newline will be removed after a standalone block
{{#option "`-o` _outdir_"}}
                              <--- this newline will be removed
Some content

{{/option}}
                              <--- this newline will be removed
{{/options}}
                              <--- this newline will be removed
```

This PR changes includes (fixes #13162):
1. update `handlebars` crate to `v4.5.0`.
2. add extra NEWLINE to helper blocks `options`, `option` to align with the new strip rules, preserving the original behavior.
3. update doc(the rest handlebars expression) to align with the new strip rules..
This commit is contained in:
bors 2023-12-20 14:52:29 +00:00
commit c21be2b7cf
42 changed files with 68 additions and 441 deletions

119
Cargo.lock generated
View file

@ -72,9 +72,9 @@ dependencies = [
[[package]]
name = "anstyle-query"
version = "1.0.1"
version = "1.0.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a3a318f1f38d2418400f8209655bfd825785afd25aa30bb7ba6cc792e4596748"
checksum = "e28923312444cdd728e4738b3f9c9cac739500909bb3d3c94b43551b16517648"
dependencies = [
"windows-sys 0.52.0",
]
@ -304,7 +304,7 @@ dependencies = [
"shell-escape",
"snapbox",
"supports-hyperlinks",
"syn 2.0.39",
"syn 2.0.41",
"tar",
"tempfile",
"time",
@ -672,9 +672,9 @@ dependencies = [
[[package]]
name = "crossbeam-channel"
version = "0.5.8"
version = "0.5.9"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a33c2bf77f2df06183c3aa30d1e96c0695a313d4f9c453cc3762a6db39f99200"
checksum = "14c3242926edf34aec4ac3a77108ad4854bffaa2e4ddc1824124ce59231302d5"
dependencies = [
"cfg-if",
"crossbeam-utils",
@ -682,9 +682,9 @@ dependencies = [
[[package]]
name = "crossbeam-deque"
version = "0.8.3"
version = "0.8.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ce6fd6f855243022dcecf8702fef0c297d4338e226845fe067f6341ad9fa0cef"
checksum = "fca89a0e215bab21874660c67903c5f143333cab1da83d041c7ded6053774751"
dependencies = [
"cfg-if",
"crossbeam-epoch",
@ -693,22 +693,21 @@ dependencies = [
[[package]]
name = "crossbeam-epoch"
version = "0.9.15"
version = "0.9.16"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ae211234986c545741a7dc064309f67ee1e5ad243d0e48335adc0484d960bcc7"
checksum = "2d2fe95351b870527a5d09bf563ed3c97c0cffb87cf1c78a591bf48bb218d9aa"
dependencies = [
"autocfg",
"cfg-if",
"crossbeam-utils",
"memoffset",
"scopeguard",
]
[[package]]
name = "crossbeam-utils"
version = "0.8.16"
version = "0.8.17"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5a22b2d63d4d1dc0b7f1b6b2747dd0088008a9be28b6ddf0b1e7d335e3037294"
checksum = "c06d96137f14f244c37f989d9fff8f95e6c18b918e71f36638f8c49112e4c78f"
dependencies = [
"cfg-if",
]
@ -878,9 +877,9 @@ checksum = "5443807d6dff69373d433ab9ef5378ad8df50ca6298caf15de6e52e24aaf54d5"
[[package]]
name = "erased-serde"
version = "0.3.31"
version = "0.4.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "6c138974f9d5e7fe373eb04df7cae98833802ae4b11c24ac7039a21d5af4b26c"
checksum = "a3286168faae03a0e583f6fde17c02c8b8bba2dcc2061d0f7817066e5b0af706"
dependencies = [
"serde",
]
@ -1127,7 +1126,7 @@ dependencies = [
"bstr",
"btoi",
"gix-date",
"itoa 1.0.9",
"itoa 1.0.10",
"thiserror",
"winnow",
]
@ -1251,7 +1250,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "468dfbe411f335f01525a1352271727f8e7772075a93fa747260f502086b30be"
dependencies = [
"bstr",
"itoa 1.0.9",
"itoa 1.0.10",
"thiserror",
"time",
]
@ -1407,7 +1406,7 @@ dependencies = [
"gix-lock",
"gix-object",
"gix-traverse",
"itoa 1.0.9",
"itoa 1.0.10",
"libc",
"memmap2",
"rustix",
@ -1434,7 +1433,7 @@ checksum = "02a5bcaf6704d9354a3071cede7e77d366a5980c7352e102e2c2f9b645b1d3ae"
dependencies = [
"proc-macro2",
"quote",
"syn 2.0.39",
"syn 2.0.41",
]
[[package]]
@ -1466,7 +1465,7 @@ dependencies = [
"gix-features 0.36.1",
"gix-hash",
"gix-validate",
"itoa 1.0.9",
"itoa 1.0.10",
"smallvec",
"thiserror",
"winnow",
@ -1841,16 +1840,16 @@ checksum = "eabb4a44450da02c90444cf74558da904edde8fb4e9035a9a6a4e15445af0bd7"
[[package]]
name = "handlebars"
version = "3.5.5"
version = "4.5.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4498fc115fa7d34de968184e473529abb40eeb6be8bc5f7faba3d08c316cb3e3"
checksum = "faa67bab9ff362228eb3d00bd024a4965d8231bbb7921167f0cfa66c6626b225"
dependencies = [
"log",
"pest",
"pest_derive",
"quick-error 2.0.1",
"serde",
"serde_json",
"thiserror",
"walkdir",
]
@ -1887,9 +1886,9 @@ checksum = "7f24254aa9a54b5c858eaee2f5bccdb46aaf0e486a595ed5fd8f86ba55232a70"
[[package]]
name = "hkdf"
version = "0.12.3"
version = "0.12.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "791a029f6b9fc27657f6f188ec6e5e43f6911f6f878e0dc5501396e09809d437"
checksum = "7b5f8eb2ad728638ea2c7d47a21db23b7b58a72ed6a38256b8a1849f15fbbdf7"
dependencies = [
"hmac",
]
@ -2021,9 +2020,9 @@ checksum = "b71991ff56294aa922b450139ee08b3bfc70982c6b2c7562771375cf73542dd4"
[[package]]
name = "itoa"
version = "1.0.9"
version = "1.0.10"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "af150ab688ff2122fcef229be89cb50dd66af9e01a4ff320cc137eecc9bacc38"
checksum = "b1a46d1a171d865aa5f83f92695765caa047a9b4cbae2cbf37dbd613a793fd4c"
[[package]]
name = "jobserver"
@ -2072,9 +2071,9 @@ checksum = "884e2677b40cc8c339eaefcb701c32ef1fd2493d71118dc0ca4b6a736c93bd67"
[[package]]
name = "libc"
version = "0.2.150"
version = "0.2.151"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "89d92a4743f9a61002fae18374ed11e7973f530cb3a3255fb354818118b2203c"
checksum = "302d7ab3130588088d277783b1e2d2e10c9e9e4a16dd9050e6ec93fb3e7048f4"
[[package]]
name = "libgit2-sys"
@ -2312,9 +2311,9 @@ dependencies = [
[[package]]
name = "once_cell"
version = "1.18.0"
version = "1.19.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "dd8b5dd2ae5ed71462c540258bedcb51965123ad7e7ccf4b9a8cafaa4a63576d"
checksum = "3fdb12b2476b595f9358c5161aa467c2438859caa136dec86c26fdd2efe17b92"
[[package]]
name = "oorandom"
@ -2356,7 +2355,7 @@ checksum = "a948666b637a0f465e8564c73e89d4dde00d72d4d473cc972f390fc3dcee7d9c"
dependencies = [
"proc-macro2",
"quote",
"syn 2.0.39",
"syn 2.0.41",
]
[[package]]
@ -2481,9 +2480,9 @@ dependencies = [
[[package]]
name = "pasetors"
version = "0.6.7"
version = "0.6.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ba765699a309908d55950919a3445e9491453e89b2587b1b2abe4143a48894c0"
checksum = "6b36d47c66f2230dd1b7143d9afb2b4891879020210eddf2ccb624e529b96dba"
dependencies = [
"ct-codecs",
"ed25519-compact",
@ -2552,7 +2551,7 @@ dependencies = [
"pest_meta",
"proc-macro2",
"quote",
"syn 2.0.39",
"syn 2.0.41",
]
[[package]]
@ -2692,12 +2691,6 @@ version = "1.2.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a1d01941d82fa2ab50be1e79e6714289dd7cde78eba4c074bc5a4374f650dfe0"
[[package]]
name = "quick-error"
version = "2.0.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a993555f31e5a609f617c12db6250dedcac1b0a85076912c436e6fc9b2c8e6a3"
[[package]]
name = "quote"
version = "1.0.33"
@ -2886,9 +2879,9 @@ dependencies = [
[[package]]
name = "rustix"
version = "0.38.26"
version = "0.38.28"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9470c4bf8246c8daf25f9598dca807fb6510347b1e1cfa55749113850c79d88a"
checksum = "72e572a5e8ca657d7366229cdde4bd14c4eb5499a9573d4d366fe1b599daa316"
dependencies = [
"bitflags 2.4.1",
"errno",
@ -2904,16 +2897,16 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "cb3dcc6e454c328bb824492db107ab7c0ae8fcffe4ad210136ef014458c1bc4f"
dependencies = [
"fnv",
"quick-error 1.2.3",
"quick-error",
"tempfile",
"wait-timeout",
]
[[package]]
name = "ryu"
version = "1.0.15"
version = "1.0.16"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1ad4cc8da4ef723ed60bced201181d83791ad433213d8c24efffda1eec85d741"
checksum = "f98d2aa92eebf49b69786be48e4477826b256916e84a57ff2a4f21923b48eb4c"
[[package]]
name = "same-file"
@ -3003,9 +2996,9 @@ dependencies = [
[[package]]
name = "serde-untagged"
version = "0.1.1"
version = "0.1.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0ba3ac59c62f51b75a6bfad8840b2ede4a81ff5cc23c200221ef479ae75a4aa3"
checksum = "c38885c2d9d8f038478583b7acf8f6029d020ba4b20e9dcaeb8799d67a04aae7"
dependencies = [
"erased-serde",
"serde",
@ -3029,7 +3022,7 @@ checksum = "43576ca501357b9b071ac53cdc7da8ef0cbd9493d8df094cd821777ea6e894d3"
dependencies = [
"proc-macro2",
"quote",
"syn 2.0.39",
"syn 2.0.41",
]
[[package]]
@ -3047,7 +3040,7 @@ version = "1.0.108"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3d1c7e3eac408d115102c4c24ad393e0821bb3a5df4d506a80f85f7a742a526b"
dependencies = [
"itoa 1.0.9",
"itoa 1.0.10",
"ryu",
"serde",
]
@ -3144,9 +3137,9 @@ checksum = "4dccd0940a2dcdf68d092b8cbab7dc0ad8fa938bf95787e1b916b0e3d0e8e970"
[[package]]
name = "snapbox"
version = "0.4.14"
version = "0.4.15"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4b377c0b6e4715c116473d8e40d51e3fa5b0a2297ca9b2a931ba800667b259ed"
checksum = "c4f1976ee8fd1be27d5f72c98be0aac4397a882a4736935d47418a5fbbd12042"
dependencies = [
"anstream",
"anstyle",
@ -3230,9 +3223,9 @@ dependencies = [
[[package]]
name = "syn"
version = "2.0.39"
version = "2.0.41"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "23e78b90f2fcf45d3e842032ce32e3f2d1545ba6636271dcbf24fa306d87be7a"
checksum = "44c8b28c477cc3bf0e7966561e3460130e1255f7a1cf71931075f1c5e7a7e269"
dependencies = [
"proc-macro2",
"quote",
@ -3301,7 +3294,7 @@ checksum = "266b2e40bc00e5a6c09c3584011e08b06f123c00362c92b975ba9843aaaa14b8"
dependencies = [
"proc-macro2",
"quote",
"syn 2.0.39",
"syn 2.0.41",
]
[[package]]
@ -3321,7 +3314,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c4a34ab300f2dee6e562c10a046fc05e358b29f9bf92277f30c3c8d82275f6f5"
dependencies = [
"deranged",
"itoa 1.0.9",
"itoa 1.0.10",
"libc",
"num_threads",
"powerfmt",
@ -3423,7 +3416,7 @@ checksum = "34704c8d6ebcbc939824180af020566b01a7c01f80641264eba0999f6c2b6be7"
dependencies = [
"proc-macro2",
"quote",
"syn 2.0.39",
"syn 2.0.41",
]
[[package]]
@ -3494,9 +3487,9 @@ dependencies = [
[[package]]
name = "unicode-bidi"
version = "0.3.13"
version = "0.3.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "92888ba5573ff080736b3648696b70cafad7d250551175acbaa4e0385b3e1460"
checksum = "6f2528f27a9eb2b21e69c95319b30bd0efd85d09c379741b0f78ea1d86be2416"
[[package]]
name = "unicode-bom"
@ -3699,7 +3692,7 @@ dependencies = [
"once_cell",
"proc-macro2",
"quote",
"syn 2.0.39",
"syn 2.0.41",
"wasm-bindgen-shared",
]
@ -3721,7 +3714,7 @@ checksum = "f0eb82fcb7930ae6219a7ecfd55b217f5f0893484b7a13022ebb2b2bf20b5283"
dependencies = [
"proc-macro2",
"quote",
"syn 2.0.39",
"syn 2.0.41",
"wasm-bindgen-backend",
"wasm-bindgen-shared",
]
@ -3916,9 +3909,9 @@ checksum = "dff9641d1cd4be8d1a070daf9e3773c5f67e78b4d9d42263020c057706765c04"
[[package]]
name = "winnow"
version = "0.5.25"
version = "0.5.28"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b7e87b8dfbe3baffbe687eef2e164e32286eff31a5ee16463ce03d991643ec94"
checksum = "6c830786f7720c2fd27a1a0e27a709dbd3c4d009b56d098fc742d4f4eab91fe2"
dependencies = [
"memchr",
]
@ -3965,7 +3958,7 @@ checksum = "b3c129550b3e6de3fd0ba67ba5c81818f9805e58b8d7fee80a3a59d2c9fc601a"
dependencies = [
"proc-macro2",
"quote",
"syn 2.0.39",
"syn 2.0.41",
]
[[package]]

View file

@ -48,7 +48,7 @@ git2-curl = "0.19.0"
gix = { version = "0.56.0", default-features = false, features = ["blocking-http-transport-curl", "progress-tree", "revision"] }
gix-features-for-configuration-only = { version = "0.35.0", package = "gix-features", features = [ "parallel" ] }
glob = "0.3.1"
handlebars = { version = "3.5.5", features = ["dir_source"] }
handlebars = { version = "4.5.0", features = ["dir_source"] }
hex = "0.4.3"
hmac = "0.12.1"
home = "0.5.5"

View file

@ -49,7 +49,6 @@ man page:
- Other helpers include:
- `{{lower value}}` Converts the given value to lowercase.
## OPTIONS
<dl>

View file

@ -30,11 +30,11 @@ impl super::Formatter for MdFormatter {
}
fn render_options_start(&self) -> &'static str {
"<dl>"
"<dl>\n"
}
fn render_options_end(&self) -> &'static str {
"</dl>"
"</dl>\n"
}
fn render_option(&self, params: &[&str], block: &str, man_name: &str) -> Result<String, Error> {
@ -67,7 +67,7 @@ impl super::Formatter for MdFormatter {
let rendered_block = self.render_html(block)?;
write!(
result,
"<dd class=\"option-desc\">{}</dd>\n",
"<dd class=\"option-desc\">{}</dd>\n\n",
unwrap_p(&rendered_block)
)?;
Ok(result)

View file

@ -26,11 +26,11 @@ impl super::Formatter for TextFormatter {
fn render_options_start(&self) -> &'static str {
// Tell pulldown_cmark to ignore this.
// This will be stripped out later.
"<![CDATA["
"<![CDATA[\n"
}
fn render_options_end(&self) -> &'static str {
"]]>"
"]]>\n"
}
fn render_option(
@ -46,7 +46,7 @@ impl super::Formatter for TextFormatter {
let trimmed: Vec<_> = rendered_options.iter().map(|o| o.trim()).collect();
// Wrap in HTML tags, they will be stripped out during rendering.
Ok(format!(
"<dt>{}</dt>\n<dd>{}</dd>\n<br>\n",
"<dt>{}</dt>\n<dd>\n{}</dd>\n<br>\n",
trimmed.join(", "),
block
))

View file

@ -32,6 +32,7 @@ Shortcut unknown: [shortcut unknown]
{{> links-include}}
## OPTIONS
{{#options}}

View file

@ -46,6 +46,7 @@ A named argument.
{{> options-common}}
## EXAMPLES
1. An example

View file

@ -2,6 +2,7 @@
{{*set foo="Bar"}}
{{foo}}
{{lower foo}}

View file

@ -24,6 +24,7 @@ See <https://doc.rust-lang.org/rustc/index.html> for documentation on rustc
flags.
{{> description-one-target }}
To pass flags to all compiler processes spawned by Cargo, use the `RUSTFLAGS`
[environment variable](../reference/environment-variables.html) or the
`build.rustflags` [config value](../reference/config.html).

View file

@ -24,6 +24,7 @@ See <https://doc.rust-lang.org/rustdoc/index.html> for documentation on rustdoc
flags.
{{> description-one-target }}
To pass flags to all rustdoc processes spawned by Cargo, use the
`RUSTDOCFLAGS` [environment variable](../reference/environment-variables.html)
or the `build.rustdocflags` [config value](../reference/config.html).

View file

@ -1,5 +1,4 @@
# cargo-add(1)
## NAME
cargo-add --- Add dependencies to a Cargo.toml manifest file
@ -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
@ -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
@ -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>
@ -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
@ -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

View file

@ -1,5 +1,4 @@
# cargo-bench(1)
## NAME
cargo-bench --- Execute benchmarks of a package
@ -80,7 +79,6 @@ as a whole.</dd>
</dl>
### Package Selection
By default, when no package selection options are given, the packages selected
@ -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
@ -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
@ -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.
@ -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>
@ -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
@ -259,7 +251,6 @@ be specified multiple times, which enables all specified features.</dd>
</dl>
### Compilation Options
<dl>
@ -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 projects <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
@ -306,7 +294,6 @@ information about timing information.</li>
</dl>
### Output Options
@ -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
@ -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>
@ -382,7 +367,6 @@ coming from rustc are still emitted. Cannot be used with <code>human</code> or <
</ul></dd>
</dl>
### Manifest Options
@ -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
@ -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
@ -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
@ -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`
@ -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:

View file

@ -1,5 +1,4 @@
# cargo-build(1)
## NAME
cargo-build --- Compile the current package
@ -42,12 +41,10 @@ double quotes around each pattern.</dd>
<dd class="option-desc">Build all members in the workspace.</dd>
<dt class="option-term" id="option-cargo-build---all"><a class="option-anchor" href="#option-cargo-build---all"></a><code>--all</code></dt>
<dd class="option-desc">Deprecated alias for <code>--workspace</code>.</dd>
<dt class="option-term" id="option-cargo-build---exclude"><a class="option-anchor" href="#option-cargo-build---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
@ -58,7 +55,6 @@ single quotes or double quotes around each pattern.</dd>
</dl>
### Target Selection
When no target selection options are given, `cargo build` will build all
@ -74,7 +70,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 build only the specified
targets.
@ -98,7 +93,6 @@ and supports common Unix glob patterns.</dd>
<dd class="option-desc">Build all binary targets.</dd>
<dt class="option-term" id="option-cargo-build---example"><a class="option-anchor" href="#option-cargo-build---example"></a><code>--example</code> <em>name</em></dt>
<dd class="option-desc">Build the specified example. This flag may be specified multiple times
and supports common Unix glob patterns.</dd>
@ -144,7 +138,6 @@ manifest settings for the target.</dd>
</dl>
### Feature Selection
The feature flags allow you to control which features are enabled. When no
@ -173,7 +166,6 @@ be specified multiple times, which enables all specified features.</dd>
</dl>
### Compilation Options
<dl>
@ -189,26 +181,22 @@ 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-build--r"><a class="option-anchor" href="#option-cargo-build--r"></a><code>-r</code></dt>
<dt class="option-term" id="option-cargo-build---release"><a class="option-anchor" href="#option-cargo-build---release"></a><code>--release</code></dt>
<dd class="option-desc">Build optimized artifacts with the <code>release</code> profile.
See also the <code>--profile</code> option for choosing a specific profile by name.</dd>
<dt class="option-term" id="option-cargo-build---profile"><a class="option-anchor" href="#option-cargo-build---profile"></a><code>--profile</code> <em>name</em></dt>
<dd class="option-desc">Build 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-build---ignore-rust-version"><a class="option-anchor" href="#option-cargo-build---ignore-rust-version"></a><code>--ignore-rust-version</code></dt>
<dd class="option-desc">Build the target even if the selected Rust compiler is older than the
required Rust version as configured in the projects <code>rust-version</code> field.</dd>
<dt class="option-term" id="option-cargo-build---timings=fmts"><a class="option-anchor" href="#option-cargo-build---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
@ -227,7 +215,6 @@ information about timing information.</li>
</dl>
### Output Options
@ -240,7 +227,6 @@ specified with the <code>CARGO_TARGET_DIR</code> environment variable, or the
Defaults to <code>target</code> in the root of the workspace.</dd>
<dt class="option-term" id="option-cargo-build---out-dir"><a class="option-anchor" href="#option-cargo-build---out-dir"></a><code>--out-dir</code> <em>directory</em></dt>
<dd class="option-desc">Copy final artifacts to this directory.</p>
<p>This option is unstable and available only on the
@ -281,7 +267,6 @@ terminal.</li>
<a href="../reference/config.html">config value</a>.</dd>
<dt class="option-term" id="option-cargo-build---message-format"><a class="option-anchor" href="#option-cargo-build---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>
@ -305,7 +290,6 @@ coming from rustc are still emitted. Cannot be used with <code>human</code> or <
</ul></dd>
<dt class="option-term" id="option-cargo-build---build-plan"><a class="option-anchor" href="#option-cargo-build---build-plan"></a><code>--build-plan</code></dt>
<dd class="option-desc">Outputs a series of JSON messages to stdout that indicate the commands to run
the build.</p>
@ -324,7 +308,6 @@ See <a href="https://github.com/rust-lang/cargo/issues/5579">https://github.com/
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>
<dt class="option-term" id="option-cargo-build---frozen"><a class="option-anchor" href="#option-cargo-build---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-build---locked"><a class="option-anchor" href="#option-cargo-build---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -348,7 +331,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
@ -391,7 +373,6 @@ requires the <code>-Z unstable-options</code> flag to enable (see
</dl>
### Miscellaneous Options
<dl>
@ -404,7 +385,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>
<dt class="option-term" id="option-cargo-build---keep-going"><a class="option-anchor" href="#option-cargo-build---keep-going"></a><code>--keep-going</code></dt>
<dd class="option-desc">Build as many crates in the dependency graph as possible, rather than aborting
the build on the first one that fails to build.</p>
@ -414,13 +394,11 @@ one that succeeds (depending on which one of the two builds Cargo picked to run
first), whereas <code>cargo build -j1 --keep-going</code> would definitely run both
builds, even if the one run first fails.</dd>
<dt class="option-term" id="option-cargo-build---future-incompat-report"><a class="option-anchor" href="#option-cargo-build---future-incompat-report"></a><code>--future-incompat-report</code></dt>
<dd class="option-desc">Displays a future-incompat report for any future-incompatible warnings
produced during execution of this command</p>
<p>See <a href="cargo-report.html">cargo-report(1)</a></dd>
</dl>
## ENVIRONMENT
@ -428,13 +406,11 @@ produced during execution of this command</p>
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 the local package and all of its dependencies:

View file

@ -1,5 +1,4 @@
# cargo-check(1)
## NAME
cargo-check --- Check the current package
@ -47,12 +46,10 @@ double quotes around each pattern.</dd>
<dd class="option-desc">Check all members in the workspace.</dd>
<dt class="option-term" id="option-cargo-check---all"><a class="option-anchor" href="#option-cargo-check---all"></a><code>--all</code></dt>
<dd class="option-desc">Deprecated alias for <code>--workspace</code>.</dd>
<dt class="option-term" id="option-cargo-check---exclude"><a class="option-anchor" href="#option-cargo-check---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
@ -63,7 +60,6 @@ single quotes or double quotes around each pattern.</dd>
</dl>
### Target Selection
When no target selection options are given, `cargo check` will check all
@ -93,7 +89,6 @@ and supports common Unix glob patterns.</dd>
<dd class="option-desc">Check all binary targets.</dd>
<dt class="option-term" id="option-cargo-check---example"><a class="option-anchor" href="#option-cargo-check---example"></a><code>--example</code> <em>name</em></dt>
<dd class="option-desc">Check the specified example. This flag may be specified multiple times
and supports common Unix glob patterns.</dd>
@ -139,7 +134,6 @@ manifest settings for the target.</dd>
</dl>
### Feature Selection
The feature flags allow you to control which features are enabled. When no
@ -168,7 +162,6 @@ be specified multiple times, which enables all specified features.</dd>
</dl>
### Compilation Options
<dl>
@ -184,14 +177,12 @@ 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-check--r"><a class="option-anchor" href="#option-cargo-check--r"></a><code>-r</code></dt>
<dt class="option-term" id="option-cargo-check---release"><a class="option-anchor" href="#option-cargo-check---release"></a><code>--release</code></dt>
<dd class="option-desc">Check optimized artifacts with the <code>release</code> profile.
See also the <code>--profile</code> option for choosing a specific profile by name.</dd>
<dt class="option-term" id="option-cargo-check---profile"><a class="option-anchor" href="#option-cargo-check---profile"></a><code>--profile</code> <em>name</em></dt>
<dd class="option-desc">Check with the given profile.</p>
<p>As a special case, specifying the <code>test</code> profile will also enable checking in
@ -201,13 +192,11 @@ detail.</p>
<p>See <a href="../reference/profiles.html">the reference</a> for more details on profiles.</dd>
<dt class="option-term" id="option-cargo-check---ignore-rust-version"><a class="option-anchor" href="#option-cargo-check---ignore-rust-version"></a><code>--ignore-rust-version</code></dt>
<dd class="option-desc">Check the target even if the selected Rust compiler is older than the
required Rust version as configured in the projects <code>rust-version</code> field.</dd>
<dt class="option-term" id="option-cargo-check---timings=fmts"><a class="option-anchor" href="#option-cargo-check---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
@ -226,7 +215,6 @@ information about timing information.</li>
</dl>
### Output Options
@ -238,7 +226,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
@ -271,7 +258,6 @@ terminal.</li>
<a href="../reference/config.html">config value</a>.</dd>
<dt class="option-term" id="option-cargo-check---message-format"><a class="option-anchor" href="#option-cargo-check---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>
@ -294,7 +280,6 @@ JSON diagnostics coming from rustc. Cargos own JSON diagnostics and others
coming from rustc are still emitted. Cannot be used with <code>human</code> or <code>short</code>.</li>
</ul></dd>
</dl>
### Manifest Options
@ -305,7 +290,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-check---frozen"><a class="option-anchor" href="#option-cargo-check---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-check---locked"><a class="option-anchor" href="#option-cargo-check---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -329,7 +313,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
@ -372,7 +355,6 @@ requires the <code>-Z unstable-options</code> flag to enable (see
</dl>
### Miscellaneous Options
<dl>
@ -385,7 +367,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>
<dt class="option-term" id="option-cargo-check---keep-going"><a class="option-anchor" href="#option-cargo-check---keep-going"></a><code>--keep-going</code></dt>
<dd class="option-desc">Build as many crates in the dependency graph as possible, rather than aborting
the build on the first one that fails to build.</p>
@ -395,13 +376,11 @@ one that succeeds (depending on which one of the two builds Cargo picked to run
first), whereas <code>cargo check -j1 --keep-going</code> would definitely run both
builds, even if the one run first fails.</dd>
<dt class="option-term" id="option-cargo-check---future-incompat-report"><a class="option-anchor" href="#option-cargo-check---future-incompat-report"></a><code>--future-incompat-report</code></dt>
<dd class="option-desc">Displays a future-incompat report for any future-incompatible warnings
produced during execution of this command</p>
<p>See <a href="cargo-report.html">cargo-report(1)</a></dd>
</dl>
## ENVIRONMENT
@ -409,13 +388,11 @@ produced during execution of this command</p>
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. Check the local package for errors:

View file

@ -1,5 +1,4 @@
# cargo-clean(1)
## NAME
cargo-clean --- Remove generated artifacts
@ -59,7 +58,6 @@ specified with the <code>CARGO_TARGET_DIR</code> environment variable, or the
Defaults to <code>target</code> in the root of the workspace.</dd>
<dt class="option-term" id="option-cargo-clean---target"><a class="option-anchor" href="#option-cargo-clean---target"></a><code>--target</code> <em>triple</em></dt>
<dd class="option-desc">Clean for the given architecture. The default is the host architecture. The general format of the triple is
<code>&lt;arch&gt;&lt;sub&gt;-&lt;vendor&gt;-&lt;sys&gt;-&lt;abi&gt;</code>. Run <code>rustc --print target-list</code> for a
@ -71,7 +69,6 @@ target artifacts are placed in a separate directory. See the
<a href="../guide/build-cache.html">build cache</a> documentation for more details.</dd>
</dl>
### Display Options
@ -103,7 +100,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
@ -114,7 +110,6 @@ terminal.</li>
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>
<dt class="option-term" id="option-cargo-clean---frozen"><a class="option-anchor" href="#option-cargo-clean---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-clean---locked"><a class="option-anchor" href="#option-cargo-clean---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -138,7 +133,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
@ -181,19 +175,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. Remove the entire target directory:

View file

@ -1,5 +1,4 @@
# cargo-doc(1)
## NAME
cargo-doc --- Build a package's documentation
@ -64,12 +63,10 @@ double quotes around each pattern.</dd>
<dd class="option-desc">Document all members in the workspace.</dd>
<dt class="option-term" id="option-cargo-doc---all"><a class="option-anchor" href="#option-cargo-doc---all"></a><code>--all</code></dt>
<dd class="option-desc">Deprecated alias for <code>--workspace</code>.</dd>
<dt class="option-term" id="option-cargo-doc---exclude"><a class="option-anchor" href="#option-cargo-doc---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
@ -80,7 +77,6 @@ single quotes or double quotes around each pattern.</dd>
</dl>
### Target Selection
When no target selection options are given, `cargo doc` will document all
@ -106,7 +102,6 @@ and supports common Unix glob patterns.</dd>
<dd class="option-desc">Document all binary targets.</dd>
<dt class="option-term" id="option-cargo-doc---example"><a class="option-anchor" href="#option-cargo-doc---example"></a><code>--example</code> <em>name</em></dt>
<dd class="option-desc">Document the specified example. This flag may be specified multiple times
and supports common Unix glob patterns.</dd>
@ -146,7 +141,6 @@ be specified multiple times, which enables all specified features.</dd>
</dl>
### Compilation Options
<dl>
@ -162,26 +156,22 @@ 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-doc--r"><a class="option-anchor" href="#option-cargo-doc--r"></a><code>-r</code></dt>
<dt class="option-term" id="option-cargo-doc---release"><a class="option-anchor" href="#option-cargo-doc---release"></a><code>--release</code></dt>
<dd class="option-desc">Document optimized artifacts with the <code>release</code> profile.
See also the <code>--profile</code> option for choosing a specific profile by name.</dd>
<dt class="option-term" id="option-cargo-doc---profile"><a class="option-anchor" href="#option-cargo-doc---profile"></a><code>--profile</code> <em>name</em></dt>
<dd class="option-desc">Document 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-doc---ignore-rust-version"><a class="option-anchor" href="#option-cargo-doc---ignore-rust-version"></a><code>--ignore-rust-version</code></dt>
<dd class="option-desc">Document the target even if the selected Rust compiler is older than the
required Rust version as configured in the projects <code>rust-version</code> field.</dd>
<dt class="option-term" id="option-cargo-doc---timings=fmts"><a class="option-anchor" href="#option-cargo-doc---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
@ -200,7 +190,6 @@ information about timing information.</li>
</dl>
### Output Options
@ -212,7 +201,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
@ -245,7 +233,6 @@ terminal.</li>
<a href="../reference/config.html">config value</a>.</dd>
<dt class="option-term" id="option-cargo-doc---message-format"><a class="option-anchor" href="#option-cargo-doc---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>
@ -268,7 +255,6 @@ JSON diagnostics coming from rustc. Cargos own JSON diagnostics and others
coming from rustc are still emitted. Cannot be used with <code>human</code> or <code>short</code>.</li>
</ul></dd>
</dl>
### Manifest Options
@ -279,7 +265,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-doc---frozen"><a class="option-anchor" href="#option-cargo-doc---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-doc---locked"><a class="option-anchor" href="#option-cargo-doc---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -303,7 +288,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
@ -346,7 +330,6 @@ requires the <code>-Z unstable-options</code> flag to enable (see
</dl>
### Miscellaneous Options
<dl>
@ -359,7 +342,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>
<dt class="option-term" id="option-cargo-doc---keep-going"><a class="option-anchor" href="#option-cargo-doc---keep-going"></a><code>--keep-going</code></dt>
<dd class="option-desc">Build as many crates in the dependency graph as possible, rather than aborting
the build on the first one that fails to build.</p>
@ -369,7 +351,6 @@ one that succeeds (depending on which one of the two builds Cargo picked to run
first), whereas <code>cargo doc -j1 --keep-going</code> would definitely run both
builds, even if the one run first fails.</dd>
</dl>
## ENVIRONMENT
@ -377,13 +358,11 @@ builds, even if the one run first fails.</dd>
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 the local package documentation and its dependencies and output to

View file

@ -1,5 +1,4 @@
# cargo-fetch(1)
## NAME
cargo-fetch --- Fetch dependencies of a package from the network
@ -39,7 +38,6 @@ list of supported targets. This flag may be specified multiple times.</p>
target artifacts are placed in a separate directory. See the
<a href="../guide/build-cache.html">build cache</a> documentation for more details.</dd>
</dl>
### Display Options
@ -71,7 +69,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
@ -82,7 +79,6 @@ terminal.</li>
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>
<dt class="option-term" id="option-cargo-fetch---frozen"><a class="option-anchor" href="#option-cargo-fetch---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-fetch---locked"><a class="option-anchor" href="#option-cargo-fetch---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -106,7 +102,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
@ -149,19 +144,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. Fetch all dependencies:

View file

@ -1,5 +1,4 @@
# cargo-fix(1)
## NAME
cargo-fix --- Automatically fix lint warnings reported by rustc
@ -127,12 +126,10 @@ double quotes around each pattern.</dd>
<dd class="option-desc">Fix all members in the workspace.</dd>
<dt class="option-term" id="option-cargo-fix---all"><a class="option-anchor" href="#option-cargo-fix---all"></a><code>--all</code></dt>
<dd class="option-desc">Deprecated alias for <code>--workspace</code>.</dd>
<dt class="option-term" id="option-cargo-fix---exclude"><a class="option-anchor" href="#option-cargo-fix---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
@ -143,7 +140,6 @@ single quotes or double quotes around each pattern.</dd>
</dl>
### Target Selection
When no target selection options are given, `cargo fix` will fix all targets
@ -173,7 +169,6 @@ and supports common Unix glob patterns.</dd>
<dd class="option-desc">Fix all binary targets.</dd>
<dt class="option-term" id="option-cargo-fix---example"><a class="option-anchor" href="#option-cargo-fix---example"></a><code>--example</code> <em>name</em></dt>
<dd class="option-desc">Fix the specified example. This flag may be specified multiple times
and supports common Unix glob patterns.</dd>
@ -219,7 +214,6 @@ manifest settings for the target.</dd>
</dl>
### Feature Selection
The feature flags allow you to control which features are enabled. When no
@ -248,7 +242,6 @@ be specified multiple times, which enables all specified features.</dd>
</dl>
### Compilation Options
<dl>
@ -264,14 +257,12 @@ 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-fix--r"><a class="option-anchor" href="#option-cargo-fix--r"></a><code>-r</code></dt>
<dt class="option-term" id="option-cargo-fix---release"><a class="option-anchor" href="#option-cargo-fix---release"></a><code>--release</code></dt>
<dd class="option-desc">Fix optimized artifacts with the <code>release</code> profile.
See also the <code>--profile</code> option for choosing a specific profile by name.</dd>
<dt class="option-term" id="option-cargo-fix---profile"><a class="option-anchor" href="#option-cargo-fix---profile"></a><code>--profile</code> <em>name</em></dt>
<dd class="option-desc">Fix with the given profile.</p>
<p>As a special case, specifying the <code>test</code> profile will also enable checking in
@ -281,13 +272,11 @@ detail.</p>
<p>See <a href="../reference/profiles.html">the reference</a> for more details on profiles.</dd>
<dt class="option-term" id="option-cargo-fix---ignore-rust-version"><a class="option-anchor" href="#option-cargo-fix---ignore-rust-version"></a><code>--ignore-rust-version</code></dt>
<dd class="option-desc">Fix the target even if the selected Rust compiler is older than the
required Rust version as configured in the projects <code>rust-version</code> field.</dd>
<dt class="option-term" id="option-cargo-fix---timings=fmts"><a class="option-anchor" href="#option-cargo-fix---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
@ -306,7 +295,6 @@ information about timing information.</li>
</dl>
### Output Options
@ -318,7 +306,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
@ -351,7 +338,6 @@ terminal.</li>
<a href="../reference/config.html">config value</a>.</dd>
<dt class="option-term" id="option-cargo-fix---message-format"><a class="option-anchor" href="#option-cargo-fix---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>
@ -374,7 +360,6 @@ JSON diagnostics coming from rustc. Cargos own JSON diagnostics and others
coming from rustc are still emitted. Cannot be used with <code>human</code> or <code>short</code>.</li>
</ul></dd>
</dl>
### Manifest Options
@ -385,7 +370,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-fix---frozen"><a class="option-anchor" href="#option-cargo-fix---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-fix---locked"><a class="option-anchor" href="#option-cargo-fix---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -409,7 +393,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
@ -452,7 +435,6 @@ requires the <code>-Z unstable-options</code> flag to enable (see
</dl>
### Miscellaneous Options
<dl>
@ -465,7 +447,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>
<dt class="option-term" id="option-cargo-fix---keep-going"><a class="option-anchor" href="#option-cargo-fix---keep-going"></a><code>--keep-going</code></dt>
<dd class="option-desc">Build as many crates in the dependency graph as possible, rather than aborting
the build on the first one that fails to build.</p>
@ -475,7 +456,6 @@ one that succeeds (depending on which one of the two builds Cargo picked to run
first), whereas <code>cargo fix -j1 --keep-going</code> would definitely run both
builds, even if the one run first fails.</dd>
</dl>
## ENVIRONMENT
@ -483,13 +463,11 @@ builds, even if the one run first fails.</dd>
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. Apply compiler suggestions to the local package:

View file

@ -48,7 +48,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
@ -59,7 +58,6 @@ terminal.</li>
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>
<dt class="option-term" id="option-cargo-generate-lockfile---frozen"><a class="option-anchor" href="#option-cargo-generate-lockfile---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-generate-lockfile---locked"><a class="option-anchor" href="#option-cargo-generate-lockfile---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -83,7 +81,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
@ -126,19 +123,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. Create or update the lockfile for the current package or workspace:

View file

@ -66,7 +66,6 @@ be restricted.</dd>
</dl>
### Display Options
<dl>
@ -96,7 +95,6 @@ terminal.</li>
<p>May also be specified with the <code>term.color</code>
<a href="../reference/config.html">config value</a>.</dd>
</dl>
### Common Options
@ -139,19 +137,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. Create a binary Cargo package in the current directory:

View file

@ -1,5 +1,4 @@
# cargo-install(1)
## NAME
cargo-install --- Build and install a Rust binary
@ -26,7 +25,6 @@ The installation root is determined, in order of precedence:
- `CARGO_HOME` environment variable
- `$HOME/.cargo`
There are multiple sources from which a crate can be installed. The default
location is crates.io but the `--git`, `--path`, and `--registry` flags can
change this source. If the source contains more than one package (such as
@ -170,12 +168,10 @@ which is defined by the <code>registry.default</code> config key which defaults
<code>crates-io</code>.</dd>
<dt class="option-term" id="option-cargo-install---index"><a class="option-anchor" href="#option-cargo-install---index"></a><code>--index</code> <em>index</em></dt>
<dd class="option-desc">The URL of the registry index to use.</dd>
</dl>
### Feature Selection
@ -206,7 +202,6 @@ be specified multiple times, which enables all specified features.</dd>
</dl>
### Compilation Options
<dl>
@ -222,7 +217,6 @@ 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-install---target-dir"><a class="option-anchor" href="#option-cargo-install---target-dir"></a><code>--target-dir</code> <em>directory</em></dt>
<dd class="option-desc">Directory for all generated artifacts and intermediate files. May also be
specified with the <code>CARGO_TARGET_DIR</code> environment variable, or the
@ -234,7 +228,6 @@ of the local crate unless <code>--target-dir</code>
is specified.</dd>
<dt class="option-term" id="option-cargo-install---debug"><a class="option-anchor" href="#option-cargo-install---debug"></a><code>--debug</code></dt>
<dd class="option-desc">Build with the <code>dev</code> profile instead of the <code>release</code> profile.
See also the <code>--profile</code> option for choosing a specific profile by name.</dd>
@ -245,13 +238,11 @@ See also the <code>--profile</code> option for choosing a specific profile by na
See <a href="../reference/profiles.html">the reference</a> for more details on profiles.</dd>
<dt class="option-term" id="option-cargo-install---ignore-rust-version"><a class="option-anchor" href="#option-cargo-install---ignore-rust-version"></a><code>--ignore-rust-version</code></dt>
<dd class="option-desc">Install the target even if the selected Rust compiler is older than the
required Rust version as configured in the projects <code>rust-version</code> field.</dd>
<dt class="option-term" id="option-cargo-install---timings=fmts"><a class="option-anchor" href="#option-cargo-install---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
@ -270,7 +261,6 @@ information about timing information.</li>
</dl>
### Manifest Options
@ -299,7 +289,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>
### Miscellaneous Options
@ -314,7 +303,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>
<dt class="option-term" id="option-cargo-install---keep-going"><a class="option-anchor" href="#option-cargo-install---keep-going"></a><code>--keep-going</code></dt>
<dd class="option-desc">Build as many crates in the dependency graph as possible, rather than aborting
the build on the first one that fails to build.</p>
@ -324,7 +312,6 @@ one that succeeds (depending on which one of the two builds Cargo picked to run
first), whereas <code>cargo install -j1 --keep-going</code> would definitely run both
builds, even if the one run first fails.</dd>
</dl>
### Display Options
@ -357,7 +344,6 @@ terminal.</li>
<a href="../reference/config.html">config value</a>.</dd>
<dt class="option-term" id="option-cargo-install---message-format"><a class="option-anchor" href="#option-cargo-install---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>
@ -381,7 +367,6 @@ coming from rustc are still emitted. Cannot be used with <code>human</code> or <
</ul></dd>
</dl>
### Common Options
@ -424,19 +409,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. Install or upgrade a package from crates.io:

View file

@ -68,7 +68,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
@ -78,7 +77,6 @@ terminal.</li>
<dd class="option-desc">Path to the <code>Cargo.toml</code> file. By default, Cargo searches for the
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>
</dl>
### Common Options
@ -121,19 +119,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. Display the path to the manifest based on the current directory:

View file

@ -41,7 +41,6 @@ files</a>. If not specified, the default registry is used,
which is defined by the <code>registry.default</code> config key which defaults to
<code>crates-io</code>.</dd>
</dl>
### Display Options
@ -73,7 +72,6 @@ terminal.</li>
<p>May also be specified with the <code>term.color</code>
<a href="../reference/config.html">config value</a>.</dd>
</dl>
### Common Options
@ -116,19 +114,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. Save the token for the default registry:

View file

@ -40,7 +40,6 @@ files</a>. If not specified, the default registry is used,
which is defined by the <code>registry.default</code> config key which defaults to
<code>crates-io</code>.</dd>
</dl>
### Display Options
@ -72,7 +71,6 @@ terminal.</li>
<p>May also be specified with the <code>term.color</code>
<a href="../reference/config.html">config value</a>.</dd>
</dl>
### Common Options
@ -115,19 +113,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. Remove the default registry token:

View file

@ -386,7 +386,6 @@ be specified multiple times, which enables all specified features.</dd>
</dl>
### Display Options
<dl>
@ -416,7 +415,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
@ -427,7 +425,6 @@ terminal.</li>
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>
<dt class="option-term" id="option-cargo-metadata---frozen"><a class="option-anchor" href="#option-cargo-metadata---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-metadata---locked"><a class="option-anchor" href="#option-cargo-metadata---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -451,7 +448,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
@ -494,19 +490,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. Output JSON about the current package:

View file

@ -61,7 +61,6 @@ be restricted.</dd>
</dl>
### Display Options
<dl>
@ -91,7 +90,6 @@ terminal.</li>
<p>May also be specified with the <code>term.color</code>
<a href="../reference/config.html">config value</a>.</dd>
</dl>
### Common Options
@ -134,19 +132,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. Create a binary Cargo package in the given directory:

View file

@ -57,12 +57,10 @@ variables of the form <code>CARGO_REGISTRIES_NAME_TOKEN</code> where <code>NAME<
of the registry in all capital letters.</dd>
<dt class="option-term" id="option-cargo-owner---index"><a class="option-anchor" href="#option-cargo-owner---index"></a><code>--index</code> <em>index</em></dt>
<dd class="option-desc">The URL of the registry index to use.</dd>
<dt class="option-term" id="option-cargo-owner---registry"><a class="option-anchor" href="#option-cargo-owner---registry"></a><code>--registry</code> <em>registry</em></dt>
<dd class="option-desc">Name of the registry to use. Registry names are defined in <a href="../reference/config.html">Cargo config
files</a>. If not specified, the default registry is used,
@ -70,7 +68,6 @@ which is defined by the <code>registry.default</code> config key which defaults
<code>crates-io</code>.</dd>
</dl>
### Display Options
@ -102,7 +99,6 @@ terminal.</li>
<p>May also be specified with the <code>term.color</code>
<a href="../reference/config.html">config value</a>.</dd>
</dl>
### Common Options
@ -145,19 +141,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. List owners of a package:

View file

@ -1,5 +1,4 @@
# cargo-package(1)
## NAME
cargo-package --- Assemble the local package into a distributable tarball
@ -112,7 +111,6 @@ double quotes around each pattern.</dd>
<dt class="option-term" id="option-cargo-package---exclude"><a class="option-anchor" href="#option-cargo-package---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
@ -123,7 +121,6 @@ single quotes or double quotes around each pattern.</dd>
</dl>
### Compilation Options
<dl>
@ -139,7 +136,6 @@ 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-package---target-dir"><a class="option-anchor" href="#option-cargo-package---target-dir"></a><code>--target-dir</code> <em>directory</em></dt>
<dd class="option-desc">Directory for all generated artifacts and intermediate files. May also be
specified with the <code>CARGO_TARGET_DIR</code> environment variable, or the
@ -147,7 +143,6 @@ specified with the <code>CARGO_TARGET_DIR</code> environment variable, or the
Defaults to <code>target</code> in the root of the workspace.</dd>
</dl>
### Feature Selection
@ -178,7 +173,6 @@ be specified multiple times, which enables all specified features.</dd>
</dl>
### Manifest Options
<dl>
@ -188,7 +182,6 @@ be specified multiple times, which enables all specified features.</dd>
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>
<dt class="option-term" id="option-cargo-package---frozen"><a class="option-anchor" href="#option-cargo-package---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-package---locked"><a class="option-anchor" href="#option-cargo-package---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -213,7 +206,6 @@ offline.</p>
<p>May also be specified with the <code>net.offline</code> <a href="../reference/config.html">config value</a>.</dd>
</dl>
### Miscellaneous Options
@ -228,7 +220,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>
<dt class="option-term" id="option-cargo-package---keep-going"><a class="option-anchor" href="#option-cargo-package---keep-going"></a><code>--keep-going</code></dt>
<dd class="option-desc">Build as many crates in the dependency graph as possible, rather than aborting
the build on the first one that fails to build.</p>
@ -238,7 +229,6 @@ one that succeeds (depending on which one of the two builds Cargo picked to run
first), whereas <code>cargo package -j1 --keep-going</code> would definitely run both
builds, even if the one run first fails.</dd>
</dl>
### Display Options
@ -270,7 +260,6 @@ terminal.</li>
<p>May also be specified with the <code>term.color</code>
<a href="../reference/config.html">config value</a>.</dd>
</dl>
### Common Options
@ -313,19 +302,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. Create a compressed `.crate` file of the current package:

View file

@ -75,7 +75,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
@ -87,7 +86,6 @@ terminal.</li>
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>
<dt class="option-term" id="option-cargo-pkgid---frozen"><a class="option-anchor" href="#option-cargo-pkgid---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-pkgid---locked"><a class="option-anchor" href="#option-cargo-pkgid---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -112,7 +110,6 @@ 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
@ -155,19 +152,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. Retrieve package specification for `foo` package:

View file

@ -1,5 +1,4 @@
# cargo-publish(1)
## NAME
cargo-publish --- Upload a package to the registry
@ -52,7 +51,6 @@ variables of the form <code>CARGO_REGISTRIES_NAME_TOKEN</code> where <code>NAME<
of the registry in all capital letters.</dd>
<dt class="option-term" id="option-cargo-publish---no-verify"><a class="option-anchor" href="#option-cargo-publish---no-verify"></a><code>--no-verify</code></dt>
<dd class="option-desc">Dont verify the contents by building them.</dd>
@ -65,7 +63,6 @@ of the registry in all capital letters.</dd>
<dd class="option-desc">The URL of the registry index to use.</dd>
<dt class="option-term" id="option-cargo-publish---registry"><a class="option-anchor" href="#option-cargo-publish---registry"></a><code>--registry</code> <em>registry</em></dt>
<dd class="option-desc">Name of the registry to publish to. Registry names are defined in <a href="../reference/config.html">Cargo
config files</a>. If not specified, and there is a
@ -93,7 +90,6 @@ format.</dd>
</dl>
### Compilation Options
<dl>
@ -109,7 +105,6 @@ 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-publish---target-dir"><a class="option-anchor" href="#option-cargo-publish---target-dir"></a><code>--target-dir</code> <em>directory</em></dt>
<dd class="option-desc">Directory for all generated artifacts and intermediate files. May also be
specified with the <code>CARGO_TARGET_DIR</code> environment variable, or the
@ -117,7 +112,6 @@ specified with the <code>CARGO_TARGET_DIR</code> environment variable, or the
Defaults to <code>target</code> in the root of the workspace.</dd>
</dl>
### Feature Selection
@ -148,7 +142,6 @@ be specified multiple times, which enables all specified features.</dd>
</dl>
### Manifest Options
<dl>
@ -158,7 +151,6 @@ be specified multiple times, which enables all specified features.</dd>
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>
<dt class="option-term" id="option-cargo-publish---frozen"><a class="option-anchor" href="#option-cargo-publish---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-publish---locked"><a class="option-anchor" href="#option-cargo-publish---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -183,7 +175,6 @@ offline.</p>
<p>May also be specified with the <code>net.offline</code> <a href="../reference/config.html">config value</a>.</dd>
</dl>
### Miscellaneous Options
@ -198,7 +189,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>
<dt class="option-term" id="option-cargo-publish---keep-going"><a class="option-anchor" href="#option-cargo-publish---keep-going"></a><code>--keep-going</code></dt>
<dd class="option-desc">Build as many crates in the dependency graph as possible, rather than aborting
the build on the first one that fails to build.</p>
@ -208,7 +198,6 @@ one that succeeds (depending on which one of the two builds Cargo picked to run
first), whereas <code>cargo publish -j1 --keep-going</code> would definitely run both
builds, even if the one run first fails.</dd>
</dl>
### Display Options
@ -240,7 +229,6 @@ terminal.</li>
<p>May also be specified with the <code>term.color</code>
<a href="../reference/config.html">config value</a>.</dd>
</dl>
### Common Options
@ -283,19 +271,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. Publish the current package:

View file

@ -1,5 +1,4 @@
# cargo-remove(1)
## NAME
cargo-remove --- Remove dependencies from a Cargo.toml manifest file
@ -72,7 +71,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
@ -83,7 +81,6 @@ terminal.</li>
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>
<dt class="option-term" id="option-cargo-remove---frozen"><a class="option-anchor" href="#option-cargo-remove---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-remove---locked"><a class="option-anchor" href="#option-cargo-remove---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -107,7 +104,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>
### Package Selection
@ -161,19 +157,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. Remove `regex` as a dependency

View file

@ -1,5 +1,4 @@
# cargo-run(1)
## NAME
cargo-run --- Run the current package
@ -37,7 +36,6 @@ format.</dd>
</dl>
### Target Selection
When no target selection options are given, `cargo run` will run the binary
@ -85,7 +83,6 @@ be specified multiple times, which enables all specified features.</dd>
</dl>
### Compilation Options
<dl>
@ -101,26 +98,22 @@ 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-run--r"><a class="option-anchor" href="#option-cargo-run--r"></a><code>-r</code></dt>
<dt class="option-term" id="option-cargo-run---release"><a class="option-anchor" href="#option-cargo-run---release"></a><code>--release</code></dt>
<dd class="option-desc">Run optimized artifacts with the <code>release</code> profile.
See also the <code>--profile</code> option for choosing a specific profile by name.</dd>
<dt class="option-term" id="option-cargo-run---profile"><a class="option-anchor" href="#option-cargo-run---profile"></a><code>--profile</code> <em>name</em></dt>
<dd class="option-desc">Run 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-run---ignore-rust-version"><a class="option-anchor" href="#option-cargo-run---ignore-rust-version"></a><code>--ignore-rust-version</code></dt>
<dd class="option-desc">Run the target even if the selected Rust compiler is older than the
required Rust version as configured in the projects <code>rust-version</code> field.</dd>
<dt class="option-term" id="option-cargo-run---timings=fmts"><a class="option-anchor" href="#option-cargo-run---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
@ -139,7 +132,6 @@ information about timing information.</li>
</dl>
### Output Options
@ -151,7 +143,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
@ -185,7 +176,6 @@ terminal.</li>
<a href="../reference/config.html">config value</a>.</dd>
<dt class="option-term" id="option-cargo-run---message-format"><a class="option-anchor" href="#option-cargo-run---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>
@ -209,7 +199,6 @@ coming from rustc are still emitted. Cannot be used with <code>human</code> or <
</ul></dd>
</dl>
### Manifest Options
@ -221,7 +210,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-run---frozen"><a class="option-anchor" href="#option-cargo-run---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-run---locked"><a class="option-anchor" href="#option-cargo-run---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -246,7 +234,6 @@ 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
@ -289,7 +276,6 @@ requires the <code>-Z unstable-options</code> flag to enable (see
</dl>
### Miscellaneous Options
<dl>
@ -302,7 +288,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>
<dt class="option-term" id="option-cargo-run---keep-going"><a class="option-anchor" href="#option-cargo-run---keep-going"></a><code>--keep-going</code></dt>
<dd class="option-desc">Build as many crates in the dependency graph as possible, rather than aborting
the build on the first one that fails to build.</p>
@ -312,7 +297,6 @@ one that succeeds (depending on which one of the two builds Cargo picked to run
first), whereas <code>cargo run -j1 --keep-going</code> would definitely run both
builds, even if the one run first fails.</dd>
</dl>
## ENVIRONMENT
@ -320,13 +304,11 @@ builds, even if the one run first fails.</dd>
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 the local package and run its main target (assuming only one binary):

View file

@ -1,5 +1,4 @@
# cargo-rustc(1)
## NAME
cargo-rustc --- Compile the current package, and pass extra options to the compiler
@ -46,7 +45,6 @@ format.</dd>
</dl>
### Target Selection
When no target selection options are given, `cargo rustc` will build all
@ -61,7 +59,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 build only the specified
targets.
@ -85,7 +82,6 @@ and supports common Unix glob patterns.</dd>
<dd class="option-desc">Build all binary targets.</dd>
<dt class="option-term" id="option-cargo-rustc---example"><a class="option-anchor" href="#option-cargo-rustc---example"></a><code>--example</code> <em>name</em></dt>
<dd class="option-desc">Build the specified example. This flag may be specified multiple times
and supports common Unix glob patterns.</dd>
@ -131,7 +127,6 @@ manifest settings for the target.</dd>
</dl>
### Feature Selection
The feature flags allow you to control which features are enabled. When no
@ -160,7 +155,6 @@ be specified multiple times, which enables all specified features.</dd>
</dl>
### Compilation Options
<dl>
@ -176,14 +170,12 @@ 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-rustc--r"><a class="option-anchor" href="#option-cargo-rustc--r"></a><code>-r</code></dt>
<dt class="option-term" id="option-cargo-rustc---release"><a class="option-anchor" href="#option-cargo-rustc---release"></a><code>--release</code></dt>
<dd class="option-desc">Build optimized artifacts with the <code>release</code> profile.
See also the <code>--profile</code> option for choosing a specific profile by name.</dd>
<dt class="option-term" id="option-cargo-rustc---profile"><a class="option-anchor" href="#option-cargo-rustc---profile"></a><code>--profile</code> <em>name</em></dt>
<dd class="option-desc">Build with the given profile.</p>
<p>The <code>rustc</code> subcommand will treat the following named profiles with special behaviors:</p>
@ -205,7 +197,6 @@ similar to the <code>test</code> profile.</li>
required Rust version as configured in the projects <code>rust-version</code> field.</dd>
<dt class="option-term" id="option-cargo-rustc---timings=fmts"><a class="option-anchor" href="#option-cargo-rustc---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
@ -224,7 +215,6 @@ information about timing information.</li>
<dt class="option-term" id="option-cargo-rustc---crate-type"><a class="option-anchor" href="#option-cargo-rustc---crate-type"></a><code>--crate-type</code> <em>crate-type</em></dt>
<dd class="option-desc">Build for the given crate type. This flag accepts a comma-separated list of
1 or more crate types, of which the allowed values are the same as <code>crate-type</code>
@ -247,7 +237,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
@ -281,7 +270,6 @@ terminal.</li>
<a href="../reference/config.html">config value</a>.</dd>
<dt class="option-term" id="option-cargo-rustc---message-format"><a class="option-anchor" href="#option-cargo-rustc---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>
@ -305,7 +293,6 @@ coming from rustc are still emitted. Cannot be used with <code>human</code> or <
</ul></dd>
</dl>
### Manifest Options
@ -317,7 +304,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-rustc---frozen"><a class="option-anchor" href="#option-cargo-rustc---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-rustc---locked"><a class="option-anchor" href="#option-cargo-rustc---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -342,7 +328,6 @@ 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
@ -385,7 +370,6 @@ requires the <code>-Z unstable-options</code> flag to enable (see
</dl>
### Miscellaneous Options
<dl>
@ -398,7 +382,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>
<dt class="option-term" id="option-cargo-rustc---keep-going"><a class="option-anchor" href="#option-cargo-rustc---keep-going"></a><code>--keep-going</code></dt>
<dd class="option-desc">Build as many crates in the dependency graph as possible, rather than aborting
the build on the first one that fails to build.</p>
@ -408,13 +391,11 @@ one that succeeds (depending on which one of the two builds Cargo picked to run
first), whereas <code>cargo rustc -j1 --keep-going</code> would definitely run both
builds, even if the one run first fails.</dd>
<dt class="option-term" id="option-cargo-rustc---future-incompat-report"><a class="option-anchor" href="#option-cargo-rustc---future-incompat-report"></a><code>--future-incompat-report</code></dt>
<dd class="option-desc">Displays a future-incompat report for any future-incompatible warnings
produced during execution of this command</p>
<p>See <a href="cargo-report.html">cargo-report(1)</a></dd>
</dl>
## ENVIRONMENT
@ -422,13 +403,11 @@ produced during execution of this command</p>
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. Check if your package (not including dependencies) uses unsafe code:

View file

@ -1,5 +1,4 @@
# cargo-rustdoc(1)
## NAME
cargo-rustdoc --- Build a package's documentation, using specified custom flags
@ -59,7 +58,6 @@ format.</dd>
</dl>
### Target Selection
When no target selection options are given, `cargo rustdoc` will document all
@ -90,7 +88,6 @@ and supports common Unix glob patterns.</dd>
<dd class="option-desc">Document all binary targets.</dd>
<dt class="option-term" id="option-cargo-rustdoc---example"><a class="option-anchor" href="#option-cargo-rustdoc---example"></a><code>--example</code> <em>name</em></dt>
<dd class="option-desc">Document the specified example. This flag may be specified multiple times
and supports common Unix glob patterns.</dd>
@ -136,7 +133,6 @@ manifest settings for the target.</dd>
</dl>
### Feature Selection
The feature flags allow you to control which features are enabled. When no
@ -165,7 +161,6 @@ be specified multiple times, which enables all specified features.</dd>
</dl>
### Compilation Options
<dl>
@ -181,26 +176,22 @@ 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-rustdoc--r"><a class="option-anchor" href="#option-cargo-rustdoc--r"></a><code>-r</code></dt>
<dt class="option-term" id="option-cargo-rustdoc---release"><a class="option-anchor" href="#option-cargo-rustdoc---release"></a><code>--release</code></dt>
<dd class="option-desc">Document optimized artifacts with the <code>release</code> profile.
See also the <code>--profile</code> option for choosing a specific profile by name.</dd>
<dt class="option-term" id="option-cargo-rustdoc---profile"><a class="option-anchor" href="#option-cargo-rustdoc---profile"></a><code>--profile</code> <em>name</em></dt>
<dd class="option-desc">Document 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-rustdoc---ignore-rust-version"><a class="option-anchor" href="#option-cargo-rustdoc---ignore-rust-version"></a><code>--ignore-rust-version</code></dt>
<dd class="option-desc">Document the target even if the selected Rust compiler is older than the
required Rust version as configured in the projects <code>rust-version</code> field.</dd>
<dt class="option-term" id="option-cargo-rustdoc---timings=fmts"><a class="option-anchor" href="#option-cargo-rustdoc---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
@ -219,7 +210,6 @@ information about timing information.</li>
</dl>
### Output Options
@ -231,7 +221,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
@ -264,7 +253,6 @@ terminal.</li>
<a href="../reference/config.html">config value</a>.</dd>
<dt class="option-term" id="option-cargo-rustdoc---message-format"><a class="option-anchor" href="#option-cargo-rustdoc---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>
@ -287,7 +275,6 @@ JSON diagnostics coming from rustc. Cargos own JSON diagnostics and others
coming from rustc are still emitted. Cannot be used with <code>human</code> or <code>short</code>.</li>
</ul></dd>
</dl>
### Manifest Options
@ -298,7 +285,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-rustdoc---frozen"><a class="option-anchor" href="#option-cargo-rustdoc---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-rustdoc---locked"><a class="option-anchor" href="#option-cargo-rustdoc---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -322,7 +308,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
@ -365,7 +350,6 @@ requires the <code>-Z unstable-options</code> flag to enable (see
</dl>
### Miscellaneous Options
<dl>
@ -378,7 +362,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>
<dt class="option-term" id="option-cargo-rustdoc---keep-going"><a class="option-anchor" href="#option-cargo-rustdoc---keep-going"></a><code>--keep-going</code></dt>
<dd class="option-desc">Build as many crates in the dependency graph as possible, rather than aborting
the build on the first one that fails to build.</p>
@ -388,7 +371,6 @@ one that succeeds (depending on which one of the two builds Cargo picked to run
first), whereas <code>cargo rustdoc -j1 --keep-going</code> would definitely run both
builds, even if the one run first fails.</dd>
</dl>
## ENVIRONMENT
@ -396,13 +378,11 @@ builds, even if the one run first fails.</dd>
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 documentation with custom CSS included from a given file:

View file

@ -28,7 +28,6 @@ for copying into a `Cargo.toml` manifest.
<dd class="option-desc">The URL of the registry index to use.</dd>
<dt class="option-term" id="option-cargo-search---registry"><a class="option-anchor" href="#option-cargo-search---registry"></a><code>--registry</code> <em>registry</em></dt>
<dd class="option-desc">Name of the registry to use. Registry names are defined in <a href="../reference/config.html">Cargo config
files</a>. If not specified, the default registry is used,
@ -36,7 +35,6 @@ which is defined by the <code>registry.default</code> config key which defaults
<code>crates-io</code>.</dd>
</dl>
### Display Options
@ -68,7 +66,6 @@ terminal.</li>
<p>May also be specified with the <code>term.color</code>
<a href="../reference/config.html">config value</a>.</dd>
</dl>
### Common Options
@ -111,19 +108,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. Search for a package from crates.io:

View file

@ -1,5 +1,4 @@
# cargo-test(1)
## NAME
cargo-test --- Execute unit and integration tests of a package
@ -88,7 +87,6 @@ as a whole.</dd>
</dl>
### Package Selection
By default, when no package selection options are given, the packages selected
@ -117,12 +115,10 @@ double quotes around each pattern.</dd>
<dd class="option-desc">Test all members in the workspace.</dd>
<dt class="option-term" id="option-cargo-test---all"><a class="option-anchor" href="#option-cargo-test---all"></a><code>--all</code></dt>
<dd class="option-desc">Deprecated alias for <code>--workspace</code>.</dd>
<dt class="option-term" id="option-cargo-test---exclude"><a class="option-anchor" href="#option-cargo-test---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
@ -133,7 +129,6 @@ single quotes or double quotes around each pattern.</dd>
</dl>
### Target Selection
When no target selection options are given, `cargo test` will build the
@ -173,7 +168,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 test only the specified
targets.
@ -197,7 +191,6 @@ and supports common Unix glob patterns.</dd>
<dd class="option-desc">Test all binary targets.</dd>
<dt class="option-term" id="option-cargo-test---example"><a class="option-anchor" href="#option-cargo-test---example"></a><code>--example</code> <em>name</em></dt>
<dd class="option-desc">Test the specified example. This flag may be specified multiple times
and supports common Unix glob patterns.</dd>
@ -243,7 +236,6 @@ manifest settings for the target.</dd>
</dl>
<dl>
<dt class="option-term" id="option-cargo-test---doc"><a class="option-anchor" href="#option-cargo-test---doc"></a><code>--doc</code></dt>
@ -281,7 +273,6 @@ be specified multiple times, which enables all specified features.</dd>
</dl>
### Compilation Options
<dl>
@ -297,26 +288,22 @@ 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-test--r"><a class="option-anchor" href="#option-cargo-test--r"></a><code>-r</code></dt>
<dt class="option-term" id="option-cargo-test---release"><a class="option-anchor" href="#option-cargo-test---release"></a><code>--release</code></dt>
<dd class="option-desc">Test optimized artifacts with the <code>release</code> profile.
See also the <code>--profile</code> option for choosing a specific profile by name.</dd>
<dt class="option-term" id="option-cargo-test---profile"><a class="option-anchor" href="#option-cargo-test---profile"></a><code>--profile</code> <em>name</em></dt>
<dd class="option-desc">Test 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-test---ignore-rust-version"><a class="option-anchor" href="#option-cargo-test---ignore-rust-version"></a><code>--ignore-rust-version</code></dt>
<dd class="option-desc">Test the target even if the selected Rust compiler is older than the
required Rust version as configured in the projects <code>rust-version</code> field.</dd>
<dt class="option-term" id="option-cargo-test---timings=fmts"><a class="option-anchor" href="#option-cargo-test---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
@ -335,7 +322,6 @@ information about timing information.</li>
</dl>
### Output Options
@ -347,7 +333,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
@ -387,7 +372,6 @@ terminal.</li>
<a href="../reference/config.html">config value</a>.</dd>
<dt class="option-term" id="option-cargo-test---message-format"><a class="option-anchor" href="#option-cargo-test---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>
@ -411,7 +395,6 @@ coming from rustc are still emitted. Cannot be used with <code>human</code> or <
</ul></dd>
</dl>
### Manifest Options
@ -423,7 +406,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-test---frozen"><a class="option-anchor" href="#option-cargo-test---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-test---locked"><a class="option-anchor" href="#option-cargo-test---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -448,7 +430,6 @@ 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
@ -491,7 +472,6 @@ requires the <code>-Z unstable-options</code> flag to enable (see
</dl>
### Miscellaneous Options
The `--jobs` argument affects the building of the test executable but does not
@ -511,14 +491,12 @@ 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>
<dt class="option-term" id="option-cargo-test---future-incompat-report"><a class="option-anchor" href="#option-cargo-test---future-incompat-report"></a><code>--future-incompat-report</code></dt>
<dd class="option-desc">Displays a future-incompat report for any future-incompatible warnings
produced during execution of this command</p>
<p>See <a href="cargo-report.html">cargo-report(1)</a></dd>
</dl>
While `cargo test` involves compilation, it does not provide a `--keep-going`
@ -534,13 +512,11 @@ build test binaries separately. For example:
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. Execute all the unit and integration tests of the current package:

View file

@ -1,5 +1,4 @@
# cargo-tree(1)
## NAME
cargo-tree --- Display a tree visualization of a dependency graph
@ -204,7 +203,6 @@ double quotes around each pattern.</dd>
<dt class="option-term" id="option-cargo-tree---exclude"><a class="option-anchor" href="#option-cargo-tree---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
@ -215,7 +213,6 @@ single quotes or double quotes around each pattern.</dd>
</dl>
### Manifest Options
<dl>
@ -225,7 +222,6 @@ single quotes or double quotes around each pattern.</dd>
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>
<dt class="option-term" id="option-cargo-tree---frozen"><a class="option-anchor" href="#option-cargo-tree---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-tree---locked"><a class="option-anchor" href="#option-cargo-tree---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -250,7 +246,6 @@ offline.</p>
<p>May also be specified with the <code>net.offline</code> <a href="../reference/config.html">config value</a>.</dd>
</dl>
### Feature Selection
@ -281,7 +276,6 @@ be specified multiple times, which enables all specified features.</dd>
</dl>
### Display Options
<dl>
@ -313,7 +307,6 @@ terminal.</li>
<a href="../reference/config.html">config value</a>.</dd>
</dl>
### Common Options
@ -356,19 +349,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. Display the tree for the package in the current directory:

View file

@ -25,7 +25,6 @@ The installation root is determined, in order of precedence:
- `CARGO_HOME` environment variable
- `$HOME/.cargo`
## OPTIONS
### Install Options
@ -78,7 +77,6 @@ terminal.</li>
<a href="../reference/config.html">config value</a>.</dd>
</dl>
### Common Options
@ -121,19 +119,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. Uninstall a previously installed package.

View file

@ -85,7 +85,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
@ -97,7 +96,6 @@ terminal.</li>
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>
<dt class="option-term" id="option-cargo-update---frozen"><a class="option-anchor" href="#option-cargo-update---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-update---locked"><a class="option-anchor" href="#option-cargo-update---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -122,7 +120,6 @@ 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
@ -165,19 +162,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. Update all dependencies in the lockfile:

View file

@ -62,7 +62,6 @@ only a subset of the packages have changed.</dd>
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>
<dt class="option-term" id="option-cargo-vendor---frozen"><a class="option-anchor" href="#option-cargo-vendor---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-vendor---locked"><a class="option-anchor" href="#option-cargo-vendor---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -87,7 +86,6 @@ offline.</p>
<p>May also be specified with the <code>net.offline</code> <a href="../reference/config.html">config value</a>.</dd>
</dl>
### Display Options
@ -121,7 +119,6 @@ terminal.</li>
<a href="../reference/config.html">config value</a>.</dd>
</dl>
### Common Options
@ -164,19 +161,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. Vendor all dependencies into a local "vendor" folder

View file

@ -52,7 +52,6 @@ terminal.</li>
<a href="../reference/config.html">config value</a>.</dd>
</dl>
### Manifest Options
@ -64,7 +63,6 @@ terminal.</li>
<code>Cargo.toml</code> file in the current directory or any parent directory.</dd>
<dt class="option-term" id="option-cargo-verify-project---frozen"><a class="option-anchor" href="#option-cargo-verify-project---frozen"></a><code>--frozen</code></dt>
<dt class="option-term" id="option-cargo-verify-project---locked"><a class="option-anchor" href="#option-cargo-verify-project---locked"></a><code>--locked</code></dt>
<dd class="option-desc">Either of these flags requires that the <code>Cargo.lock</code> file is
@ -89,7 +87,6 @@ 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
@ -132,13 +129,11 @@ 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`: The workspace is OK.

View file

@ -101,12 +101,10 @@ variables of the form <code>CARGO_REGISTRIES_NAME_TOKEN</code> where <code>NAME<
of the registry in all capital letters.</dd>
<dt class="option-term" id="option-cargo-yank---index"><a class="option-anchor" href="#option-cargo-yank---index"></a><code>--index</code> <em>index</em></dt>
<dd class="option-desc">The URL of the registry index to use.</dd>
<dt class="option-term" id="option-cargo-yank---registry"><a class="option-anchor" href="#option-cargo-yank---registry"></a><code>--registry</code> <em>registry</em></dt>
<dd class="option-desc">Name of the registry to use. Registry names are defined in <a href="../reference/config.html">Cargo config
files</a>. If not specified, the default registry is used,
@ -114,7 +112,6 @@ which is defined by the <code>registry.default</code> config key which defaults
<code>crates-io</code>.</dd>
</dl>
### Display Options
@ -148,7 +145,6 @@ terminal.</li>
<a href="../reference/config.html">config value</a>.</dd>
</dl>
### Common Options
@ -191,19 +187,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. Yank a crate from the index: