# HG changeset patch
# User Augie Fackler <durin42@gmail.com>
# Date 1290998239 21600
# Node ID 62c9e6bd2ca73f74ae8c8a02bc6c6b6162f5a8a1
# Parent  bc5c176b63eb6cac0e773b1375c5ec1745bd50a1
docs: document new config knob for externals support

diff --git a/hgsubversion/help/subversion.rst b/hgsubversion/help/subversion.rst
--- a/hgsubversion/help/subversion.rst
+++ b/hgsubversion/help/subversion.rst
@@ -98,8 +98,9 @@ accepted by several Mercurial commands f
 Support for externals
 ---------------------
 
-When using a standard layout, ``svn:externals`` properties are serialized into
-a single ``.hgsvnexternals`` file having the following syntax::
+When using a standard layout, ``svn:externals`` properties are (by
+default) serialized into a single ``.hgsvnexternals`` file having the
+following syntax::
 
   [.]
    common1 http://path/to/external/svn/repo1
@@ -124,6 +125,11 @@ will not be pushed to the related Subver
 contents **will** be used to update ``svn:externals`` properties on the
 related Subversion repository.
 
+Alternatively, one can use the ``hgsubversion.externals`` in hgrc to
+specify ``subrepos`` as the externals mode. In this mode, ``.hgsub``
+and ``.hgsubstate`` files will be used instead of
+``.hgsvnexternals``. This feature requires Mercurial 1.7.1 or later.
+
 Limitations
 -----------
 
@@ -231,6 +237,12 @@ settings:
     using very old versions of Subversion, and hgsubversion falls back to it
     when necessary.
 
+  ``hgsubversion.externals``
+    Set to ``subrepos`` to switch to subrepos-based externals support
+    (requires Mercurial 1.7.1 or later.) Default is ``svnexternals``,
+    which uses a custom hgsubversion-specific format and works on
+    older versions of Mercurial.
+
 The following options only have an effect on the initial clone of a repository:
 
   ``hgsubversion.layout``