From 89bda827f9016753a7b6495ca18dae3b6822e75e Mon Sep 17 00:00:00 2001
From: Marti Raudsepp <marti@juffo.org>
Date: Mon, 20 Jul 2020 16:13:25 +0300
Subject: [PATCH] Document that fish only supports named args

---
 src/build/arg/value_hint.rs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/build/arg/value_hint.rs b/src/build/arg/value_hint.rs
index ccc989322a13..087712bdd598 100644
--- a/src/build/arg/value_hint.rs
+++ b/src/build/arg/value_hint.rs
@@ -6,7 +6,7 @@ use std::str::FromStr;
 ///
 /// Overview of which hints are supported by which shell:
 ///
-/// | Hint                   | zsh | fish    |
+/// | Hint                   | zsh | fish[^1]|
 /// | ---------------------- | --- | ------- |
 /// | `AnyPath`              | Yes | Yes     |
 /// | `FilePath`             | Yes | Yes     |
@@ -19,6 +19,9 @@ use std::str::FromStr;
 /// | `Hostname`             | Yes | Yes     |
 /// | `Url`                  | Yes |         |
 /// | `EmailAddress`         | Yes |         |
+///
+/// [^1]: fish completions currently only support named arguments (e.g. -o or --opt), not
+///       positional arguments.
 #[derive(Debug, PartialEq, Copy, Clone)]
 pub enum ValueHint {
     /// Default value if hint is not specified. Follows shell default behavior, which is usually