about summary refs log tree commit diff
path: root/Doc/Zsh
diff options
context:
space:
mode:
authorPeter Stephenson <pws@users.sourceforge.net>2011-01-11 11:47:32 +0000
committerPeter Stephenson <pws@users.sourceforge.net>2011-01-11 11:47:32 +0000
commit7541f37b63e0c0261b6812450b0a7bb427c7572a (patch)
treecd8c7d82b3ff308ef96aa7585600ba54be7952de /Doc/Zsh
parentdfc26195c916d54163a3f0dd2eb159db2d974569 (diff)
downloadzsh-7541f37b63e0c0261b6812450b0a7bb427c7572a.tar.gz
zsh-7541f37b63e0c0261b6812450b0a7bb427c7572a.tar.xz
zsh-7541f37b63e0c0261b6812450b0a7bb427c7572a.zip
28626: summarize differences between two types of trap
Diffstat (limited to 'Doc/Zsh')
-rw-r--r--Doc/Zsh/func.yo21
1 files changed, 15 insertions, 6 deletions
diff --git a/Doc/Zsh/func.yo b/Doc/Zsh/func.yo
index 5f8df990e..6becc6228 100644
--- a/Doc/Zsh/func.yo
+++ b/Doc/Zsh/func.yo
@@ -348,19 +348,28 @@ enditem()
 
 findex(trap, use of)
 The functions beginning `tt(TRAP)' may alternatively be defined with the
-tt(trap) builtin:  this may be preferable for some uses, as they are then
-run in the environment of the calling process, rather than in their own
-function environment.  Apart from the difference in calling procedure and
-the fact that the function form appears in lists of functions, the forms
+tt(trap) builtin:  this may be preferable for some uses.  The forms
 
 example(TRAPNAL+LPAR()RPAR() { 
  # code
 })
 
-and
+('function traps') and
 
 example(trap '
  # code
 ' NAL)
 
-are equivalent.
+('list traps') are equivalent in most ways, the exceptions being the
+following:
+
+startitemize()
+itemiz(Function traps have all the properties of normal functions,
+appearing in the list of functions and being called with their own
+function context rather than the context where the trap was triggered.)
+itemiz(The return status from function traps is special, whereas a return
+from a list trap causes the surrounding context to return with the given
+status.)
+itemiz(Function traps are not reset within subshells, in accordance with
+zsh behaviour; list traps are reset, in accordance with POSIX behaviour.)
+enditemize()