From 6a88ae7153193a01a796b61e8eef4e496d9f4e68 Mon Sep 17 00:00:00 2001
From: Oleg Broytman <phd@phdru.name>
Date: Tue, 1 Sep 2015 21:19:36 +0300
Subject: [PATCH] Explain hg-git, fast-export and git-remote-hg

---
 pep-git.txt | 24 +++++++++++++++++++++---
 1 file changed, 21 insertions(+), 3 deletions(-)

diff --git a/pep-git.txt b/pep-git.txt
index 52193f0..f24d9e8 100644
--- a/pep-git.txt
+++ b/pep-git.txt
@@ -859,11 +859,29 @@ license).
 From Mercurial to git
 =====================
 
-Mercurial for Git users https://mercurial.selenic.com/wiki/GitConcepts
+There are many tools to convert Mercurial repositories to git. The
+most famous are, perhaps, `hg-git <https://hg-git.github.io/>`_ and
+`fast-export <http://repo.or.cz/w/fast-export.git>`_ (many years ago
+it was known under the name ``hg2git``).
+
+But a better tool, perhaps the best, is `git-remote-hg
+<https://github.com/felipec/git-remote-hg>`_. It provides transparent
+bidirectional access (pull and push) to Mercurial repositories from
+git. The author wrote a `comparison of alternatives
+<https://github.com/felipec/git/wiki/Comparison-of-git-remote-hg-alternatives>`_
+that seems to be objective.
+
+To use git-remote-hg, install or clone it, add to your PATH and
+prepend ``hg::`` to Mercurial URLs. For example::
 
-https://github.com/felipec/git-remote-hg
+    $ git clone https://github.com/felipec/git-remote-hg.git
+    $ PATH=$PATH:"`pwd`"/git-remote-hg
+    $ git clone hg::https://hg.python.org/peps/ PEPs
 
-https://hg-git.github.io/
+To work with the repository just use normal ``git fetch/pull/push``
+commands.
+
+Mercurial for Git users https://mercurial.selenic.com/wiki/GitConcepts
 
 
 References
-- 
2.39.2