python: add docstring to insert and remove methods
authorOz <nahumoz@gmail.com>
Sun, 16 Dec 2012 22:27:09 +0000 (23:27 +0100)
committerLucas De Marchi <lucas.demarchi@intel.com>
Tue, 25 Mar 2014 03:34:16 +0000 (00:34 -0300)
libkmod/python/kmod/module.pyx

index eadfbbf..42aa92e 100644 (file)
@@ -117,6 +117,13 @@ cdef class Module (object):
 
     def insert(self, flags=0, extra_options=None, install_callback=None,
                data=None, print_action_callback=None):
+        """
+        insert module to current tree. 
+        e.g.
+        km = kmod.Kmod()
+        tp = km.module_from_name("thinkpad_acpi")
+        tp.insert(extra_options='fan_control=1')
+        """
         cdef char *opt = NULL
         #cdef _libkmod_h.install_callback_t install = NULL
         cdef int (*install)(
@@ -139,6 +146,13 @@ cdef class Module (object):
             raise _KmodError('Could not load module')
 
     def remove(self, flags=0):
+        """
+        remove module from current tree
+        e.g.
+        km = kmod.Kmod()
+        tp = km.module_from_name("thinkpad_acpi")
+        tp.remove()
+        """
         err = _libkmod_h.kmod_module_remove_module(self.module, flags)
         if err < 0:
             raise _KmodError('Could not remove module')