From 6541df2c4b9f21818c11bc3920695b216c20a0fd Mon Sep 17 00:00:00 2001
From: Ed Page <eopage@gmail.com>
Date: Fri, 7 Jul 2023 09:07:55 -0500
Subject: [PATCH] docs: Note user-values subject to value_delimiter

Inspired by #4999
---
 clap_builder/src/builder/arg.rs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/clap_builder/src/builder/arg.rs b/clap_builder/src/builder/arg.rs
index 5bfea9ad469..d067dec1dcd 100644
--- a/clap_builder/src/builder/arg.rs
+++ b/clap_builder/src/builder/arg.rs
@@ -1650,6 +1650,8 @@ impl Arg {
     /// at runtime, nor were the conditions met for `Arg::default_value_if`, the `Arg::default_value`
     /// will be applied.
     ///
+    /// Like with command-line values, this will be split by [`Arg::value_delimiter`].
+    ///
     /// # Examples
     ///
     /// First we use the default value without providing any value at runtime.
@@ -1747,6 +1749,8 @@ impl Arg {
     /// [`.require_equals(true)`][Arg::require_equals] configuration option. These are required in
     /// order to unambiguously determine what, if any, value was supplied for the argument.
     ///
+    /// Like with command-line values, this will be split by [`Arg::value_delimiter`].
+    ///
     /// # Examples
     ///
     /// For POSIX style `--color`:
@@ -1893,6 +1897,8 @@ impl Arg {
     ///   [`ArgMatches::get_one`][crate::ArgMatches::get_one] will
     ///   return the default specified.
     ///
+    /// Like with command-line values, this will be split by [`Arg::value_delimiter`].
+    ///
     /// # Examples
     ///
     /// In this example, we show the variable coming from the environment:
@@ -2734,6 +2740,8 @@ impl Arg {
     /// and `Arg::default_value_if`, and the user **did not** provide this arg at runtime, nor were
     /// the conditions met for `Arg::default_value_if`, the `Arg::default_value` will be applied.
     ///
+    /// Like with command-line values, this will be split by [`Arg::value_delimiter`].
+    ///
     /// # Examples
     ///
     /// First we use the default value only if another arg is present at runtime.
@@ -2873,6 +2881,8 @@ impl Arg {
     /// **NOTE**: The conditions are stored in order and evaluated in the same order. I.e. the first
     /// if multiple conditions are true, the first one found will be applied and the ultimate value.
     ///
+    /// Like with command-line values, this will be split by [`Arg::value_delimiter`].
+    ///
     /// # Examples
     ///
     /// First we use the default value only if another arg is present at runtime.