# HG changeset patch
# User TK Soh <teekaysoh@yahoo.com>
# Date 1124242241 28800
# Node ID ab681ea2857e9d48cf8483963ea40e4df7724197
# Parent  c7a3b88505cd2f274006be02405d22c4e2f5bdc3
updated help text and added manpage section for hg paths

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


diff --git a/doc/hg.1.txt b/doc/hg.1.txt
--- a/doc/hg.1.txt
+++ b/doc/hg.1.txt
@@ -253,6 +253,14 @@ 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.
 
diff --git a/mercurial/commands.py b/mercurial/commands.py
--- a/mercurial/commands.py
+++ b/mercurial/commands.py
@@ -876,7 +876,7 @@ 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 @@ 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')],