Merge commit 'e88f4e0c4854ef54efbe2eb2f57568ebc89e3766' as 'tclsignal'

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