diff options
author | 2018-11-14 11:07:12 -0800 | |
---|---|---|
committer | 2018-11-22 12:20:52 +0000 | |
commit | 4adb1e29a1889c1512ad8b03fd85903d84d3c926 (patch) | |
tree | 628fe424e7f880c4e289e440a59307a9938dfc92 /documentation/ref-manual | |
parent | e33920f4c94312efdb09ce6305aa353f323a6c38 (diff) | |
download | openembedded-core-contrib-4adb1e29a1889c1512ad8b03fd85903d84d3c926.tar.gz |
ref-manual: Added description for devupstream.bbclass
New section added.
Fixes [YOCTO #12732]
(From yocto-docs rev: 3d4a1fef8e1809cd7f1dece55790b6ee12dc60b3)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r-- | documentation/ref-manual/ref-classes.xml | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml index aef58203bb..a6e5ed6d4d 100644 --- a/documentation/ref-manual/ref-classes.xml +++ b/documentation/ref-manual/ref-classes.xml @@ -645,6 +645,54 @@ </para> </section> +<section id='ref-classes-devupstream'> + <title><filename>devupstream.bbclass</filename></title> + + <para> + The <filename>devupstream</filename> class uses + <link linkend='var-BBCLASSEXTEND'><filename>BBCLASSEXTEND</filename></link> + to add a variant of the recipe that fetches from an alternative URI + (e.g. Git) instead of a tarball. + Following is an example: + <literallayout class='monospaced'> + BBCLASSEXTEND = "devupstream:target" + SRC_URI_class-devupstream = "git://git.example.com/example" + SRCREV_class-devupstream = "abcd1234" + </literallayout> + Adding the above statements to your recipe creates a variant that has + <link linkend='var-DEFAULT_PREFERENCE'><filename>DEFAULT_PREFERENCE</filename></link> + set to "-1". + Consequently, you need to select the variant of the recipe to use it. + Any development-specific adjustments can be done by using the + <filename>class-devupstream</filename> override. + Here is an example: + <literallayout class='monospaced'> + DEPENDS_append_class-devupstream = " gperf-native" + + do_configure_prepend_class-devupstream() { + touch ${S}/README + } + </literallayout> + The class currently only supports creating a development variant of + the target recipe, not <filename>native</filename> or + <filename>nativesdk</filename> variants. + </para> + + <para> + The <filename>BBCLASSEXTEND</filename> syntax + (i.e. <filename>devupstream:target</filename>) provides support for + <filename>native</filename> and <filename>nativesdk</filename> + variants. + Consequently, this functionality can be added in a future release. + </para> + + <para> + Support for other version control systems such as Subversion is + limited due to BitBake's automatic fetch dependencies (e.g. + <filename>subversion-native</filename>). + </para> +</section> + <section id='ref-classes-distro_features_check'> <title><filename>distro_features_check.bbclass</filename></title> |