[SCM] Signal extension for Tcl branch, debian, updated. bc104aa81ec027f217263452461b00707ffb55cc

[Ole Streicher]

The following commit has been merged in the debian branch:
commit bb777ec8164990c5fd194f8a7319a815aad1f933
Author: Ole Streicher <debian at liska.ath.cx>
Date:   Sat Jan 21 16:43:24 2012 +0100

    Add manpages dervived from sig.announce-1.4

diff --git a/debian/rules b/debian/rules
index 91eee74..8e1a321 100755
--- a/debian/rules
+++ b/debian/rules
@@ -9,3 +9,6 @@
 override_dh_makeshlibs:
 	dh_makeshlibs
 	tcltk-depends
+
+override_dh_installman:
+	dh_installman debian/signal.3tk
diff --git a/debian/signal.3tk b/debian/signal.3tk
new file mode 100644
index 0000000..facc66d
--- /dev/null
+++ b/debian/signal.3tk
@@ -0,0 +1,52 @@
+.\" Hey Emacs! This file is -*- nroff -*- source.
+.\"
+.\" Created for Debian using the original file "sig.announce.1.4"
+.TH signal "3tcl" "1.4.0.1 Tcl" "Tcl Signal Extension"
+.SH NAME
+signal \- dynamically loadable signal handling for Tcl/Tk
+.SH SYNOPSIS
+\fBsignal\fI (add|delete|print|version) [options]
+.SH "COMMANDS"
+.SS 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 
+.B \-async 
+is used, the signal handler is created using 
+.BR 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 
+.B \-async 
+is especially useful to interrupt "runaway" procs, or to cause a
+quick exit; the default mechanism simply waits for another MainLoop cycle.
+.SS signal delete signo
+Restores handling of signal signo to the default (
+.B SIG_DFL
+).
+.SS signal print 
+Prints the handling of all signals with handlers. Formatted as  
+ signal ----> procedure or as
+ signal !---> procedure 
+
+if the signal is handled asynchronously
+.SS signal print signo
+Prints the procedure for handling signal signo.
+Prints the word 
+.B UNHANDLED 
+if no signal handler is active for that signal.
+.SS signal version
+Returns the string representing the current version of the package
+.SH AUTHOR
+Michael Schwartz <mschwart at nyx.net>. Tilman Kranz <tilde at tk-sls.de> patched
+this for wider portability on Linux

-- 
Signal extension for Tcl