bitbake: fetch2/gitsm: Documentation improvements for gitsm:// fetcher

(Bitbake rev: ef2bf63e56b87e19d1a9059dd2d81a9a1a537254)

Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

1 files changed, 13 insertions, 3 deletions

diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
index 5aa53defc4..858054f2f2 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
@@ -570,6 +570,19 @@
             </para>
         </section>
 
+        <section id='gitsm-fetcher'>
+            <title>GIT Submodule Fetcher (<filename>gitsm://</filename>)</title>
+
+            <para>
+                This fetcher inherits from the Git fetcher and extends its
+                behavior by fetching a repositories submodules.
+                Uri is passed to the Git fetcher so see <link linkend='git-fetcher'>
+                the git fetcher documentation for syntax</link>.
+                NOTE: You must clean a recipe when switching between 'git://' and
+                'gitsm://' urls.
+            </para>
+        </section>
+
         <section id='other-fetchers'>
             <title>Other Fetchers</title>
 
@@ -583,9 +596,6 @@
                         Perforce (<filename>p4://</filename>)
                         </para></listitem>
                     <listitem><para>
-                        Git Submodules (<filename>gitsm://</filename>)
-                        </para></listitem>
-                    <listitem><para>
                         Trees using Git Annex (<filename>gitannex://</filename>)
                         </para></listitem>
                     <listitem><para>