X-Git-Url: https://git.distorted.org.uk/~mdw/mLib-python/blobdiff_plain/5b1830f325c55c70d65fd020f08dd958493e528d..refs/heads/master:/sig.pyx

diff --git a/sig.pyx b/sig.pyx
index 17d52fe..aafa050 100644
--- a/sig.pyx
+++ b/sig.pyx
@@ -26,6 +26,11 @@
 import signal
 
 cdef class SelSignal:
+  """
+  SelSignal(SIG, [signalledproc = None])
+
+  Collect signals from the event loop.
+  """
   cdef sig s
   cdef int _activep
   cdef readonly int signal
@@ -40,9 +45,11 @@ cdef class SelSignal:
     if me._activep:
       sig_remove(&me.s)
   property activep:
+    """SS.activep -> BOOL: is the handler still active?"""
     def __get__(me):
       return _tobool(me._activep)
   property signalledproc:
+    """SS.signalledproc -> FUNC: call FUNC() when the signal is received"""
     def __get__(me):
       return me._signalled
     def __set__(me, proc):
@@ -50,12 +57,14 @@ cdef class SelSignal:
     def __del__(me):
       me._signalled = None
   def enable(me):
+    """SS.enable(): enable the handler"""
     if me._activep:
       raise ValueError, 'already enabled'
     sig_add(&me.s, me.signal, _sigfunc, <void *>me)
     me._enabled()
     return me
   def disable(me):
+    """SS.disable(): disable the handler"""
     if not me._activep:
       raise ValueError, 'already disabled'
     sig_remove(&me.s)
@@ -68,10 +77,13 @@ cdef class SelSignal:
     me._activep = 0
     me.disabled()
   def enabled(me):
+    """SS.enabled(): called when handler is enabled"""
     pass
   def disabled(me):
+    """SS.disabled(): called when handler is disabled"""
     pass
   def signalled(me):
+    """SS.signalled(): called when the signal is received"""
     return _maybecall(me._signalled, ())
 
 cdef void _sigfunc(int sig, void *arg):