cli: describe how to set a config value with apostrophes

Apostrophes are not uncommon in e.g. `user.name`, so let's help the
user by providing examples.

Author: martinvonz

cli/src/commands/config/set.rs

@@ -38,8 +38,15 @@ pub struct ConfigSetArgs {
     /// New value to set
     ///
     /// The value should be specified as a TOML expression. If string value
-    /// doesn't contain any TOML constructs (such as array notation), quotes can
-    /// be omitted.
+    /// doesn't contain any TOML constructs (such as apostrophes or array
+    /// notation), quotes can be omitted. Note that the value may also need
+    /// shell quoting. TOML multi-line strings can be useful if the value
+    /// contains apostrophes. For example, to set `foo.bar` to the string
+    /// "don't" use `jj config set --user foo.bar "'''don't'''"`. This
+    /// is valid in both Bash and Fish.
+    ///
+    /// Alternative, e.g. to avoid dealing with shell quoting, use `jj config
+    /// edit` to edit the TOML file directly.
     #[arg(required = true, value_parser = parse_value_or_bare_string)]
     value: ConfigValue,
     #[command(flatten)]

cli/tests/[email protected]

@@ -642,7 +642,9 @@ Update config file to set the given option to a given value
 * `<NAME>`
 * `<VALUE>` — New value to set
 
-   The value should be specified as a TOML expression. If string value doesn't contain any TOML constructs (such as array notation), quotes can be omitted.
+   The value should be specified as a TOML expression. If string value doesn't contain any TOML constructs (such as apostrophes or array notation), quotes can be omitted. Note that the value may also need shell quoting. TOML multi-line strings can be useful if the value contains apostrophes. For example, to set `foo.bar` to the string "don't" use `jj config set --user foo.bar "'''don't'''"`. This is valid in both Bash and Fish.
+
+   Alternative, e.g. to avoid dealing with shell quoting, use `jj config edit` to edit the TOML file directly.
 
 ###### **Options:**