Renamed acl plugin into dummy_acl + documentation update

README.md

@@ -27,6 +27,18 @@ If you want to write a script that run is the instance env you have to use
 
 -----
 
+Lodel2 plugins system:
+
+In an instance or in the lib dir you can ask Lodel2 wich plugins and wich hooks are activated.
+Print a list of plugins :
+	python3 manage_lodel.py --list-plugins
+Print a list of registered hooks :
+	python3 manage_lodel.py --list-hooks
+More informations about the script :
+	python3 manage_lodel.py --help
+
+-----
+
 ** Doxygen generation
   Dependencies : doxygen graphviz doxypy
   Generation : run make doc in the root folder

plugins/__init__.py

@@ -1,2 +1,20 @@
+## @package plugins Lodel2 plugin system
+#
+# The plugins activation system is based on <code>__init__.py</code> file.
+# The <code>__all__</code> variable in @ref plugins/__init__.py is generated
+# from configuration by Lodel.plugins._all_plugins() method. Then the plugins should
+# auto-import all its source files using it's own package <code>__init__.py</code> file
+#
+# For the moment plugins capabilities are :
+# - Hooks registration using Lodel.LodelHook decoration class
+# - User authentification methods registration using Lodel.user.authentication_method decorator
+# - User identification methods using Lodel.user.identification_method decorator
+#
+# You can find examples plugins in :
+# - plugins.dummy (Hooks registration)
+# - plugins.dummy_auth (Auth and identification methods registration)
+# - plugins.dummy_acl (Complex plugin with settings enhancement example)
+#
 import Lodel.plugins
+## @brief Contain all activated plugins name
 __all__ = Lodel.plugins._all_plugins()