Expand description of limitations in submodule subscription
Document that adding a subscription will not cause any change in
the submodule revision until changes are merged on the submodule.
Bug: Issue 4451
Change-Id: I67122d5df3951aac8cb703bc24f17b37f7b6b662
diff --git a/Documentation/user-submodules.txt b/Documentation/user-submodules.txt
index 8b9d81b..ef5a011 100644
--- a/Documentation/user-submodules.txt
+++ b/Documentation/user-submodules.txt
@@ -203,6 +203,11 @@
that they use the correct hostname of the running Gerrit instance when
adding submodule subscriptions.
+When converting an existing submodule to use subscription by adding
+a `branch` field into the .gitmodules file, Gerrit does not make any
+change to the submodule's current revision until subsequent updates
+occur on the submodule.
+
=== Relative submodules
To enable easier usage of Gerrit mirrors and/or distribution over
