Patch #1104111: Alter setup.py --help and --help-commands.
diff --git a/Lib/distutils/command/clean.py b/Lib/distutils/command/clean.py
index 1844ffe..02189c5 100644
--- a/Lib/distutils/command/clean.py
+++ b/Lib/distutils/command/clean.py
@@ -15,7 +15,7 @@
class clean (Command):
- description = "clean up output of 'build' command"
+ description = "clean up temporary files from 'build' command"
user_options = [
('build-base=', 'b',
"base build directory (default: 'build.build-base')"),
diff --git a/Lib/distutils/dist.py b/Lib/distutils/dist.py
index 9eb2aa4..4f4bae5 100644
--- a/Lib/distutils/dist.py
+++ b/Lib/distutils/dist.py
@@ -59,6 +59,15 @@
('help', 'h', "show detailed help message"),
]
+ # 'common_usage' is a short (2-3 line) string describing the common
+ # usage of the setup script.
+ common_usage = """\
+Common commands: (see '--help-commands' for more)
+
+ setup.py build will build the package underneath 'build/'
+ setup.py install will install the package
+"""
+
# options that are not propagated to the commands
display_options = [
('help-commands', None,
@@ -608,7 +617,7 @@
else:
options = self.global_options
parser.set_option_table(options)
- parser.print_help("Global options:")
+ parser.print_help(self.common_usage + "\nGlobal options:")
print
if display_options: