debian/control: Add Build-Depends for `dh-python'.
[mLib-python] / fwatch.pyx
index 2e484cd..eedb872 100644 (file)
 ### Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 
 cdef class FWatch:
+  """
+  FWatch(FILE): watch FILE for changes
+
+  FILE may be a string, file descriptor, or an object with a `fileno' method.
+  """
   cdef fwatch fw
   cdef public file
   def __cinit__(me, file):
@@ -37,6 +42,7 @@ cdef class FWatch:
       fwatch_initfd(&me.fw, _getfd(file))
     me.file = file
   def update(me):
+    """FW.update() -> RC: nonzero if the file has changed state"""
     cdef int rc
     if isinstance(me.file, str):
       rc = fwatch_update(&me.fw, me.file)