From 6641226ba8bf4054bc68c4eff430ba962552028c Mon Sep 17 00:00:00 2001 From: Smittyvb Date: Tue, 29 Jun 2021 12:41:13 -0400 Subject: [PATCH] Document how to mark features as incomplete (#1151) * Document how to mark features as incomplete This was changed in https://github.com/rust-lang/rust/pull/86446 so that incompleteness is included in the delcaration. * Footerify link --- src/feature-gates.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/src/feature-gates.md b/src/feature-gates.md index db6c72ff..229281f2 100644 --- a/src/feature-gates.md +++ b/src/feature-gates.md @@ -27,6 +27,14 @@ For example: (active, non_ascii_idents, "1.0.0", Some(55467), None), ``` +Features can be marked as incomplete, and trigger the warn-by-default [`incomplete_features` lint] +by setting their type to `incomplete`: + +```rust,ignore +/// Allows unsized rvalues at arguments and parameters. +(incomplete, unsized_locals, "1.30.0", Some(48055), None), +``` + When added, the current version should be the one for the current nightly. Once the feature is moved to `accepted.rs`, the version is changed to that nightly version. @@ -99,4 +107,5 @@ updating the declaration! ["Stability in code"]: ./implementing_new_features.md#stability-in-code +[`incomplete_features` lint]: https://doc.rust-lang.org/rustc/lints/listing/warn-by-default.html#incomplete-features ["Updating the feature-gate listing"]: ./stabilization_guide.md#updating-the-feature-gate-listing