diff --git a/doc/vcsh.1.ronn b/doc/vcsh.1.ronn
index 76ae2a50920cb57db994787ada87f9ba5cb1e38a..0fbead9a78c4f30ce0e1d02680a913249c49dbf7 100644
--- a/doc/vcsh.1.ronn
+++ b/doc/vcsh.1.ronn
@@ -160,6 +160,12 @@ 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
+
+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.
+
 ## HISTORY
 
 Like most people, the author initially made do with a single repository for all