Merge branch 'sb/submodule-recommend-shallowness'

Doc update.

* sb/submodule-recommend-shallowness:
gitmodules: document shallow recommendation

diff --combined Documentation/gitmodules.txt
index 07cdd73ab2e68da4aaef30a523801f56610b176c,b97b331ad5cdc73bae238a5c57a7aa5c2d7a9d88..0849d281bb79b8a394a00f50fc09a10aba15d4f2
--- 1/Documentation/gitmodules.txt
--- 2/Documentation/gitmodules.txt
+++ b/Documentation/gitmodules.txt
@@@ -19,7 -19,7 +19,7 @@@ of linkgit:git-config[1]
  
  The file contains one subsection per submodule, and the subsection value
  is the name of the submodule. The name is set to the path where the
 -submodule has been added unless it was customized with the '--name'
 +submodule has been added unless it was customized with the `--name`
  option of 'git submodule add'. Each submodule section also contains the
  following required keys:
  
@@@ -79,6 -79,11 +79,11 @@@ submodule.<name>.ignore:
        "--ignore-submodule" option. The 'git submodule' commands are not
        affected by this setting.
  
+ submodule.<name>.shallow::
+       When set to true, a clone of this submodule will be performed as a
+       shallow clone unless the user explicitely asks for a non-shallow
+       clone.
+ 
  
  EXAMPLES
  --------