diff options
Diffstat (limited to 'src/doc/man/includes/options-message-format.md')
-rw-r--r-- | src/doc/man/includes/options-message-format.md | 21 |
1 files changed, 21 insertions, 0 deletions
diff --git a/src/doc/man/includes/options-message-format.md b/src/doc/man/includes/options-message-format.md new file mode 100644 index 0000000..61e970a --- /dev/null +++ b/src/doc/man/includes/options-message-format.md @@ -0,0 +1,21 @@ +{{#option "`--message-format` _fmt_" }} +The output format for diagnostic messages. Can be specified multiple times +and consists of comma-separated values. Valid values: + +- `human` (default): Display in a human-readable text format. Conflicts with + `short` and `json`. +- `short`: Emit shorter, human-readable text messages. Conflicts with `human` + and `json`. +- `json`: Emit JSON messages to stdout. See + [the reference](../reference/external-tools.html#json-messages) + for more details. Conflicts with `human` and `short`. +- `json-diagnostic-short`: Ensure the `rendered` field of JSON messages contains + the "short" rendering from rustc. Cannot be used with `human` or `short`. +- `json-diagnostic-rendered-ansi`: Ensure the `rendered` field of JSON messages + contains embedded ANSI color codes for respecting rustc's default color + scheme. Cannot be used with `human` or `short`. +- `json-render-diagnostics`: Instruct Cargo to not include rustc diagnostics + in JSON messages printed, but instead Cargo itself should render the + JSON diagnostics coming from rustc. Cargo's own JSON diagnostics and others + coming from rustc are still emitted. Cannot be used with `human` or `short`. +{{/option}} |