Usage of 'hg convert'

[Rafael Villar Burke]

I've added Guido's and Patrick's comments to the convert extension wiki
page. Please check it's ok, as I haven't used the extension myself.

Also, in the way I've found some outdated information in the help text
for the extension. Here follows a patch with some changes:

# HG changeset patch
# User Rafael Villar Burke <pachi at rvburke.com>
# Date 1194008312 -3600
# Node ID 09ba8b49789b49530af99006e6fb48a613f6971f
# Parent  3aa5c45874c60560d75df74adbc964e107c8538a
Update convert help text

Add Mercurial as a source format, clarify that the include directive
triggers th
e exclusion of all not explicitely included files/dirs and use MAPFILE
instead o
f revmapfile in the text, following the short message convention.

diff -r 3aa5c45874c6 -r 09ba8b49789b hgext/convert/__init__.py
--- a/hgext/convert/__init__.py Sat Oct 20 03:04:34 2007 +0200
+++ b/hgext/convert/__init__.py Fri Nov 02 13:58:32 2007 +0100
@@ -299,6 +299,7 @@ def convert(ui, src, dest=None, revmapfi
     """Convert a foreign SCM repository to a Mercurial one.

     Accepted source formats:
+    - Mercurial
     - CVS
     - Darcs
     - git
@@ -315,8 +316,8 @@ def convert(ui, src, dest=None, revmapfi
     basename of the source with '-hg' appended.  If the destination
     repository doesn't exist, it will be created.

-    If <revmapfile> isn't given, it will be put in a default location
-    (<dest>/.hg/shamap by default).  The <revmapfile> is a simple text
+    If <MAPFILE> isn't given, it will be put in a default location
+    (<dest>/.hg/shamap by default).  The <MAPFILE> is a simple text
     file that maps each source commit ID to the destination ID for
     that revision, like so:
     <source ID> <destination ID>
@@ -342,11 +343,12 @@ def convert(ui, src, dest=None, revmapfi
       rename from/file to/file

     The 'include' directive causes a file, or all files under a
-    directory, to be included in the destination repository.  The
-    'exclude' directive causes files or directories to be omitted.
-    The 'rename' directive renames a file or directory.  To rename
-    from a subdirectory into the root of the repository, use '.' as
-    the path to rename to.
+    directory, to be included in the destination repository, and the
+    exclussion of all other files and dirs not explicitely included.
+    The 'exclude' directive causes files or directories to be omitted.
+    The 'rename' directive renames a file or directory.  To rename from a
+    subdirectory into the root of the repository, use '.' as the path to
+    rename to.
     """

     util._encoding = 'UTF-8'