glossary

[Matt Mackall]

On Fri, 2012-08-03 at 01:45 +0200, Mads Kiilerich wrote:
> Matt Mackall wrote, On 08/02/2012 08:11 AM:
> >
> >> # HG changeset patch
> >> # User Mads Kiilerich<mads at kiilerich.com>
> >> # Date 1343773103 -7200
> >> # Branch stable
> >> # Node ID 7ef0ac99b879924036731f3c62d58ede1720cba9
> >> # Parent  b3cf59ece0402f89f4773a506079be73dc8f08ed
> >> help: add aliases for 'glossary' help topic
> >>
> >> I can never remember the name of 'glossary' help topic and always go through
> >> 'dictionary', 'vocabulary', 'nomenclature' and 'concepts' before I thoroughly
> >> read 'hg help' to find 'glossary'.
> >>
> >> diff --git a/mercurial/help.py b/mercurial/help.py
> >> --- a/mercurial/help.py
> >> +++ b/mercurial/help.py
> >> @@ -157,7 +157,8 @@
> >>       (["extensions"], _("Using Additional Features"), extshelp),
> >>       (["subrepos", "subrepo"], _("Subrepositories"), loaddoc('subrepos')),
> >>       (["hgweb"], _("Configuring hgweb"), loaddoc('hgweb')),
> >> -    (["glossary"], _("Glossary"), loaddoc('glossary')),
> >> +    (["glossary", "dictionary", "vocabulary", "nomenclature", "concepts"],
> >> +     _("Glossary"), loaddoc('glossary')),
> >>       (["hgignore", "ignore"], _("Syntax for Mercurial Ignore Files"),
> >>        loaddoc('hgignore')),
> >>       (["phases"], _("Working with Phases"), loaddoc('phases')),
> >
> >> # HG changeset patch
> >> # User Mads Kiilerich<mads at kiilerich.com>
> >> # Date 1343773187 -7200
> >> # Branch stable
> >> # Node ID 866aa792fd62193e76f0f71b4bebb743798c7bb5
> >> # Parent  7ef0ac99b879924036731f3c62d58ede1720cba9
> >> help: the 'glossary' topic is more like a dictionary of concepts
> >>
> >> - and 'concepts' comes first in the topic list.
> >>
> >> This also changes a localized string.
> >>
> >> diff --git a/mercurial/help.py b/mercurial/help.py
> >> --- a/mercurial/help.py
> >> +++ b/mercurial/help.py
> >> @@ -157,8 +157,8 @@
> >>       (["extensions"], _("Using Additional Features"), extshelp),
> >>       (["subrepos", "subrepo"], _("Subrepositories"), loaddoc('subrepos')),
> >>       (["hgweb"], _("Configuring hgweb"), loaddoc('hgweb')),
> >> -    (["glossary", "dictionary", "vocabulary", "nomenclature", "concepts"],
> >> -     _("Glossary"), loaddoc('glossary')),
> >> +    (["concepts", "glossary", "dictionary", "vocabulary", "nomenclature"],
> >> +     _("Dictionary of Mercurial Concepts"), loaddoc('glossary')),
> >>       (["hgignore", "ignore"], _("Syntax for Mercurial Ignore Files"),
> >>        loaddoc('hgignore')),
> >>       (["phases"], _("Working with Phases"), loaddoc('phases')),
> 
> > Going to pass on these for 2.3, seems there are some bits to discuss.
> 
> Sure.
> 
> Adding all these aliases would be a bit weird. I think I prefer 
> "concepts" ... but I don't know/remember if there are any strong 
> feelings attached to "glossary".

I think this is less necessary now that we have help -k. We might want
to make note that it exists somewhere in the default help. For instance,
change:

 use "hg help" for the full list of commands or "hg -v" for details

to

 use "hg help" to see all topics or "hg help -k TOPIC" to search


-- 
Mathematics is the supreme nostalgia of our time.