Commit Graph

57 Commits

Author SHA1 Message Date
Ed Page a0ba72918a fix(help): Generalize --ignore-rust-version 2024-04-11 13:45:39 -05:00
Weihang Lo 26b2e74e55
docs: clarify `--locked` disallows changes in `Cargo.lock` 2024-03-28 12:08:57 -04:00
Weihang Lo e549bc809b
fix(cli): resolve confusion between `--frozen` and `--locked` 2024-03-27 22:05:03 -04:00
Martin Robinson 8fa25ba41d chore: Fix minor grammar nit in command-line help
A *very* minor grammar correction. "Require" used in this way is
typically followed by the infinitive.
2024-03-18 14:32:28 +01:00
Bryan Garza 604d2e40e2 chore: update pulldown-cmark to 0.10.0
Fixes: https://github.com/rust-lang/cargo/issues/13509
2024-03-04 20:14:44 +00:00
shuoer86 6c2579184a
docs: fix typos 2023-10-19 21:13:07 +08:00
David Tolnay ece5269e97
Stabilize --keep-going 2023-08-26 13:14:39 -07:00
Charalampos Mitrodimas a777b82d5f Support "default" option for build.jobs
This commit adds support for passing the keyword "default"
to either the CLI "--jobs" argument on the "[build.jobs]"
section of ".cargo/config".

This is dony by:
  1. Changing the "jobs" config type to an enum that holds
     a String or an Integer(i.e. i32).
  2. Matching the enum & casting it to an integer

Signed-off-by: Charalampos Mitrodimas <charmitro@gmail.com>
2023-06-03 15:24:41 +03:00
Eric Huss 3da2b3c67b Mark -C as unstable 2023-04-11 19:46:05 -07:00
Eric Huss 9ba2ca2034 Clarify docs on `-C` that it appears before the command. 2023-04-09 09:58:06 -07:00
Enyium b1754b2aa2 Regenerate derived doc formats. 2023-02-14 08:24:20 +01:00
Will Page 6510cc5c4b Regenerated documentation with updated '-C' cargo option 2023-02-10 07:42:48 -08:00
Weihang Lo 65332bc9f1
Expand details for `--config` cli arg 2022-09-13 10:25:54 +01:00
andrewpollack 195b1e0e50 Removing excess in 2022-08-11 16:47:52 -07:00
hi-rustin a6e6b89d71 Mark -timings=html unstable in the document
Signed-off-by: hi-rustin <rustin.liu@gmail.com>
2022-08-05 19:39:13 +08:00
Yerkebulan Tulibergenov 767368fd02 Merge branch 'master' into yerke/negative_jobs 2022-07-31 18:21:33 -07:00
Weihang Lo 3e177e0f45
Update docs for -Zmultitarget stabilization 2022-07-17 11:02:01 +01:00
Yerkebulan Tulibergenov 5b76fb3d2b update man pages 2022-07-10 16:06:25 -07:00
Jon Gjengset 7eefb4221f Include --config in cargo help output 2022-06-21 16:24:41 +00:00
Ed Page f728045729 doc: Include `-F` in option lists
The manual change is to `src/doc/man/includes/section-features.md`, the
rest is code-generated.
2022-04-18 19:19:40 -05:00
David Tolnay 4e45f58852
Unstable --keep-going flag 2022-03-21 18:36:40 -07:00
Piggy NL 08734a6643
Fix errors in `cargo fetch` usage guide
Co-authored-by: Caleb Maclennan <caleb@alerque.com>
2022-02-18 01:10:33 +08:00
Josh Triplett 086e71da00 Fix typo: `--timing` -> `--timings` 2022-01-30 21:43:52 -08:00
Josh Triplett 81e1998e11 Make `--timings=html` unstable, and only stabilize `--timings` 2022-01-30 21:43:52 -08:00
Josh Triplett c854247149 Make `--timings` require `=` if passing an argument
This avoids ambiguity between its optional argument and positional
arguments.
2022-01-30 21:43:52 -08:00
Josh Triplett e23f5f41d1 Move timing reports to `target/cargo-timings`
This avoids dropping them wherever Cargo happens to run from, and
instead places them under the target directory.

