Patchwork [1,of,2] config: add a tip about using 'help extensions' to list available extensions

login
register
mail settings
Submitter Augie Fackler
Date June 7, 2014, 7:53 p.m.
Message ID <b78de345e00af1f2f2ca.1402170839@augie-macbookair.laroche.local>
Download mbox | patch
Permalink /patch/4951/
State Deferred
Headers show

Comments

Augie Fackler - June 7, 2014, 7:53 p.m.
# HG changeset patch
# User Augie Fackler <raf@durin42.com>
# Date 1398790067 14400
#      Tue Apr 29 12:47:47 2014 -0400
# Node ID b78de345e00af1f2f2ca88b98eaafe2ae05824c2
# Parent  7afe70a5d2ad5b22c21ba9be849451407c1f337f
config: add a tip about using 'help extensions' to list available extensions

This should make it (in theory) a little more obvious to newcomers
that they might find helpful tools in that output, without actually
recommending rebase and histedit to all newcomers.
Matt Mackall - July 14, 2014, 11:36 p.m.
On Sat, 2014-06-07 at 15:53 -0400, Augie Fackler wrote:
> # HG changeset patch
> # User Augie Fackler <raf@durin42.com>
> # Date 1398790067 14400
> #      Tue Apr 29 12:47:47 2014 -0400
> # Node ID b78de345e00af1f2f2ca88b98eaafe2ae05824c2
> # Parent  7afe70a5d2ad5b22c21ba9be849451407c1f337f
> config: add a tip about using 'help extensions' to list available extensions
> 
> This should make it (in theory) a little more obvious to newcomers
> that they might find helpful tools in that output, without actually
> recommending rebase and histedit to all newcomers.
> 
> diff --git a/mercurial/commands.py b/mercurial/commands.py
> --- a/mercurial/commands.py
> +++ b/mercurial/commands.py
> @@ -1497,7 +1497,8 @@
>                  '\n'
>                  '[extensions]\n'
>                  '# uncomment these lines to enable some popular extensions\n'
> -                '# (see "hg help extensions" for more info)\n'
> +                '# (see "hg help extensions" for more info and \n'
> +                '# a list of included extensions)\n'

On reflection, I don't think this adds enough to warrant the increased
verbosity. The average user is apparently deeply adverse to reading:
throwing three lines at them rather than two increases the glaze-over
factor by a significant margin.

Patch

diff --git a/mercurial/commands.py b/mercurial/commands.py
--- a/mercurial/commands.py
+++ b/mercurial/commands.py
@@ -1497,7 +1497,8 @@ 
                 '\n'
                 '[extensions]\n'
                 '# uncomment these lines to enable some popular extensions\n'
-                '# (see "hg help extensions" for more info)\n'
+                '# (see "hg help extensions" for more info and \n'
+                '# a list of included extensions)\n'
                 '# pager =\n'
                 '# progress =\n'
                 '# color =\n')