Auto merge of #13371 - epage:new-comment, r=weihanglo

fix(new): Print a note, rather than a comment, for more information

### What does this PR try to resolve?

For myself, I find it frustrating when tools add boilerplate that I have to remove after every use.  A `note:` on the command-line is more ephemeral, helping people who need it while not interfering with those that don't.

Fixes #12210

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

### Additional information

Author: bors

src/cargo/ops/cargo_new.rs

@@ -784,8 +784,7 @@ fn mk(config: &Config, opts: &MkOptions<'_>) -> CargoResult<()> {
         array.push(registry);
         manifest["package"]["publish"] = toml_edit::value(array);
     }
-    let mut dep_table = toml_edit::Table::default();
-    dep_table.decor_mut().set_prefix("\n# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html\n\n");
+    let dep_table = toml_edit::Table::default();
     manifest["dependencies"] = toml_edit::Item::Table(dep_table);
 
     // Calculate what `[lib]` and `[[bin]]`s we need to append to `Cargo.toml`.
@@ -911,6 +910,10 @@ mod tests {
         );
     }
 
+    config.shell().note(
+        "see more `Cargo.toml` keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html",
+    )?;
+
     Ok(())
 }
 

tests/testsuite/cargo_init/auto_git/out/Cargo.toml

@@ -3,6 +3,4 @@ name = "case"
 version = "0.1.0"
 edition = "2021"
 
-# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
-
 [dependencies]

tests/testsuite/cargo_init/auto_git/stderr.log

@@ -1 +1,2 @@
     Creating library package
+note: see more `Cargo.toml` keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

tests/testsuite/cargo_init/bin_already_exists_explicit/out/Cargo.toml

@@ -3,6 +3,4 @@ name = "case"
 version = "0.1.0"
 edition = "2021"
 
-# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
-
 [dependencies]

tests/testsuite/cargo_init/bin_already_exists_explicit/stderr.log

@@ -1 +1,2 @@
     Creating binary (application) package
+note: see more `Cargo.toml` keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

tests/testsuite/cargo_init/bin_already_exists_explicit_nosrc/out/Cargo.toml

@@ -3,8 +3,6 @@ name = "case"
 version = "0.1.0"
 edition = "2021"
 
-# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
-
 [dependencies]
 
 [[bin]]

tests/testsuite/cargo_init/bin_already_exists_explicit_nosrc/stderr.log

@@ -1 +1,2 @@
     Creating binary (application) package
+note: see more `Cargo.toml` keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

tests/testsuite/cargo_init/bin_already_exists_implicit/out/Cargo.toml

@@ -3,6 +3,4 @@ name = "case"
 version = "0.1.0"
 edition = "2021"
 
-# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
-
 [dependencies]

tests/testsuite/cargo_init/bin_already_exists_implicit/stderr.log

@@ -1 +1,2 @@
     Creating binary (application) package
+note: see more `Cargo.toml` keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

tests/testsuite/cargo_init/bin_already_exists_implicit_namenosrc/out/Cargo.toml

@@ -3,8 +3,6 @@ name = "case"
 version = "0.1.0"
 edition = "2021"
 
-# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
-
 [dependencies]
 
 [[bin]]