20024: Improve documentation for TRAPNAL functions

This commit is contained in:
Peter Stephenson 2004-06-08 13:31:53 +00:00
parent ba2415ce67
commit f7323823c3
2 changed files with 23 additions and 0 deletions

View File

@ -1,3 +1,8 @@
2004-06-08 Peter Stephenson <pws@csr.com>
* 20024: Doc/Zsh/func.yo: Improve documentation for TRAPNAL
functions.
2004-06-03 Felix Rosencrantz <f_rosencrantz@yahoo.com>
* 20002: Src/Zle/compmatch.c: Fix a problem with an inconsistent

View File

@ -193,6 +193,24 @@ The signal number will be passed as the first parameter to the function.
If a function of this form is defined and null,
the shell and processes spawned by it will ignore tt(SIG)var(NAL).
The return value from the function is handled specially. If it is
zero, the signal is assumed to have been handled, and execution continues
normally. Otherwise, the normal effect of the signal is produced;
if this causes execution to terminate, the status returned to the shell is
the status returned from the function.
Programs terminated by uncaught signals typically return the status 128
plus the signal number. Hence the following causes the handler for
tt(SIGINT) to print a message, then mimic the usual effect of the signal.
example(TRAPINT() {
print "Caught SIGINT, aborting."
return $(( 128 + $1 ))
})
The functions tt(TRAPZERR), tt(TRAPDEBUG) and tt(TRAPEXIT) are never
executed inside other traps.
)
findex(TRAPDEBUG)
item(tt(TRAPDEBUG))(