[PATCH] docs: clarify $line contents

some clarification about what _arguments puts in $line

dana


diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo
index 4ced8e4a6..7d8a70614 100644
--- a/Doc/Zsh/compsys.yo
+++ b/Doc/Zsh/compsys.yo
@@ -4025,7 +4025,12 @@ 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, up to and potentially including the current word.  Also
+excluded are the parsing terminator `tt(-)tt(-)' or `tt(-)' if
+tt(_arguments) has been called with tt(-S), as well as any arguments
+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