From 9b68cf38f08fdf352fb1dc6fb97438210aee48b6 Mon Sep 17 00:00:00 2001
From: dana <dana@dana.is>
Date: Sun, 27 Apr 2025 10:36:49 -0500
Subject: [PATCH] unposted: document zparseopts's lack of support for
 abbreviating long options

per workers/53520
---
 ChangeLog            | 4 ++++
 Doc/Zsh/contrib.yo   | 3 ++-
 Doc/Zsh/mod_zutil.yo | 3 +++
 3 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/ChangeLog b/ChangeLog
index a02917bad..441a5dd5a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2025-04-27  dana  <dana@dana.is>
 
+	* unposted: Doc/Zsh/contrib.yo, Doc/Zsh/mod_zutil.yo:
+	document zparseopts's lack of support for abbreviating long
+	options
+
 	* unposted: Doc/Zsh/contrib.yo: adjust zgetopt wording
 
 	* 53516: Doc/Zsh/contrib.yo, Functions/Misc/zgetopt, NEWS,
diff --git a/Doc/Zsh/contrib.yo b/Doc/Zsh/contrib.yo
index 515b70f51..7822460e8 100644
--- a/Doc/Zsh/contrib.yo
+++ b/Doc/Zsh/contrib.yo
@@ -4748,7 +4748,8 @@ Refer to the manual for util-linux's tt(getopt+LPAR()1+RPAR()) for
 more information about the way arguments are parsed and results are
 returned. Note however that this function is not intended to be a
 complete re-implementation. In particular, it omits all
-portability/compatibility features.
+portability/compatibility features. Also, like tt(zparseopts)
+itself, it does not support abbreviating long options.
 )
 item(tt(zkbd))(
 See `Keyboard Definition'
diff --git a/Doc/Zsh/mod_zutil.yo b/Doc/Zsh/mod_zutil.yo
index 19f9989f4..b296d878c 100644
--- a/Doc/Zsh/mod_zutil.yo
+++ b/Doc/Zsh/mod_zutil.yo
@@ -368,6 +368,9 @@ regardless of whether this option is in effect.
 Lastly, when this option is active, only `tt(-)tt(-)' is treated as an
 explicit option-parsing terminator in the parsed arguments; a single
 `tt(-)' is considered a normal operand.
+
+Note: Unlike most tt(getopt_long+LPAR()3+RPAR()) implementations,
+tt(zparseopts) does not support abbreviating long options.
 )
 item(tt(-K))(
 With this option, the arrays specified with the tt(-a) option and with the