diff --git a/README.md b/README.md
index 04834386240b65e00d84a0c5b7dae1170b900ace..8df73395a2696681cc52ee426ced1bfd3065a0f9 100644
--- a/README.md
+++ b/README.md
@@ -118,11 +118,12 @@ this:
 
 ### repo.d ###
 
-$XDG_CONFIG_HOME/vcsh/repo.d is the directory into which vcsh clones the git
-repositories. Since their working trees are configured to be in $HOME, the
-files contained in those repositories will be put in $HOME directly (see .zshrc
-above).
-
+$XDG_CONFIG_HOME/vcsh/repo.d is the directory where all git repositories which
+are under vcsh's control are located. Since their working trees are configured
+to be in $HOME, the files contained in those repositories will be put in $HOME
+directly.
+Of course, [mr] [1] will work with this layout if configured according to this
+document (see above).
 
 vcsh will check if any file it would want to create exists. If it exists, vcsh
 will throw a warning and exit. Move away your old config and try again.