only show the one-line description in the command list; add a description of "help"

1 files changed, 5 insertions, 1 deletions

diff --git a/cliff/help.py b/cliff/help.py
index f53e61b..905f968 100644
--- a/cliff/help.py
+++ b/cliff/help.py
@@ -19,11 +19,15 @@ class HelpAction(argparse.Action):
         for name, ep in sorted(command_manager):
             factory = ep.load()
             cmd = factory(self, None)
-            print('  %-13s  %s' % (name, cmd.get_description()))
+            one_liner = cmd.get_description().split('\n')[0]
+            print('  %-13s  %s' % (name, one_liner))
         sys.exit(0)
 
 
 class HelpCommand(Command):
+    """print detailed help for another command
+    """
+
     def get_parser(self, prog_name):
         parser = super(HelpCommand, self).get_parser(prog_name)
         parser.add_argument('cmd',