summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authordana <dana@dana.is>2025-04-27 10:36:49 -0500
committerdana <dana@dana.is>2025-04-27 10:36:49 -0500
commit9b68cf38f08fdf352fb1dc6fb97438210aee48b6 (patch)
tree0dbeca9155aa61981f22bec331602cacf496d416
parent0e369f37d637874b45faa43a0896e70f45739abc (diff)
downloadzsh-9b68cf38f08fdf352fb1dc6fb97438210aee48b6.tar.gz
zsh-9b68cf38f08fdf352fb1dc6fb97438210aee48b6.zip
unposted: document zparseopts's lack of support for abbreviating long options
per workers/53520
-rw-r--r--ChangeLog4
-rw-r--r--Doc/Zsh/contrib.yo3
-rw-r--r--Doc/Zsh/mod_zutil.yo3
3 files changed, 9 insertions, 1 deletions
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