summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--documentation/ref-manual/ref-classes.xml48
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 @@
645 </para> 645 </para>
646</section> 646</section>
647 647
648<section id='ref-classes-devupstream'>
649 <title><filename>devupstream.bbclass</filename></title>
650
651 <para>
652 The <filename>devupstream</filename> class uses
653 <link linkend='var-BBCLASSEXTEND'><filename>BBCLASSEXTEND</filename></link>
654 to add a variant of the recipe that fetches from an alternative URI
655 (e.g. Git) instead of a tarball.
656 Following is an example:
657 <literallayout class='monospaced'>
658 BBCLASSEXTEND = "devupstream:target"
659 SRC_URI_class-devupstream = "git://git.example.com/example"
660 SRCREV_class-devupstream = "abcd1234"
661 </literallayout>
662 Adding the above statements to your recipe creates a variant that has
663 <link linkend='var-DEFAULT_PREFERENCE'><filename>DEFAULT_PREFERENCE</filename></link>
664 set to "-1".
665 Consequently, you need to select the variant of the recipe to use it.
666 Any development-specific adjustments can be done by using the
667 <filename>class-devupstream</filename> override.
668 Here is an example:
669 <literallayout class='monospaced'>
670 DEPENDS_append_class-devupstream = " gperf-native"
671
672 do_configure_prepend_class-devupstream() {
673 touch ${S}/README
674 }
675 </literallayout>
676 The class currently only supports creating a development variant of
677 the target recipe, not <filename>native</filename> or
678 <filename>nativesdk</filename> variants.
679 </para>
680
681 <para>
682 The <filename>BBCLASSEXTEND</filename> syntax
683 (i.e. <filename>devupstream:target</filename>) provides support for
684 <filename>native</filename> and <filename>nativesdk</filename>
685 variants.
686 Consequently, this functionality can be added in a future release.
687 </para>
688
689 <para>
690 Support for other version control systems such as Subversion is
691 limited due to BitBake's automatic fetch dependencies (e.g.
692 <filename>subversion-native</filename>).
693 </para>
694</section>
695
648<section id='ref-classes-distro_features_check'> 696<section id='ref-classes-distro_features_check'>
649 <title><filename>distro_features_check.bbclass</filename></title> 697 <title><filename>distro_features_check.bbclass</filename></title>
650 698