From: Oz <nahumoz@gmail.com>
Date: Sun, 16 Dec 2012 22:27:09 +0000 (+0100)
Subject: python: add docstring to insert and remove methods
X-Git-Tag: v17~10^2~8
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f0d6f3701ab912673bd313f934ae9dcb32328f03;p=thirdparty%2Fkmod.git

python: add docstring to insert and remove methods
---

diff --git a/libkmod/python/kmod/module.pyx b/libkmod/python/kmod/module.pyx
index eadfbbf9..42aa92ef 100644
--- a/libkmod/python/kmod/module.pyx
+++ b/libkmod/python/kmod/module.pyx
@@ -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')