diff --git a/README b/README
new file mode 100644
index 0000000000000000000000000000000000000000..78001a951a305a1bd9ef93af11b41bbd54f682d3
--- /dev/null
+++ b/README
@@ -0,0 +1,36 @@
+To convert the lyskom-elisp-client repo from CVS to Git, clone this
+module, and type "make".  This will create 99.git which should be a
+reasonably good representation of the history of the elisp client.
+
+Prerequisites:
+
+ - A modern Git. Version 1.8.2 is good enough.
+
+ - Access to cvs.lysator.liu.se via ssh so that you can copy the repo.
+
+ - About 800 MB of disk space.  (The converted repo requires less than
+   12 Mbyte of space, but much more is needed during the conversion,
+   and we keep many copies of the data during the conversion.)
+
+ - Lots of time.  Running the conversion can take an hour, depending
+   on how fast your computer is.
+
+Caveats:
+
+ - If you change anything, especially in extratags.txt or
+   extrabranches.txt, you should remove the cache file in ~/.cvsps/.
+   These scripts try to pass "-p -u" to "git cvsimport", but
+   apparently that is not enough to throw away the content of that
+   cache file.
+
+TODO:
+
+ - Publish a new test conversion repo and ask for feedback.
+
+ - Compare the tags with any old source dists you can find.
+
+ - Look att all commits we alter and ensure they are sane.  In
+   particular, check that they contain the expected changes and have a
+   sane author, committer and timestamp.
+
+ - Upload the repo to git.lysator.liu.se.