doc

* récupération du dossier doc qui traînait dans gen_confs
 * impression/canon_wrapper
 * typos et élimination de warning

doc/source/gestion/config/index.rst

@@ -1,11 +1,11 @@
-Configuration des scripts
-=========================
+config -- Configuration des scripts
+===================================
 
 Table des matières :
 
 .. toctree::
    :maxdepth: 2
    :glob:
-   
+
    *
    mails/index

doc/source/gestion/config/mails/index.rst

@@ -1,5 +1,5 @@
-Configuration des mails automatiquement envoyés
-===============================================
+mails -- Configuration des mails automatiquement envoyés
+========================================================
 
 Table des matières :
 

doc/source/gestion/gen_confs/firewall4.rst

@@ -0,0 +1,7 @@
+
+gen_confs.firewall4 -- Le pare-feu ipv4
+=======================================
+
+.. automodule:: gestion.gen_confs.firewall4
+   :members:
+   :special-members:

doc/source/gestion/gen_confs/index.rst

@@ -0,0 +1,10 @@
+gen_confs -- Cr@ns Configuration Generator
+==========================================
+
+Table des matières :
+
+.. toctree::
+   :maxdepth: 2
+   :glob:
+   
+   *

doc/source/gestion/index.rst

@@ -1,5 +1,5 @@
-gestion - scripts de gestion du Cr@ns
-=====================================
+gestion -- scripts de gestion du Cr@ns
+======================================
 
 Table des matières :
 
@@ -7,3 +7,4 @@ Table des matières :
    :maxdepth: 2
    
    config/index
+   gen_confs/index

doc/source/impression/canon_wrapper.rst

@@ -1,5 +1,5 @@
-canon_wrapper
-=============
+canon_wrapper -- Soumission de jobs à l'imprimante canon
+========================================================
 
 .. automodule:: impression.canon_wrapper
    :members:

doc/source/impression/index.rst

@@ -1,5 +1,5 @@
-Impression
-===========
+impression -- Scripts relatifs au service d'impression du Cr@ns
+===============================================================
 
 Table des matières :
 

impression/canon_wrapper.py

@@ -5,6 +5,7 @@
 .. codeauthor:: Daniel STAN <dstan@crans.org>
 .. codeauthor:: Antoine Durand-Gasselin <adg@crans.org>
 
+Pour envoyer des jobs d'impression à l'imprimante canon via son interface web.
 
 License: GPLv3
 """
@@ -214,6 +215,5 @@ if __name__ == '__main__':
 
 else:
     parser = build_parser()
-    __doc__ += 'Help message::\n' +\
-        '\n'.join('    ' + l for l in parser.format_help().split('\n')) 
-
+    __doc__ += '''\nHelp message : ::\n\n'''
+    __doc__ += '\n'.join('   ' + l for l in parser.format_help().split('\n')) + "\n"