refactor: use annotate-snippets style report

Author: 0xPoe

src/cargo/ops/common_for_install_and_uninstall.rs

@@ -6,6 +6,7 @@ use std::path::{Path, PathBuf};
 use std::rc::Rc;
 use std::task::Poll;
 
+use annotate_snippets::Level;
 use anyhow::{Context as _, bail, format_err};
 use cargo_util::paths;
 use cargo_util_schemas::core::PartialVersion;
@@ -553,16 +554,21 @@ pub fn resolve_root(flag: Option<&str>, gctx: &GlobalContext) -> CargoResult<Fil
                 let definition = p.value().definition.clone();
                 if matches!(definition, Definition::Path(_)) {
                     let suggested = format!("{}/", resolved.display());
-                    gctx.shell().warn(format!(
-                    "the `install.root` value `{}` defined in {} without a trailing slash is deprecated; \
-                         a future version of Cargo will treat it as relative to the configuration \
-                         directory. Add a trailing slash (`{}`) to adopt the \
-                         correct behavior and silence this warning. See more at \
-                         https://doc.rust-lang.org/cargo/reference/config.html#config-relative-paths",
-                    resolved.display(),
-                    definition,
-                    suggested
-                ))?;
+                    let notes = [
+                        Level::NOTE.message("a future version of Cargo will treat it as relative to the configuration directory"),
+                        Level::HELP.message(format!("add a trailing slash (`{}`) to adopt the correct behavior and silence this warning", suggested)),
+                        Level::NOTE.message("see more at https://doc.rust-lang.org/cargo/reference/config.html#config-relative-paths"),
+                    ];
+                    gctx.shell().print_report(
+                        &[Level::WARNING
+                            .secondary_title(format!(
+                                "the `install.root` value `{}` defined in {} without a trailing slash is deprecated",
+                                resolved.display(),
+                                definition
+                            ))
+                            .elements(notes)],
+                        false,
+                    )?;
                 }
             }
             Some(resolved)

tests/testsuite/install.rs

@@ -522,7 +522,11 @@ fn relative_install_location_without_trailing_slash() {
     let mut cmd = cargo_process("install --path .");
     cmd.cwd(p.root());
     cmd.with_stderr_data(str![[r#"
-[WARNING] the `install.root` value `t1` defined in [ROOT]/.cargo/config.toml without a trailing slash is deprecated; a future version of Cargo will treat it as relative to the configuration directory. Add a trailing slash (`t1/`) to adopt the correct behavior and silence this warning. See more at https://doc.rust-lang.org/cargo/reference/config.html#config-relative-paths
+[WARNING] the `install.root` value `t1` defined in [ROOT]/.cargo/config.toml without a trailing slash is deprecated
+  |
+  = [NOTE] a future version of Cargo will treat it as relative to the configuration directory
+  = [HELP] add a trailing slash (`t1/`) to adopt the correct behavior and silence this warning
+  = [NOTE] see more at https://doc.rust-lang.org/cargo/reference/config.html#config-relative-paths
 [INSTALLING] foo v0.0.1 ([ROOT]/foo)
 [COMPILING] foo v0.0.1 ([ROOT]/foo)
 [FINISHED] `release` profile [optimized] target(s) in [ELAPSED]s
@@ -630,7 +634,11 @@ fn relative_install_location_with_path_set() {
     cmd.cwd(p.root());
     cmd.env("PATH", new_path);
     cmd.with_stderr_data(str![[r#"
-[WARNING] the `install.root` value `t1` defined in [ROOT]/.cargo/config.toml without a trailing slash is deprecated; a future version of Cargo will treat it as relative to the configuration directory. Add a trailing slash (`t1/`) to adopt the correct behavior and silence this warning. See more at https://doc.rust-lang.org/cargo/reference/config.html#config-relative-paths
+[WARNING] the `install.root` value `t1` defined in [ROOT]/.cargo/config.toml without a trailing slash is deprecated
+  |
+  = [NOTE] a future version of Cargo will treat it as relative to the configuration directory
+  = [HELP] add a trailing slash (`t1/`) to adopt the correct behavior and silence this warning
+  = [NOTE] see more at https://doc.rust-lang.org/cargo/reference/config.html#config-relative-paths
 [INSTALLING] foo v0.0.1 ([ROOT]/foo)
 [COMPILING] foo v0.0.1 ([ROOT]/foo)
 [FINISHED] `release` profile [optimized] target(s) in [ELAPSED]s