feat: Stabilize Edition 2024 (#14828)

### What does this PR try to resolve?

### How should we test and review this PR?

### Additional information

Author: ehuss

src/cargo/core/features.rs

@@ -162,6 +162,7 @@ pub type AllowFeatures = BTreeSet<String>;
 /// - Set [`LATEST_UNSTABLE`] to None.
 /// - Set [`LATEST_STABLE`] to the new version.
 /// - Update [`is_stable`] to `true`.
+/// - Set [`first_version`] to the version it will be released.
 /// - Set the editionNNNN feature to stable in the [`features!`] macro invocation below.
 /// - Update any tests that are affected.
 /// - Update the man page for the `--edition` flag.
@@ -178,6 +179,7 @@ pub type AllowFeatures = BTreeSet<String>;
 /// [`LATEST_UNSTABLE`]: Edition::LATEST_UNSTABLE
 /// [`LATEST_STABLE`]: Edition::LATEST_STABLE
 /// [this example]: https://github.com/rust-lang/cargo/blob/3ebb5f15a940810f250b68821149387af583a79e/src/doc/src/reference/unstable.md?plain=1#L1238-L1264
+/// [`first_version`]: Edition::first_version
 /// [`is_stable`]: Edition::is_stable
 /// [`toml`]: crate::util::toml
 /// [`features!`]: macro.features.html
@@ -200,9 +202,9 @@ impl Edition {
     /// The latest edition that is unstable.
     ///
     /// This is `None` if there is no next unstable edition.
-    pub const LATEST_UNSTABLE: Option<Edition> = Some(Edition::Edition2024);
+    pub const LATEST_UNSTABLE: Option<Edition> = None;
     /// The latest stable edition.
-    pub const LATEST_STABLE: Edition = Edition::Edition2021;
+    pub const LATEST_STABLE: Edition = Edition::Edition2024;
     pub const ALL: &'static [Edition] = &[
         Self::Edition2015,
         Self::Edition2018,
@@ -223,7 +225,7 @@ impl Edition {
             Edition2015 => None,
             Edition2018 => Some(semver::Version::new(1, 31, 0)),
             Edition2021 => Some(semver::Version::new(1, 56, 0)),
-            Edition2024 => None,
+            Edition2024 => Some(semver::Version::new(1, 85, 0)),
         }
     }
 
@@ -234,7 +236,7 @@ impl Edition {
             Edition2015 => true,
             Edition2018 => true,
             Edition2021 => true,
-            Edition2024 => false,
+            Edition2024 => true,
         }
     }
 
@@ -507,7 +509,7 @@ features! {
     (stable, workspace_inheritance, "1.64", "reference/unstable.html#workspace-inheritance"),
 
     /// Support for 2024 edition.
-    (unstable, edition2024, "", "reference/unstable.html#edition-2024"),
+    (stable, edition2024, "1.85", "reference/manifest.html#the-edition-field"),
 
     /// Allow setting trim-paths in a profile to control the sanitisation of file paths in build outputs.
     (unstable, trim_paths, "", "reference/unstable.html#profile-trim-paths-option"),

src/cargo/util/toml/embedded.rs

@@ -567,7 +567,7 @@ autoexamples = false
 autolib = false
 autotests = false
 build = false
-edition = "2021"
+edition = "2024"
 name = "test-"
 
 [profile.release]
@@ -605,7 +605,7 @@ autoexamples = false
 autolib = false
 autotests = false
 build = false
-edition = "2021"
+edition = "2024"
 name = "test-"
 
 [profile.release]

src/cargo/util/toml/mod.rs

@@ -1217,9 +1217,7 @@ pub fn to_real_manifest(
     //     features.require(Feature::edition20xx())?;
     // }
     // ```
-    if edition == Edition::Edition2024 {
-        features.require(Feature::edition2024())?;
-    } else if !edition.is_stable() {
+    if !edition.is_stable() {
         // Guard in case someone forgets to add .require()
         return Err(util::errors::internal(format!(
             "edition {} should be gated",

src/doc/man/generated_txt/cargo-init.txt

@@ -30,7 +30,7 @@ OPTIONS
            Create a package with a library target (src/lib.rs).
 
        --edition edition
-           Specify the Rust edition to use. Default is 2021. Possible values:
+           Specify the Rust edition to use. Default is 2024. Possible values:
            2015, 2018, 2021, 2024
 
        --name name

src/doc/man/generated_txt/cargo-new.txt

@@ -25,7 +25,7 @@ OPTIONS
            Create a package with a library target (src/lib.rs).
 
        --edition edition
-           Specify the Rust edition to use. Default is 2021. Possible values:
+           Specify the Rust edition to use. Default is 2024. Possible values:
            2015, 2018, 2021, 2024
 
        --name name

src/doc/man/includes/options-new.md

@@ -10,7 +10,7 @@ Create a package with a library target (`src/lib.rs`).
 {{/option}}
 
 {{#option "`--edition` _edition_" }}
-Specify the Rust edition to use. Default is 2021.
+Specify the Rust edition to use. Default is 2024.
 Possible values: 2015, 2018, 2021, 2024
 {{/option}}
 

src/doc/src/commands/cargo-init.md

@@ -39,7 +39,7 @@ This is the default behavior.</dd>
 
 
 <dt class="option-term" id="option-cargo-init---edition"><a class="option-anchor" href="#option-cargo-init---edition"></a><code>--edition</code> <em>edition</em></dt>
-<dd class="option-desc">Specify the Rust edition to use. Default is 2021.
+<dd class="option-desc">Specify the Rust edition to use. Default is 2024.
 Possible values: 2015, 2018, 2021, 2024</dd>
 
 

src/doc/src/commands/cargo-new.md

@@ -34,7 +34,7 @@ This is the default behavior.</dd>
 
 
 <dt class="option-term" id="option-cargo-new---edition"><a class="option-anchor" href="#option-cargo-new---edition"></a><code>--edition</code> <em>edition</em></dt>
-<dd class="option-desc">Specify the Rust edition to use. Default is 2021.
+<dd class="option-desc">Specify the Rust edition to use. Default is 2024.
 Possible values: 2015, 2018, 2021, 2024</dd>
 
 

src/doc/src/getting-started/first-steps.md

@@ -33,7 +33,7 @@ This is all we need to get started. First, let’s check out `Cargo.toml`:
 [package]
 name = "hello_world"
 version = "0.1.0"
-edition = "2021"
+edition = "2024"
 
 [dependencies]
 ```

src/doc/src/guide/creating-a-new-project.md

@@ -29,7 +29,7 @@ Let’s take a closer look at `Cargo.toml`:
 [package]
 name = "hello_world"
 version = "0.1.0"
-edition = "2021"
+edition = "2024"
 
 [dependencies]