aboutsummaryrefslogtreecommitdiffstats
path: root/bitbake
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2014-05-19 14:49:56 +0300
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-06-18 13:48:38 +0100
commit77166a2a8846ca61b67b37a8f7f885f0405d214b (patch)
treee1b92e638175f9836381887c541b688c6fce151e /bitbake
parent655e2baf1d292b5f699e620dc41971b42b468169 (diff)
downloadopenembedded-core-contrib-77166a2a8846ca61b67b37a8f7f885f0405d214b.tar.gz
bitbake: bitbake-user-manual-fetching.xml: Added new Git Submodule Fetcher section.
Added the "GIT Submodule Fetcher (gitsm://)" section to the fetchers chapter. This information was provided by Chris Morgan. Reported-by: Chris Morgan <chmorgan@gmail.com> (Bitbake rev: a3a3331e7118fd3139fe5a80b157a5a5b38631de) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'bitbake')
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml27
1 files changed, 21 insertions, 6 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 858054f2f2..f5031cfba7 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
@@ -574,12 +574,27 @@
<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.
+ This fetcher submodule inherits from the
+ <link linkend='git-fetcher'>Git fetcher</link> and extends
+ that fetcher's behavior by fetching a repository's submodules.
+ URI is passed to the Git fetcher as described in the
+ "<link linkend='git-fetcher'>GIT Fetcher (<filename>git://</filename>)</link>"
+ section.
+ <note>
+ <title>Notes and Warnings</title>
+ <para>
+ You must clean a recipe when switching between
+ '<filename>git://</filename>' and
+ '<filename>gitsm://</filename>' URLs.
+ </para>
+
+ <para>
+ The Git Submodules fetcher is not a complete fetcher
+ implementation.
+ The fetcher has known issues where it does not use the
+ normal source mirroring infrastructure properly.
+ </para>
+ </note>
</para>
</section>