diff --git a/doc/vcsh.1.ronn b/doc/vcsh.1.ronn
index 88ebd9dd0633890cdd6b30d845bc934b3e803698..bab8bcd76cf9386ae605741f081f48457a4b99aa 100644
--- a/doc/vcsh.1.ronn
+++ b/doc/vcsh.1.ronn
@@ -173,11 +173,10 @@ You can put any and all commands into this config file and they will be executed
 
 None are known at this time, but reports and/or patches are more than welcome.
 
-## KNOWN ISSUES
+## INTEROPERABILITY
 
-As of this writing (June 2012), `vcsh` does not work with `git submodule` due
-to limitations within `git`. Depending on when you are reading this, you might
-want to consider upgrading.
+If you rely on `git submodule`, use `git` 1.7.12 or later. Earlier versions
+do not clean internal variables properly before descending into a submodule.
 
 ## HISTORY