updated help text and added manpage section for hg paths

Index: hg/doc/hg.1.txt
===================================================================

doc/hg.1.txt

@@ -253,6 +253,14 b' manifest [revision]::'
 parents::
     Print the working directory's parent revisions.
 
+paths [NAME]::
+    Show definition of symbolic path name NAME. If no name is given, show
+    definition of available names.
+
+    Path names are defined in the [paths] section of the $HOME/.hgrc and
+    <repo>/.hg/hgrc configuration files. If run outside a repo, 'paths'
+    queries only $HOME/.hgrc.
+
 pull <repository path>::
     Pull changes from a remote repository to a local one.
 

mercurial/commands.py

@@ -876,7 +876,7 b' def parents(ui, repo, rev=None):'
             show_changeset(ui, repo, changenode=n)
 
 def paths(ui, search = None):
-    """show path or list of available paths"""
+    """show definition of symbolic path names"""
     try:
         repo = hg.repository(ui=ui)
     except:
@@ -1320,7 +1320,7 b' table = {'
     "manifest": (manifest, [], 'hg manifest [REV]'),
     "outgoing": (outgoing, [], 'hg outgoing [DEST]'),
     "parents": (parents, [], 'hg parents [REV]'),
-    "paths": (paths, [], 'hg paths [name]'),
+    "paths": (paths, [], 'hg paths [NAME]'),
     "^pull":
         (pull,
          [('u', 'update', None, 'update working directory')],