This has the advantage, and disadvantage, that `cargo clean` will remove
them.
2022-01-30 21:43:52 -08:00
Josh Triplett c06691897a Stabilize `-Ztimings` as `--timings`
The `-Ztimings` option has existed for years, and many people use it to
profile and optimize their builds. It's one of the common reasons people
use nightly cargo.

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

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

Document the new option, and update the testsuite.
2022-01-30 21:43:48 -08:00
bors a359ce1607 Auto merge of #10152 - steven-joruk:quiet-config, r=ehuss
Support `term.quiet` configuration

Fixes #10128

This follows the existing support for `--verbose` and `term.verbose`.

I've renamed the related tests to be a bit clearer now there are more cases, and the existing quiet tests now prove that they hide the cargo log.

I'm unsure whether I'm supposed to regenerate the documentation as part of this?
2021-12-14 18:40:22 +00:00
Steven Joruk cd4e280458 Update docs 2021-12-08 22:18:47 +00:00
Josh Triplett c92d917f31 Update documentation for the `-r` short option for `--release` 2021-12-03 22:39:24 -08:00
hi-rustin 17c0ea7417 Improve the help text of the --quiet args for all commands
Signed-off-by: hi-rustin <rustin.liu@gmail.com>
2021-11-14 20:41:00 +08:00
Eric Huss 895f52714c Stabilize named profiles. 2021-09-24 10:00:42 -07:00
Dirkjan Ochtman db3776cfef Document the rust-version field 2021-08-02 13:38:58 +02:00
bors 8eb0e9a855 Auto merge of #9184 - ehuss:fix-next-edition, r=alexcrichton
Updates to edition handling.

This introduces some updates for edition handling (split into commits for review).  In short:

* `cargo-features = ["edition2021"]` can be used to opt-in to 2021 support without needing to pass around `-Z unstable-options`. I tried to emphasize in the docs that this is only for testing and experimentation.
* Make `"2"` the default resolver for 2021 edition.
* Make `cargo fix --edition` mean the "next" edition from the present one, and support 2021. Also, if already at the latest edition, generate a warning instead an error.
* I decided to allow `cargo fix --edition` from 2018 to 2021 on the nightly channel without an explicit opt-in. It's tricky to implement with an opt-in (see comment in diff).

Partial for #9048.
Fixes #9047.
2021-02-23 21:35:42 +00:00
Eric Huss 15513ce741 Add some more details to the `cargo fix --edition` procedure. 2021-02-19 14:29:45 -08:00
Weihang Lo ee53210f9e
doc: generated by build-man.sh 2021-02-19 22:00:57 +08:00
Eric Huss 21cfac6c09 Update `cargo fix --edition` docs.
# Conflicts:
#	src/cargo/ops/fix.rs
#	src/doc/src/reference/unstable.md
2021-02-17 22:14:35 -08:00
Casey Rodarmor d174b77337
Clarify which values may be used together with `--message-format` 2021-02-14 17:58:26 -08:00
Eric Huss d087aeb845 Stabilize -Zfeatures and -Zpackage-features. 2020-12-19 08:26:42 -08:00
Weihang Lo 4a61d8a412
doc: build-man.sh for glob pattern support 2020-10-05 01:24:43 +08:00
Eric Huss fac70ee775 Update links to rustup docs. 2020-09-26 10:09:04 -07:00
Eric Huss 2d4aa38b4f Regenerate man pages using mdman. 2020-08-01 11:14:00 -07:00
Eric Huss 337fd9f015 Add some help about rustup's +toolchain syntax. 2020-07-06 07:02:12 -07:00
Eric Huss 7551730403 Try to clarify how feature flags work on the "current" package. 2020-02-24 18:01:30 -08:00
Eric Huss 47a46ae77a Try to be clearer about how `--target` is different.
Closes #3817
2019-12-19 13:57:27 -08:00
Eric Huss fee34fcf65 Clarify `cargo fix` behavior with features. 2019-12-19 10:11:17 -08:00
Eric Huss bb3f1325a9 Mention that `--features` can be specified multiple times. 2019-12-18 08:28:28 -08:00
Eric Huss dda81d3177 Stabilize profile-overrides. 2019-11-15 17:13:55 -08:00
Eric Huss a280f8a52f Document Cargo's JSON output. 2019-11-15 13:03:47 -08:00
Eric Huss da3ac84ecf Rebuild docs for rephrase --manifest-path. 2019-10-28 12:09:26 -07:00