improve display of help's description for p* scripts

CHANGES.txt

@@ -255,3 +255,6 @@ Documentation Changes
 
   See https://github.com/Pylons/pyramid/pull/2881 and
   https://github.com/Pylons/pyramid/pull/2883.
+
+- Improve output of p* script descriptions for help.
+  See https://github.com/Pylons/pyramid/pull/2886

pyramid/scripts/pcreate.py

@@ -23,13 +23,16 @@ def main(argv=sys.argv, quiet=False):
 
 class PCreateCommand(object):
     verbosity = 1  # required
-    parser = argparse.ArgumentParser(description="""\
+    parser = argparse.ArgumentParser(
+        description="""\
 Render Pyramid scaffolding to an output directory.
 
 Note: As of Pyramid 1.8, this command is deprecated. Use a specific
 cookiecutter instead:
 https://github.com/Pylons/?q=cookiecutter
-""")
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
     parser.add_argument('-s', '--scaffold',
                         dest='scaffold_name',
                         action='append',

pyramid/scripts/prequest.py

@@ -47,7 +47,8 @@ class PRequestCommand(object):
     """
 
     parser = argparse.ArgumentParser(
-        description=textwrap.dedent(description)
+        description=textwrap.dedent(description),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
         )
     parser.add_argument(
         '-n', '--app-name',

pyramid/scripts/proutes.py

@@ -249,7 +249,8 @@ class PRoutesCommand(object):
     stdout = sys.stdout
     ConfigParser = configparser.ConfigParser  # testing
     parser = argparse.ArgumentParser(
-        description=textwrap.dedent(description)
+        description=textwrap.dedent(description),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
         )
     parser.add_argument('-g', '--glob',
                         action='store',

pyramid/scripts/pserve.py

@@ -51,7 +51,8 @@ class PServeCommand(object):
     default_verbosity = 1
 
     parser = argparse.ArgumentParser(
-        description=textwrap.dedent(description)
+        description=textwrap.dedent(description),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
         )
     parser.add_argument(
         '-n', '--app-name',

pyramid/scripts/pshell.py

@@ -45,7 +45,8 @@ class PShellCommand(object):
     pkg_resources = pkg_resources  # for testing
 
     parser = argparse.ArgumentParser(
-        description=textwrap.dedent(description)
+        description=textwrap.dedent(description),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
         )
     parser.add_argument('-p', '--python-shell',
                         action='store',

pyramid/scripts/ptweens.py

@@ -29,6 +29,7 @@ class PTweensCommand(object):
     """
     parser = argparse.ArgumentParser(
         description=textwrap.dedent(description),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
         )
 
     parser.add_argument('config_uri',

pyramid/scripts/pviews.py

@@ -28,7 +28,8 @@ class PViewsCommand(object):
     stdout = sys.stdout
 
     parser = argparse.ArgumentParser(
-        description=textwrap.dedent(description)
+        description=textwrap.dedent(description),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
         )
 
     parser.add_argument('config_uri',