path: root/documentation/ref-manual/migration.xml
diff options
authorScott Rifenbark <>2014-04-23 11:35:25 -0700
committerRichard Purdie <>2014-04-23 21:11:08 +0100
commit68ef727cdcef439e9bfc57996f3cebfc0e07789e (patch)
tree684b0d4a0e6a66863f889df44a60a3931d99199a /documentation/ref-manual/migration.xml
parent4b5e855670bddb0ffc4cc7b24005e53e3eefcd69 (diff)
ref-manual: Added new section to the 1.6 migration section plus some 1.5 edits.
Added a new section on "Matching Branch Requirement for Git Fetching" into the BitBake section. Plus, made some minor corrections to some of the 1.5 sections. (From yocto-docs rev: 326a8009ca0bef0a4686510bb521010d8f58ac81) Signed-off-by: Scott Rifenbark <> Signed-off-by: Richard Purdie <>
Diffstat (limited to 'documentation/ref-manual/migration.xml')
1 files changed, 28 insertions, 3 deletions
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index 0f0e8b06a9..7cefa5ebf4 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -829,10 +829,10 @@
<section id='migration-1.5-run'>
- <title><filename>run</filename></title>
+ <title><filename>/run</filename></title>
- The <filename>run</filename> directory from the Filesystem
+ The <filename>/run</filename> directory from the Filesystem
Hierarchy Standard 3.0 has been introduced.
You can find some of the implications for this change
<ulink url=''>here</ulink>.
@@ -878,7 +878,7 @@
The previously deprecated <filename>task.bbclass</filename> has
now been dropped.
- For recipes that previously inherited from this task, you should
+ For recipes that previously inherited from this class, you should
rename them from <filename>task-*</filename> to
<filename>packagegroup-*</filename> and inherit packagegroup
@@ -1150,6 +1150,31 @@
<ulink url='&YOCTO_DOCS_DEV_URL;#bitbake-term'>BitBake</ulink>.
+ <section id='migration-1.6-matching-branch-requirement-for-git-fetching'>
+ <title>Matching Branch Requirement for Git Fetching</title>
+ <para>
+ When fetching source from a Git repository using
+ <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link>,
+ BitBake will now validate the
+ <link linkend='var-SRCREV'><filename>SRCREV</filename></link>
+ value against the branch.
+ You can specify the branch using the following form:
+ <literallayout class='monospaced'>
+ SRC_URI = "git://;branch=&lt;branchname&gt;"
+ </literallayout>
+ If you do not specify a branch, BitBake looks
+ in the default "master" branch.
+ </para>
+ <para>
+ Alternatively, if you need to bypass this check (e.g.
+ if you are fetching a revision corresponding to a tag that
+ is not on any branch), you can add ";nobranch=1" to
+ the end of the URL within <filename>SRC_URI</filename>.
+ </para>
+ </section>
<section id='migration-1.6-bitbake-deps'>
<title>Python Definition substitutions</title>