doc: document 'git submodule status --cached'

Manishearth · gitster · commit 8d483c840836 · 2019-11-24T13:52:29.000+09:00
'git submodule status --cached' reports the SHAs recorded in the
index of the superproject, instead of the SHAs that are checked out
in the submodule.

Signed-off-by: Manish Goregaokar &lt;manishsmail@gmail.com&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
diff --git a/Documentation/git-submodule.txt b/Documentation/git-submodule.txt
@@ -80,6 +80,9 @@ status [--cached] [--recursive] [--] [<path>...]::
 	does not match the SHA-1 found in the index of the containing
 	repository and `U` if the submodule has merge conflicts.
 +
+If `--cached` is specified, this command will instead print the SHA-1
+recorded in the superproject for each submodule.
++
 If `--recursive` is specified, this command will recurse into nested
 submodules, and show their status as well.
 +

Original file line number	Diff line number	Diff line change
`@@ -80,6 +80,9 @@ status [--cached] [--recursive] [--] [<path>...]::`
`80`	`80`	`does not match the SHA-1 found in the index of the containing`
`81`	`81`	repository and `U` if the submodule has merge conflicts.
`82`	`82`	`+`
	`83`	+If `--cached` is specified, this command will instead print the SHA-1
	`84`	`+recorded in the superproject for each submodule.`
	`85`	`++`
`83`	`86`	If `--recursive` is specified, this command will recurse into nested
`84`	`87`	`submodules, and show their status as well.`
`85`	`88`	`+`