Merge pull request #5811 from epage/notes

docs: Highlight notes/warnings in a block

Author: epage

clap_builder/src/builder/action.rs

@@ -32,10 +32,14 @@ use crate::util::AnyValueId;
 pub enum ArgAction {
     /// When encountered, store the associated value(s) in [`ArgMatches`][crate::ArgMatches]
     ///
+    /// <div class="warning">
+    ///
     /// **NOTE:** If the argument has previously been seen, it will result in a
     /// [`ArgumentConflict`][crate::error::ErrorKind::ArgumentConflict] unless
     /// [`Command::args_override_self(true)`][crate::Command::args_override_self] is set.
     ///
+    /// </div>
+    ///
     /// # Examples
     ///
     /// ```rust
@@ -87,10 +91,14 @@ pub enum ArgAction {
     /// No value is allowed. To optionally accept a value, see
     /// [`Arg::default_missing_value`][super::Arg::default_missing_value]
     ///
+    /// <div class="warning">
+    ///
     /// **NOTE:** If the argument has previously been seen, it will result in a
     /// [`ArgumentConflict`][crate::error::ErrorKind::ArgumentConflict] unless
     /// [`Command::args_override_self(true)`][crate::Command::args_override_self] is set.
     ///
+    /// </div>
+    ///
     /// # Examples
     ///
     /// ```rust
@@ -162,10 +170,14 @@ pub enum ArgAction {
     /// No value is allowed. To optionally accept a value, see
     /// [`Arg::default_missing_value`][super::Arg::default_missing_value]
     ///
+    /// <div class="warning">
+    ///
     /// **NOTE:** If the argument has previously been seen, it will result in a
     /// [`ArgumentConflict`][crate::error::ErrorKind::ArgumentConflict] unless
     /// [`Command::args_override_self(true)`][crate::Command::args_override_self] is set.
     ///
+    /// </div>
+    ///
     /// # Examples
     ///
     /// ```rust

clap_builder/src/builder/app_settings.rs

@@ -35,9 +35,13 @@ impl std::ops::BitOr for AppFlags {
 
 /// Application level settings, which affect how [`Command`] operates
 ///
+/// <div class="warning">
+///
 /// **NOTE:** When these settings are used, they apply only to current command, and are *not*
 /// propagated down or up through child or parent subcommands
 ///
+/// </div>
+///
 /// [`Command`]: crate::Command
 #[derive(Debug, PartialEq, Copy, Clone)]
 #[repr(u8)]