help: update help

make help description 'topic'-oriented rather than 'command'-oriented
change 'special' to 'additional'

mercurial/commands.py

@@ -1242,14 +1242,11 b' def heads(ui, repo, *branchrevs, **opts)'
         displayer.show(changenode=n)
 
 def help_(ui, name=None, with_version=False):
-    """show help for a command, extension, or list of commands
+    """show help for a given topic or a help overview
 
     With no arguments, print a list of commands and short help.
 
-    Given a command name, print help for that command.
-
-    Given an extension name, print help for that extension, and the
-    commands it provides."""
+    Given a topic, extension, or command name, print help for that topic."""
     option_lists = []
 
     def addglobalopts(aliases):
@@ -1434,7 +1431,7 b' def help_(ui, name=None, with_version=Fa'
                                          or "")))
 
     if not name:
-        ui.write(_("\nspecial help topics:\n\n"))
+        ui.write(_("\nadditional help topics:\n\n"))
         topics = []
         for names, header, doc in help.helptable:
             names = [(-len(name), name) for name in names]
@@ -3130,7 +3127,7 b' table = {'
          [('r', 'rev', '', _('show only heads which are descendants of rev')),
          ] + templateopts,
          _('hg heads [-r REV] [REV]...')),
-    "help": (help_, [], _('hg help [COMMAND]')),
+    "help": (help_, [], _('hg help [TOPIC]')),
     "identify|id":
         (identify,
          [('r', 'rev', '', _('identify the specified rev')),

tests/test-bad-extension.out

@@ -1,5 +1,5 b''
 *** failed to import extension badext from .../badext.py: bit bucket overflow
 *** failed to import extension badext2: No module named badext2
-hg help [COMMAND]
+hg help [TOPIC]
 
-show help for a command, extension, or list of commands
+show help for a given topic or a help overview

tests/test-globalopts.out

@@ -166,7 +166,7 b' list of commands:'
  export       dump the header and diffs for one or more changesets
  grep         search for a pattern in specified files and revisions
  heads        show current repository heads or show branch heads
- help         show help for a command, extension, or list of commands
+ help         show help for a given topic or a help overview
  identify     identify the working copy or specified revision
  import       import an ordered set of patches
  incoming     show new changesets found in source
@@ -198,7 +198,7 b' list of commands:'
  verify       verify the integrity of the repository
  version      output version and copyright information
 
-special help topics:
+additional help topics:
 
  dates        Date Formats
  patterns     File Name Patterns
@@ -228,7 +228,7 b' list of commands:'
  export       dump the header and diffs for one or more changesets
  grep         search for a pattern in specified files and revisions
  heads        show current repository heads or show branch heads
- help         show help for a command, extension, or list of commands
+ help         show help for a given topic or a help overview
  identify     identify the working copy or specified revision
  import       import an ordered set of patches
  incoming     show new changesets found in source
@@ -260,7 +260,7 b' list of commands:'
  verify       verify the integrity of the repository
  version      output version and copyright information
 
-special help topics:
+additional help topics:
 
  dates        Date Formats
  patterns     File Name Patterns

tests/test-help.out

@@ -57,7 +57,7 b' list of commands:'
  export       dump the header and diffs for one or more changesets
  grep         search for a pattern in specified files and revisions
  heads        show current repository heads or show branch heads
- help         show help for a command, extension, or list of commands
+ help         show help for a given topic or a help overview
  identify     identify the working copy or specified revision
  import       import an ordered set of patches
  incoming     show new changesets found in source
@@ -89,7 +89,7 b' list of commands:'
  verify       verify the integrity of the repository
  version      output version and copyright information
 
-special help topics:
+additional help topics:
 
  dates        Date Formats
  patterns     File Name Patterns
@@ -115,7 +115,7 b' use "hg -v help" to show aliases and glo'
  export       dump the header and diffs for one or more changesets
  grep         search for a pattern in specified files and revisions
  heads        show current repository heads or show branch heads
- help         show help for a command, extension, or list of commands
+ help         show help for a given topic or a help overview
  identify     identify the working copy or specified revision
  import       import an ordered set of patches
  incoming     show new changesets found in source
@@ -147,7 +147,7 b' use "hg -v help" to show aliases and glo'
  verify       verify the integrity of the repository
  version      output version and copyright information
 
-special help topics:
+additional help topics:
 
  dates        Date Formats
  patterns     File Name Patterns