[MERGE] concise help for commands by default

[Ben Finney]

Ian Clatworthy <ian.clatworthy at internode.on.net> writes:

> As discussed on the mailing list recently, the help for commands
> should be concise by default with "bzr help -v xxx" being used to
> see the detailed information.

[…]

> === modified file 'bzrlib/commands.py'
> --- bzrlib/commands.py	2009-02-04 04:10:14 +0000
> +++ bzrlib/commands.py	2009-02-06 08:06:04 +0000
> @@ -326,7 +326,7 @@
>          return s
>  
>      def get_help_text(self, additional_see_also=None, plain=True,
> -                      see_also_as_links=False):
> +                      see_also_as_links=False, verbose=True):

Shouldn't that be ‘verbose=False’?

It seems odd for this default to not match the following:

> === modified file 'bzrlib/help.py'
> --- bzrlib/help.py	2008-05-02 07:31:24 +0000
> +++ bzrlib/help.py	2009-02-06 08:06:04 +0000
> @@ -34,7 +34,7 @@
>      )
>  
>  
> -def help(topic=None, outfile=None):
> +def help(topic=None, outfile=None, verbose=False):

[…]

> === modified file 'bzrlib/plugin.py'
> --- bzrlib/plugin.py	2008-11-15 19:41:37 +0000
> +++ bzrlib/plugin.py	2009-02-06 08:06:04 +0000
> @@ -385,7 +385,7 @@
>          """
>          self.module = module
>  
> -    def get_help_text(self, additional_see_also=None):
> +    def get_help_text(self, additional_see_also=None, verbose=False):

[…]


-- 
 \          “The only tyrant I accept in this world is the still voice |
  `\                                          within.” —Mahatma Gandhi |
_o__)                                                                  |
Ben Finney