From c6c14a040dc33663a3e14f1e8a3d0938c65e7ca6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20BRANSTETT?= Date: Mon, 21 Mar 2022 12:59:46 +0100 Subject: [PATCH] Update unstable book with the new `values()` form for check-cfg --- src/doc/unstable-book/src/compiler-flags/check-cfg.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/src/doc/unstable-book/src/compiler-flags/check-cfg.md b/src/doc/unstable-book/src/compiler-flags/check-cfg.md index d7345ad0c33f2..486b3d4414f3a 100644 --- a/src/doc/unstable-book/src/compiler-flags/check-cfg.md +++ b/src/doc/unstable-book/src/compiler-flags/check-cfg.md @@ -92,8 +92,6 @@ and `cfg!(name = "value")` call. It will check that the `"value"` specified is p list of expected values. If `"value"` is not in it, then `rustc` will report an `unexpected_cfgs` lint diagnostic. The default diagnostic level for this lint is `Warn`. -The form `values()` is an error, because it does not specify a condition name. - To enable checking of values, but to provide an empty set of valid values, use this form: ```bash @@ -104,13 +102,17 @@ The `--check-cfg values(...)` option can be repeated, both for the same conditio different names. If it is repeated for the same condition name, then the sets of values for that condition are merged together. +If `values()` is specified, then `rustc` will enable the checking of well-known values defined +by itself. Note that it's necessary to specify the `values()` form to enable the checking of +well known values, specifying the other forms doesn't implicitly enable it. + ## Examples Consider this command line: ```bash rustc --check-cfg 'names(feature)' \ - --check-cfg 'values(feature,"lion","zebra")' \ + --check-cfg 'values(feature, "lion", "zebra")' \ --cfg 'feature="lion"' -Z unstable-options \ example.rs ```