about summary refs log tree commit diff
path: root/Doc/Zsh/builtins.yo
diff options
context:
space:
mode:
authorPeter Stephenson <p.w.stephenson@ntlworld.com>2014-10-01 20:36:55 +0100
committerPeter Stephenson <p.w.stephenson@ntlworld.com>2014-10-01 20:36:55 +0100
commit5e516898d73dd797248082daefeb4147ae20fec4 (patch)
tree7e134731363266b3817bf65e063e3f4f6be6359f /Doc/Zsh/builtins.yo
parent8727049674b1f39a8926c02dc74e9f19bbd70289 (diff)
downloadzsh-5e516898d73dd797248082daefeb4147ae20fec4.tar.gz
zsh-5e516898d73dd797248082daefeb4147ae20fec4.tar.xz
zsh-5e516898d73dd797248082daefeb4147ae20fec4.zip
33312: document redirections applied to function definitions
Diffstat (limited to 'Doc/Zsh/builtins.yo')
-rw-r--r--Doc/Zsh/builtins.yo14
1 files changed, 14 insertions, 0 deletions
diff --git a/Doc/Zsh/builtins.yo b/Doc/Zsh/builtins.yo
index 9862c637e..41c189fe2 100644
--- a/Doc/Zsh/builtins.yo
+++ b/Doc/Zsh/builtins.yo
@@ -2174,6 +2174,20 @@ match one of these patterns will be written. If no var(name) is given,
 the definitions of all functions currently defined or marked as
 autoloaded will be written.
 
+Note the second form cannot be used for compiling functions that
+include redirections as part of the definition rather than within
+the body of the function; for example
+
+example(fn1() { { ... } >~/logfile })
+
+can be compiled but
+
+example(fn1() { ... } >~/logfile)
+
+cannot.  It is possible to use the first form of tt(zcompile) to compile
+autoloadable functions that include the full function definition instead
+of just the body of the function.
+
 The third form, with the tt(-t) option, examines an existing
 compiled file.  Without further arguments, the names of the original
 files compiled into it are listed.  The first line of output shows