plugins: add comments.

1 files changed, 7 insertions, 1 deletions

diff --git a/nephilim/plugins/__init__.py b/nephilim/plugins/__init__.py
index 0607cbc..0b68b7e 100644
--- a/nephilim/plugins/__init__.py
+++ b/nephilim/plugins/__init__.py
@@ -51,10 +51,12 @@ class Plugins:
         return True
 
     def plugin(self, name):
+        """Returns a plugin with the specified name. It is illegal to access
+           any functions if the plugin is unloaded."""
         return self._plugins[name] if name in self._plugins else None
 
-
     def load(self, name):
+        """Loads an unloaded plugin."""
         if not name in self._plugins:
             if not self.__init_plugin(name):
                 return False
@@ -63,14 +65,18 @@ class Plugins:
         return True
 
     def unload(self, name):
+        """Unloads a loaded plugin."""
         if name in self._plugins:
             if self._plugins[name].loaded:
                 self._plugins[name].unload()
 
     def plugins(self):
+        """Returns all available plugins. It is illegal to access any functions
+           if the plugin is unloaded."""
         return self._plugins.values()
 
     def loaded_plugins(self):
+        """Returns all loaded plugins."""
         list = []
         for plugin in self._plugins.values():
             if plugin.loaded: