glossary

[Mads Kiilerich]

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".

/Mads