34
34
//! The steps for adding new Cargo.toml syntax are:
35
35
//!
36
36
//! 1. Add the cargo-features unstable gate. Search below for "look here" to
37
- //! find the `features!` macro invocation and add your feature to the list.
37
+ //! find the [ `features!`] macro invocation and add your feature to the list.
38
38
//!
39
39
//! 2. Update the Cargo.toml parsing code to handle your new feature.
40
40
//!
76
76
//! The steps for stabilizing are roughly:
77
77
//!
78
78
//! 1. Update the feature to be stable, based on the kind of feature:
79
- //! 1. `cargo-features`: Change the feature to `stable` in the `features!`
79
+ //! 1. `cargo-features`: Change the feature to `stable` in the [ `features!`]
80
80
//! macro invocation below, and include the version and a URL for the
81
81
//! documentation.
82
82
//! 2. `-Z unstable-options`: Find the call to [`fail_if_stable_opt`] and
95
95
//!
96
96
//! [`Config::cli_unstable`]: crate::util::config::Config::cli_unstable
97
97
//! [`fail_if_stable_opt`]: CliUnstable::fail_if_stable_opt
98
+ //! [`features!`]: macro.features.html
98
99
99
100
use std:: collections:: BTreeSet ;
100
101
use std:: env;
@@ -126,7 +127,7 @@ pub const SEE_CHANNELS: &str =
126
127
/// - Update the [`FromStr`] impl.
127
128
/// - Update [`CLI_VALUES`] to include the new edition.
128
129
/// - Set [`LATEST_UNSTABLE`] to Some with the new edition.
129
- /// - Add an unstable feature to the `features!` macro invocation below for the new edition.
130
+ /// - Add an unstable feature to the [ `features!`] macro invocation below for the new edition.
130
131
/// - Gate on that new feature in [`TomlManifest::to_real_manifest`].
131
132
/// - Update the shell completion files.
132
133
/// - Update any failing tests (hopefully there are very few).
@@ -137,7 +138,7 @@ pub const SEE_CHANNELS: &str =
137
138
/// - Set [`LATEST_UNSTABLE`] to None.
138
139
/// - Set [`LATEST_STABLE`] to the new version.
139
140
/// - Update [`is_stable`] to `true`.
140
- /// - Set the editionNNNN feature to stable in the `features!` macro invocation below.
141
+ /// - Set the editionNNNN feature to stable in the [ `features!`] macro invocation below.
141
142
/// - Update any tests that are affected.
142
143
/// - Update the man page for the `--edition` flag.
143
144
/// - Update unstable.md to move the edition section to the bottom.
@@ -155,6 +156,7 @@ pub const SEE_CHANNELS: &str =
155
156
/// [this example]: https://github.com/rust-lang/cargo/blob/3ebb5f15a940810f250b68821149387af583a79e/src/doc/src/reference/unstable.md?plain=1#L1238-L1264
156
157
/// [`is_stable`]: Edition::is_stable
157
158
/// [`TomlManifest::to_real_manifest`]: crate::util::toml::TomlManifest::to_real_manifest
159
+ /// [`features!`]: macro.features.html
158
160
#[ derive( Clone , Copy , Debug , Hash , PartialOrd , Ord , Eq , PartialEq , Serialize , Deserialize ) ]
159
161
pub enum Edition {
160
162
/// The 2015 edition
0 commit comments