[PATCH 2 of 2] enhanced documentation where path aliases may be involved

Bill Barry after.fallout at gmail.com
Wed Jan 21 15:15:12 CST 2009


# HG changeset patch
# User Bill Barry <after.fallout at gmail.com>
# Date 1232572221 25200
# Node ID 0866cf5b8880755382526f8b3b2cc4fbe8674f4a
# Parent  1b3bc00d15ce94c44128d7a67fb6c545c344c6f7
enhanced documentation where path aliases may be involved

diff --git a/mercurial/commands.py b/mercurial/commands.py
--- a/mercurial/commands.py
+++ b/mercurial/commands.py
@@ -2118,6 +2118,15 @@

      Path names are defined in the [paths] section of /etc/mercurial/hgrc
      and $HOME/.hgrc. If run inside a repository, .hg/hgrc is used, too.
+
+    Two paths are important to know about:
+    'default':
+      When you create a repository with hg clone, the clone command saves
+      the location of the source repository as the 'default' path. This is
+      then used when you omit a path from the push and pull commands.
+    'default-push':
+      The push command will look for a path named 'default-push', and
+      prefer it over 'default' if both are defined.
      """
      if search:
          for name, path in ui.configitems("paths"):
@@ -2180,6 +2189,10 @@
            Compression yes
        Alternatively specify "ssh -C" as your ssh command in your hgrc or
        with the --ssh command line option.
+
+    Paths can also be defined in your hgrc and then you can use the
+    path alias here. If source is ommitted the default path alias is used.
+    See "hg help paths" for more info.
      """
      source, revs, checkout = hg.parseurl(ui.expandpath(source), 
opts.get('rev'))
      cmdutil.setremoteconfig(ui, opts)
@@ -2227,6 +2240,11 @@

      Pushing to http:// and https:// URLs is only possible, if this
      feature is explicitly enabled on the remote Mercurial server.
+
+    Paths can also be defined in your hgrc and then you can use the path
+    alias here. If a path is ommitted, the default-push path alias is 
first
+    looked for, followed by the default path alias to be used as the
+    destination. See "hg help paths" for more info.
      """
      dest, revs, checkout = hg.parseurl(
          ui.expandpath(dest or 'default-push', dest or 'default'), 
opts.get('rev'))




More information about the Mercurial-devel mailing list