fix(toml): Report '<target>.edition' deprecation to users (#15321)

### What does this PR try to resolve?

This is a part of #15283

In the RFC, I mentioned this might be blocked on #12235.
In hindsight, the use of this is [rare
enough](https://rust-lang.zulipchat.com/#narrow/channel/246057-t-cargo/topic/Deprecate.20build-target.20.60edition.60.20field.3F/near/499047806)
that I suspect we can go ahead and warn without user controllable lints.

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

### Additional information

Author: ehuss

src/cargo/util/toml/targets.rs

@@ -76,24 +76,28 @@ pub(super) fn to_targets(
         normalized_toml.bin.as_deref().unwrap_or_default(),
         package_root,
         edition,
+        warnings,
     )?);
 
     targets.extend(to_example_targets(
         normalized_toml.example.as_deref().unwrap_or_default(),
         package_root,
         edition,
+        warnings,
     )?);
 
     targets.extend(to_test_targets(
         normalized_toml.test.as_deref().unwrap_or_default(),
         package_root,
         edition,
+        warnings,
     )?);
 
     targets.extend(to_bench_targets(
         normalized_toml.bench.as_deref().unwrap_or_default(),
         package_root,
         edition,
+        warnings,
     )?);
 
     // processing the custom build script
@@ -259,7 +263,7 @@ fn to_lib_target(
     };
 
     let mut target = Target::lib_target(name_or_panic(lib), crate_types, path, edition);
-    configure(lib, &mut target)?;
+    configure(lib, &mut target, TARGET_KIND_HUMAN_LIB, warnings)?;
     target.set_name_inferred(original_lib.map_or(true, |v| v.name.is_none()));
     Ok(Some(target))
 }
@@ -348,6 +352,7 @@ fn to_bin_targets(
     bins: &[TomlBinTarget],
     package_root: &Path,
     edition: Edition,
+    warnings: &mut Vec<String>,
 ) -> CargoResult<Vec<Target>> {
     // This loop performs basic checks on each of the TomlTarget in `bins`.
     for bin in bins {
@@ -371,7 +376,7 @@ fn to_bin_targets(
             edition,
         );
 
-        configure(bin, &mut target)?;
+        configure(bin, &mut target, TARGET_KIND_HUMAN_BIN, warnings)?;
         result.push(target);
     }
     Ok(result)
@@ -430,6 +435,7 @@ fn to_example_targets(
     targets: &[TomlExampleTarget],
     package_root: &Path,
     edition: Edition,
+    warnings: &mut Vec<String>,
 ) -> CargoResult<Vec<Target>> {
     validate_unique_names(&targets, TARGET_KIND_EXAMPLE)?;
 
@@ -448,7 +454,7 @@ fn to_example_targets(
             toml.required_features.clone(),
             edition,
         );
-        configure(&toml, &mut target)?;
+        configure(&toml, &mut target, TARGET_KIND_HUMAN_EXAMPLE, warnings)?;
         result.push(target);
     }
 
@@ -487,6 +493,7 @@ fn to_test_targets(
     targets: &[TomlTestTarget],
     package_root: &Path,
     edition: Edition,
+    warnings: &mut Vec<String>,
 ) -> CargoResult<Vec<Target>> {
     validate_unique_names(&targets, TARGET_KIND_TEST)?;
 
@@ -499,7 +506,7 @@ fn to_test_targets(
             toml.required_features.clone(),
             edition,
         );
-        configure(&toml, &mut target)?;
+        configure(&toml, &mut target, TARGET_KIND_HUMAN_TEST, warnings)?;
         result.push(target);
     }
     Ok(result)
@@ -554,6 +561,7 @@ fn to_bench_targets(
     targets: &[TomlBenchTarget],
     package_root: &Path,
     edition: Edition,
+    warnings: &mut Vec<String>,
 ) -> CargoResult<Vec<Target>> {
     validate_unique_names(&targets, TARGET_KIND_BENCH)?;
 
@@ -566,7 +574,7 @@ fn to_bench_targets(
             toml.required_features.clone(),
             edition,
         );
-        configure(&toml, &mut target)?;
+        configure(&toml, &mut target, TARGET_KIND_HUMAN_BENCH, warnings)?;
         result.push(target);
     }
 
@@ -892,7 +900,12 @@ fn validate_unique_names(targets: &[TomlTarget], target_kind: &str) -> CargoResu
     Ok(())
 }
 
-fn configure(toml: &TomlTarget, target: &mut Target) -> CargoResult<()> {
+fn configure(
+    toml: &TomlTarget,
+    target: &mut Target,
+    target_kind_human: &str,
+    warnings: &mut Vec<String>,
+) -> CargoResult<()> {
     let t2 = target.clone();
     target
         .set_tested(toml.test.unwrap_or_else(|| t2.tested()))
@@ -909,6 +922,10 @@ fn configure(toml: &TomlTarget, target: &mut Target) -> CargoResult<()> {
         .set_for_host(toml.proc_macro().unwrap_or_else(|| t2.for_host()));
 
     if let Some(edition) = toml.edition.clone() {
+        let name = target.name();
+        warnings.push(format!(
+            "`edition` is set on {target_kind_human} `{name}` which is deprecated"
+        ));
         target.set_edition(
             edition
                 .parse()

tests/testsuite/build.rs

@@ -5404,6 +5404,7 @@ fn target_edition() {
 
     p.cargo("build -v")
         .with_stderr_data(str![[r#"
+[WARNING] `edition` is set on library `foo` which is deprecated
 [COMPILING] foo v0.0.1 ([ROOT]/foo)
 [RUNNING] `rustc [..]--edition=2018 [..]`
 [FINISHED] `dev` profile [unoptimized + debuginfo] target(s) in [ELAPSED]s

tests/testsuite/freshness.rs

@@ -2255,13 +2255,15 @@ fn edition_change_invalidates() {
     );
     p.cargo("build")
         .with_stderr_data(str![[r#"
+[WARNING] `edition` is set on library `foo` which is deprecated
 [COMPILING] foo v0.1.0 ([ROOT]/foo)
 [FINISHED] `dev` profile [unoptimized + debuginfo] target(s) in [ELAPSED]s
 
 "#]])
         .run();
     p.cargo("build -v")
         .with_stderr_data(str![[r#"
+[WARNING] `edition` is set on library `foo` which is deprecated
 [FRESH] foo v0.1.0 ([ROOT]/foo)
 [FINISHED] `dev` profile [unoptimized + debuginfo] target(s) in [ELAPSED]s
 

tests/testsuite/freshness_checksum.rs

@@ -2030,6 +2030,7 @@ fn edition_change_invalidates() {
     p.cargo("build -Zchecksum-freshness")
         .masquerade_as_nightly_cargo(&["checksum-freshness"])
         .with_stderr_data(str![[r#"
+[WARNING] `edition` is set on library `foo` which is deprecated
 [COMPILING] foo v0.1.0 ([ROOT]/foo)
 [FINISHED] `dev` profile [unoptimized + debuginfo] target(s) in [ELAPSED]s
 
@@ -2038,6 +2039,7 @@ fn edition_change_invalidates() {
     p.cargo("build -Zchecksum-freshness -v")
         .masquerade_as_nightly_cargo(&["checksum-freshness"])
         .with_stderr_data(str![[r#"
+[WARNING] `edition` is set on library `foo` which is deprecated
 [FRESH] foo v0.1.0 ([ROOT]/foo)
 [FINISHED] `dev` profile [unoptimized + debuginfo] target(s) in [ELAPSED]s