mirror of
https://github.com/rust-lang/cargo
synced 2024-08-25 02:25:46 +00:00
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:
commit
c21be2b7cf
119
Cargo.lock
generated
119
Cargo.lock
generated
|
@ -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]]
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -49,7 +49,6 @@ man page:
|
|||
- Other helpers include:
|
||||
- `{{lower value}}` Converts the given value to lowercase.
|
||||
|
||||
|
||||
## OPTIONS
|
||||
|
||||
<dl>
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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
|
||||
))
|
||||
|
|
|
@ -32,6 +32,7 @@ Shortcut unknown: [shortcut unknown]
|
|||
|
||||
{{> links-include}}
|
||||
|
||||
|
||||
## OPTIONS
|
||||
|
||||
{{#options}}
|
||||
|
|
|
@ -46,6 +46,7 @@ A named argument.
|
|||
|
||||
{{> options-common}}
|
||||
|
||||
|
||||
## EXAMPLES
|
||||
|
||||
1. An example
|
||||
|
|
|
@ -2,6 +2,7 @@
|
|||
|
||||
{{*set foo="Bar"}}
|
||||
|
||||
|
||||
{{foo}}
|
||||
|
||||
{{lower foo}}
|
||||
|
|
|
@ -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).
|
||||
|
|
|
@ -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).
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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 project’s <code>rust-version</code> field.</dd>
|
||||
|
||||
|
||||
|
||||
<dt class="option-term" id="option-cargo-bench---timings=fmts"><a class="option-anchor" href="#option-cargo-bench---timings=fmts"></a><code>--timings=</code><em>fmts</em></dt>
|
||||
<dd class="option-desc">Output information how long each compilation takes, and track concurrency
|
||||
information over time. Accepts an optional comma-separated list of output
|
||||
|
@ -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:
|
||||
|
|
|
@ -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 project’s <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:
|
||||
|
|
|
@ -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 project’s <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. Cargo’s 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:
|
||||
|
|
|
@ -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><arch><sub>-<vendor>-<sys>-<abi></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:
|
||||
|
|
|
@ -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 project’s <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. Cargo’s 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
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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 project’s <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. Cargo’s 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:
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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 project’s <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:
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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">Don’t 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:
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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 project’s <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):
|
||||
|
|
|
@ -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 project’s <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:
|
||||
|
|
|
@ -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 project’s <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. Cargo’s 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:
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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 project’s <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:
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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.
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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.
|
||||
|
|
|
@ -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:
|
||||
|
|
Loading…
Reference in a new issue