From 009ab088214f4ecac863123ac4ab94e9f6f486fa Mon Sep 17 00:00:00 2001
From: nemunaire <nemunaire@nemunai.re>
Date: Thu, 3 Dec 2015 00:29:16 +0100
Subject: [PATCH] [man] Dusting + fill help

---
 modules/man.py | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/modules/man.py b/modules/man.py
index 997b85b..f45e30d 100644
--- a/modules/man.py
+++ b/modules/man.py
@@ -1,6 +1,6 @@
-# coding=utf-8
+"""Read manual pages on IRC"""
 
-"Read manual pages on IRC"
+# PYTHON STUFFS #######################################################
 
 import subprocess
 import re
@@ -8,18 +8,22 @@ import os
 
 from nemubot.hooks import hook
 
-nemubotversion = 3.4
-
 from more import Response
 
 
-def help_full():
-    return "!man [0-9] /what/: gives informations about /what/."
+# GLOBALS #############################################################
 
 RGXP_s = re.compile(b'\x1b\\[[0-9]+m')
 
 
-@hook.command("MAN")
+# MODULE INTERFACE ####################################################
+
+@hook.command("MAN",
+              help="Show man pages",
+              help_usage={
+                  "SUBJECT": "Display the default man page for SUBJECT",
+                  "SECTION SUBJECT": "Display the man page in SECTION for SUBJECT"
+              })
 def cmd_man(msg):
     args = ["man"]
     num = None
@@ -52,7 +56,11 @@ def cmd_man(msg):
     return res
 
 
-@hook.command("man")
+@hook.command("man",
+              help="Show man pages synopsis (in one line)",
+              help_usage={
+                  "SUBJECT": "Display man page synopsis for SUBJECT",
+              })
 def cmd_whatis(msg):
     args = ["whatis", " ".join(msg.args)]