Improve Arg::value_hint documentation

src/build/arg/mod.rs

@@ -4091,11 +4091,12 @@ impl<'help> Arg<'help> {
         self
     }
 
-    /// Sets a hint about the type of the value for shell completions
+    /// Sets a hint about the type of the value for shell completions. See [`ValueHint`]
+    /// documentation for details.
     ///
-    /// Currently this is only supported by the zsh completions generator.
+    /// **NOTE:** Implicitly sets [`ArgSettings::TakesValue`]
     ///
-    /// For example, to take a username as argument:
+    /// # Examples
     /// ```
     /// # use clap::{Arg, ValueHint};
     /// Arg::new("user")
@@ -4117,6 +4118,8 @@ impl<'help> Arg<'help> {
     ///     )
     /// # ;
     /// ```
+    /// [`ValueHint`]: ./enum.ValueHint.html
+    /// [`ArgSettings::TakesValue`]: ./enum.ArgSettings.html#variant.TakesValue
     pub fn value_hint(mut self, value_hint: ValueHint) -> Self {
         self.set_mut(ArgSettings::TakesValue);
         self.value_hint = value_hint;