Re: [PATCH] docs: clarify $line contents

On Fri 10 Jul 2026, at 23:18, Oliver Kiddle wrote:
> Having "including" follow "excluding" in a sentence is unclear

true. maybe this

dana


diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo
index d351fb885..412b130d6 100644
--- a/Doc/Zsh/compsys.yo
+++ b/Doc/Zsh/compsys.yo
@@ -4025,7 +4025,11 @@ enditem()
 During the performance of the action the array `tt(line)' will be set to
 the normal arguments from the command line, i.e. the words from the
 command line after the command name excluding all options and their
-arguments.  Options are stored in the associative array
+arguments.  Also excluded are any words appearing after the current
+word, the parsing terminator `tt(-)tt(-)' or `tt(-)' if tt(_arguments)
+was called with tt(-S), and any words ignored by the tt(-A) pattern.
+
+Options are stored in the associative array
 `tt(opt_args)' with option names as keys and their arguments as
 the values.  By default, all colons and backslashes in the value are escaped
 with backslashes, and if an option has multiple arguments (for example, when