diff --git a/Lib/distutils/command/clean.py b/Lib/distutils/command/clean.py index 1844ffefd37..02189c531a8 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 9eb2aa424c1..4f4bae5218d 100644 --- a/Lib/distutils/dist.py +++ b/Lib/distutils/dist.py @@ -59,6 +59,15 @@ class Distribution: ('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 @@ def _show_help (self, 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: diff --git a/Misc/NEWS b/Misc/NEWS index 42ef277c3d3..a128cc78234 100644 --- a/Misc/NEWS +++ b/Misc/NEWS @@ -59,6 +59,8 @@ Extension Modules Library ------- +- Patch #1104111: Alter setup.py --help and --help-commands. + - Patch #1121234: Properly cleanup _exit and tkerror commands. - Patch #1049151: xdrlib now unpacks booleans as True or False.