[Python-checkins] devguide: #14468: update FAQs about multiple clones and share extension.

[ezio.melotti]

http://hg.python.org/devguide/rev/ec43cf291255
changeset:   604:ec43cf291255
user:        Ezio Melotti <ezio.melotti at gmail.com>
date:        Tue Feb 26 04:33:17 2013 +0200
summary:
  #14468: update FAQs about multiple clones and share extension.

files:
  committing.rst |   2 ++
  faq.rst        |  21 +++++++++------------
  2 files changed, 11 insertions(+), 12 deletions(-)


diff --git a/committing.rst b/committing.rst
--- a/committing.rst
+++ b/committing.rst
@@ -274,6 +274,8 @@
 
 See :ref:`checkout` to find information about cloning and switching branches.
 
+.. _multiple-clones:
+
 Multiple Clones Approach
 ''''''''''''''''''''''''
 
diff --git a/faq.rst b/faq.rst
--- a/faq.rst
+++ b/faq.rst
@@ -335,7 +335,13 @@
 I want to keep a separate working copy per development branch, is it possible?
 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 
-Just clone your local repository and update each clone to a different branch::
+There are two ways:
+
+1) Use the "`share extension`_" as described in the :ref:`multiple-clones`
+   section;
+2) Create several clones of your local repository;
+
+If you want to use the second way, you can do::
 
    $ hg clone cpython py33
    updating to branch default
@@ -347,6 +353,8 @@
 The current branch in a working copy is "sticky": if you pull in some new
 changes, ``hg update`` will update to the head of the *current branch*.
 
+.. _share extension: http://mercurial.selenic.com/wiki/ShareExtension
+
 
 .. _hg-paths:
 
@@ -726,17 +734,6 @@
 These FAQs are intended mainly for core developers.
 
 
-How do I avoid repeated pulls and pushes between my local repositories?
-'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
-
-The "`share extension`_" allows you to share a single local repository
-between several working copies: each commit you make in a working copy will
-be immediately available in other working copies, even though they might
-be checked out on different branches.
-
-.. _share extension: http://mercurial.selenic.com/wiki/ShareExtension
-
-
 .. _hg-commit:
 
 How do I commit a change to a file?

-- 
Repository URL: http://hg.python.org/devguide