From 9b68cf38f08fdf352fb1dc6fb97438210aee48b6 Mon Sep 17 00:00:00 2001 From: dana Date: Sun, 27 Apr 2025 10:36:49 -0500 Subject: 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 + * 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 -- cgit v1.2.3