52549: document return works in a script

ChangeLog

@@ -1,4 +1,9 @@
-2024-02-19  Jun-ichi Takimoto  <takimoto-j@kba.biglobe.ne.jp>
+2024-02-19  Peter Stephenson  <p.w.stephenson@ntlworld.com>
+
+	* 52549: Doc/Zsh/builtins.yo: document that return already works
+	in a script.
+
+x2024-02-19  Jun-ichi Takimoto  <takimoto-j@kba.biglobe.ne.jp>
 
 	* 52544: Completion/Unix/Type/_diff_options: support macOS Ventura
 	or newer

Doc/Zsh/builtins.yo

@@ -1649,7 +1649,9 @@ cindex(functions, returning from)
 item(tt(return) [ var(n) ])(
 Causes a shell function or `tt(.)' script to return to
 the invoking script with the return status specified by
-an arithmetic expression var(n).  
+an arithmetic expression var(n).  Also causes a non-interctive
+shell to exit, allowing files containing shell code to be used
+both as scripts and as autoloadable shell functions.
 For example, the following prints `tt(42)':
 
 example(() { integer foo=40; return "foo + 2" }