hgext/convert/__init__.py

--- a/hgext/convert/__init__.py	Thu Jul 16 23:25:25 2009 +0200
+++ b/hgext/convert/__init__.py	Thu Jul 16 23:25:26 2009 +0200
@@ -19,6 +19,7 @@
     """convert a foreign SCM repository to a Mercurial one.
 
     Accepted source formats [identifiers]:
+
     - Mercurial [hg]
     - CVS [cvs]
     - Darcs [darcs]
@@ -30,6 +31,7 @@
     - Perforce [p4]
 
     Accepted destination formats [identifiers]:
+
     - Mercurial [hg]
     - Subversion [svn] (history on branches is not preserved)
 
@@ -45,21 +47,23 @@
     uses --sourcesort to preserve original revision numbers order. Sort modes
     have the following effects:
 
-    --branchsort: convert from parent to child revision when possible, which
-      means branches are usually converted one after the other. It generates
-      more compact repositories.
-    --datesort: sort revisions by date. Converted repositories have
-      good-looking changelogs but are often an order of magnitude larger than
-      the same ones generated by --branchsort.
-    --sourcesort: try to preserve source revisions order, only supported by
-      Mercurial sources.
+    --branchsort  convert from parent to child revision when possible, which
+                  means branches are usually converted one after the other. It
+                  generates more compact repositories.
+
+    --datesort    sort revisions by date. Converted repositories have
+                  good-looking changelogs but are often an order of magnitude
+                  larger than the same ones generated by --branchsort.
+
+    --sourcesort  try to preserve source revisions order, only supported by
+                  Mercurial sources.
 
     If <REVMAP> isn't given, it will be put in a default location
     (<dest>/.hg/shamap by default). The <REVMAP> is a simple text file that
     maps each source commit ID to the destination ID for that revision, like
-    so:
+    so::
 
-    <source ID> <destination ID>
+      <source ID> <destination ID>
 
     If the file doesn't exist, it's automatically created. It's updated on
     each commit copied, so convert-repo can be interrupted and can be run
@@ -72,7 +76,7 @@
 
     The filemap is a file that allows filtering and remapping of files and
     directories. Comment lines start with '#'. Each line can contain one of
-    the following directives:
+    the following directives::
 
       include path/to/file
 
@@ -134,17 +138,17 @@
     Because CVS does not have changesets, it is necessary to collect
     individual commits to CVS and merge them into changesets. CVS source uses
     its internal changeset merging code by default but can be configured to
-    call the external 'cvsps' program by setting:
+    call the external 'cvsps' program by setting::
 
-    --config convert.cvsps='cvsps -A -u --cvs-direct -q'
+      --config convert.cvsps='cvsps -A -u --cvs-direct -q'
 
     This option is deprecated and will be removed in Mercurial 1.4.
 
     The options shown are the defaults.
 
-    Internal cvsps is selected by setting
+    Internal cvsps is selected by setting ::
 
-    --config convert.cvsps=builtin
+      --config convert.cvsps=builtin
 
     and has a few more configurable options: