diff options
author | William Joye <wjoye@cfa.harvard.edu> | 2019-01-03 16:52:10 (GMT) |
---|---|---|
committer | William Joye <wjoye@cfa.harvard.edu> | 2019-01-03 16:52:10 (GMT) |
commit | 2fdbadf22c26555d560602932f3063cb5e1d034a (patch) | |
tree | f2f5e3de86f5a13bb995e07a28ad7bdf5b320079 /tclsignal/doc | |
parent | fa6e0263b87ec0165be0a3a774e0bbdccc069f57 (diff) | |
parent | 39b56148245456816b3bd4b9341f4bb498644093 (diff) | |
download | blt-2fdbadf22c26555d560602932f3063cb5e1d034a.zip blt-2fdbadf22c26555d560602932f3063cb5e1d034a.tar.gz blt-2fdbadf22c26555d560602932f3063cb5e1d034a.tar.bz2 |
Merge commit '39b56148245456816b3bd4b9341f4bb498644093' as 'tclsignal'
Diffstat (limited to 'tclsignal/doc')
-rw-r--r-- | tclsignal/doc/README | 17 | ||||
-rw-r--r-- | tclsignal/doc/sig.announce.1.4 | 60 |
2 files changed, 77 insertions, 0 deletions
diff --git a/tclsignal/doc/README b/tclsignal/doc/README new file mode 100644 index 0000000..2bfcf60 --- /dev/null +++ b/tclsignal/doc/README @@ -0,0 +1,17 @@ +README + +This is the "signal" extension +Author: Michael Schwartz +email: mschwart@nyx.net-Nyx, the longest running Free Internet provider + +Patched for Linux portability +Author: Tilman Kranz +email: tilde@tk-sls.de +License: "signal_ext1.4" license conditions_ + +About the Patch: + + This is a simple modification of the existing + "GNU autoconf" configuration to do some minimal testing + for Tcl. There exist systems where this does work. + diff --git a/tclsignal/doc/sig.announce.1.4 b/tclsignal/doc/sig.announce.1.4 new file mode 100644 index 0000000..87ee5ec --- /dev/null +++ b/tclsignal/doc/sig.announce.1.4 @@ -0,0 +1,60 @@ +Signal Extension (package Signal) Version 1.4.0.1 available + +See all my Tcl extensions at http://www.du.edu/~mschwart/tcl-tk.html +http://www.nyx.net/~mschwart/signal_ext.html + +This extension adds dynamically loadable signal handling to Tcl/Tk scripts. +It provides a very limited subset of the functionality of tclX (just the +signal part, and about 3/4 of the functions for signals), but as a result +is quite small and quick to load. + +Version 1.4 removes dependencies on Tk. +Tilman Kranz (tilde@tk-sls.de) patched this for wider portability on Linux + +A summary of the extension usage follows: + +Usages: + +signal add signo proc [-async] + + Adds a signal handler for signal signo through proc proc. + + Signals can be provided by number, or the most common ones are provided by + name (e.g., SIGHUP). + + The proc is any Tcl procedure, and it is evaluated when the signal comes in. + It will be provided no arguments. + + Signal handlers have Posix semantics--they persist until reset. + + If -async is used, the signal handler is created using Tcl_AsyncCreate(). + Checks for the signal are very frequent (each evaluation) using this + technique, but one doesn't know quite where evaluation is or how to handle + errors in this situation. The code will evaluate the provided procedure in + the current interpreter if available, and in the interpreter which added the + signal handler otherwise. At least until a better scheme is suggested. + + The -async is especially useful to interrupt "runaway" procs, or to cause a + quick exit; the default mechanism simply waits for another MainLoop cycle. + +signal delete signo + + Restores handling of signal signo to the default (SIG_DFL). + +signal print + + Prints the handling of all signals with handlers. + + Formatted as signal ----> procedure + or as signal !---> procedure + if the signal is handled asynchronously + +signal print signo + + Prints the procedure for handling signal signo. + + Prints the word UNHANDLED if no signal handler is active for that signal. + +signal version + + Returns the string representing the current version of the package |