# HG changeset patch
# User Siddharth Agarwal <sid0@fb.com>
# Date 1417771123 28800
#      Fri Dec 05 01:18:43 2014 -0800
# Node ID 82b457515ddb1574e02eaeda623364b7e7c7e37a
# Parent  4f0b86da5e72e58dbb5597669800ea9d967e4c40
readme: add docs for rename detection options

diff --git a/README.md b/README.md
--- a/README.md
+++ b/README.md
@@ -228,3 +228,28 @@
 If set, branches where the latest commit's commit time is older than this will
 not be imported. Accepts any date formats that Mercurial does -- see
 `hg help dates` for more.
+
+git.similarity
+--------------
+
+Specify how similar files modified in a Git commit must be to be imported as
+Mercurial renames or copies, as a percentage between "0" (disabled) and "100"
+(files must be identical). For example, "90" means that a delete/add pair will
+be imported as a rename if more than 90% of the file has stayed the same. The
+default is "0" (disabled).
+
+git.renamelimit
+---------------
+
+The number of files to consider when performing the copy/rename detection.
+Detection is disabled if the number of files modified in a commit is above the
+limit. Detection is O(N^2) in the number of files modified, so be sure not to
+set the limit too high. Similar to Git's `diff.renameLimit` config. The default
+is "400", the same as Git.
+
+git.findcopiesharder
+--------------------
+
+Whether to consider unmodified files as copy sources. This is a very expensive
+operation for large projects, so use it with caution. Similar to `git diff`'s
+--find-copies-harder option.