Display full command documentation in online help

ipa <command> -h only showed the summary string, not the full help.
Use the full docstring. Add a custom help formatter that disables
optparse's reformatting.

Test included

https://fedorahosted.org/freeipa/ticket/3543

1 files changed, 11 insertions, 0 deletions

diff --git a/tests/test_cmdline/test_help.py b/tests/test_cmdline/test_help.py
index 1ab3ddc4..4cf63368 100644
--- a/tests/test_cmdline/test_help.py
+++ b/tests/test_cmdline/test_help.py
@@ -128,3 +128,14 @@ def test_ambiguous_command_or_topic():
     assert h_ctx.stderr == ''
 
     assert h_ctx.stdout != help_ctx.stdout
+
+def test_multiline_description():
+    """Test that all of a multi-line command description appears in output
+    """
+    # This assumes trust_add has multiline doc. Ensure it is so.
+    assert '\n\n' in unicode(api.Command.trust_add.doc).strip()
+
+    with CLITestContext(exception=SystemExit) as help_ctx:
+        return_value = api.Backend.cli.run(['trust-add', '-h'])
+
+    assert unicode(api.Command.trust_add.doc).strip() in help_ctx.stdout