From 027c47b9b4f88f83ec06a968e3c9264e6f878f74 Mon Sep 17 00:00:00 2001
From: Adrian Holovaty <adrian@holovaty.com>
Date: Fri, 2 Dec 2005 20:58:35 +0000
Subject: [PATCH] Fixed #983 -- Made 'django-admin.py --help' output easier to
 read. Thanks, Oliver

git-svn-id: http://code.djangoproject.com/svn/django/trunk@1526 bcc190cf-cafb-0310-a4f2-bffc1f526a37
---
 AUTHORS                    | 1 +
 django/bin/django-admin.py | 8 +++++---
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/AUTHORS b/AUTHORS
index f2578b6e06..52c710e1c3 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -76,6 +76,7 @@ answer newbie questions, and generally made Django that much better:
     Luke Plant <http://lukeplant.me.uk/>
     phaedo <http://phaedo.cx/>
     plisk
+    Oliver Rutherfurd <http://rutherfurd.net/>
     David Schein
     sopel
     Radek Švarz <http://www.svarz.cz/translate/>
diff --git a/django/bin/django-admin.py b/django/bin/django-admin.py
index a30b038547..63c6307257 100755
--- a/django/bin/django-admin.py
+++ b/django/bin/django-admin.py
@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 from django.core import management
 from optparse import OptionParser
-import os, sys
+import os, sys, textwrap
 
 ACTION_MAPPING = {
     'adminindex': management.get_admin_index,
@@ -37,8 +37,10 @@ def get_usage():
     available_actions.sort()
     for a in available_actions:
         func = ACTION_MAPPING[a]
-        usage.append("  %s %s -- %s" % (a, func.args, getattr(func, 'help_doc', func.__doc__)))
-    return '\n'.join(usage)
+        usage.append("  %s %s" % (a, func.args))
+        usage.extend(textwrap.wrap(getattr(func, 'help_doc', func.__doc__), initial_indent='    ', subsequent_indent='    '))
+        usage.append("")
+    return '\n'.join(usage[:-1]) # Cut off last list element, an empty space.
 
 class DjangoOptionParser(OptionParser):
     def print_usage_and_exit(self):