Handbook: Documentation for DISTRO_PN_ALIAS
Signed-Off-By: Nitin A Kamble <nitin.a.kamble@intel.com
This commit is contained in:
parent
682983b548
commit
6b82b70c93
|
@ -825,7 +825,7 @@ SRC_URI += "file://NAME-OF-PATCH.patch;patch=1"
|
||||||
|
|
||||||
</section>
|
</section>
|
||||||
<section id='usingpoky-configuring-LIC_FILES_CHKSUM'>
|
<section id='usingpoky-configuring-LIC_FILES_CHKSUM'>
|
||||||
<title>configuring the LIC_FILES_CHKSUM variable</title>
|
<title>Configuring the LIC_FILES_CHKSUM variable</title>
|
||||||
<para>
|
<para>
|
||||||
The changes in the license text inside source code files is tracked
|
The changes in the license text inside source code files is tracked
|
||||||
using the LIC_FILES_CHKSUM metadata variable.
|
using the LIC_FILES_CHKSUM metadata variable.
|
||||||
|
@ -885,7 +885,50 @@ specify "beginline" and "endline" parameters.
|
||||||
</tip>
|
</tip>
|
||||||
</section>
|
</section>
|
||||||
</section>
|
</section>
|
||||||
|
<section id='usingpoky-configuring-DISTRO_PN_ALIAS'>
|
||||||
|
<title>Configuring the DISTRO_PN_ALIAS variable</title>
|
||||||
|
<para>
|
||||||
|
Sometimes the names of the same packages are different in different
|
||||||
|
linux distributions; and that can becomes an issue for the distro_check
|
||||||
|
task to check if the given recipe package exists in other linux distros.
|
||||||
|
This issue is avoided by defining per distro recipe name alias:
|
||||||
|
DISTRO_PN_ALIAS
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<section id='usingpoky-specifying-DISTRO_PN_ALIAS'>
|
||||||
|
<title>Specifying the DISTRO_PN_ALIAS variable </title>
|
||||||
|
|
||||||
|
<programlisting>
|
||||||
|
DISTRO_PN_ALIAS = "distro1=package_name_alias1; distro2=package_name_alias2 \
|
||||||
|
distro3=package_name_alias3; \
|
||||||
|
..."
|
||||||
|
</programlisting>
|
||||||
|
<para>
|
||||||
|
Look at the meta/packages/xorg-app/xset_1.0.4.bb recipe file for an example.
|
||||||
|
</para>
|
||||||
|
<tip>
|
||||||
|
<para>
|
||||||
|
The current code can check if the src package for a recipe exists in the latest
|
||||||
|
releases of these distributions automatically.
|
||||||
|
</para>
|
||||||
|
<programlisting>
|
||||||
|
Fedora, OpenSuSE, Debian, Ubuntu, Mandriva
|
||||||
|
</programlisting>
|
||||||
|
<para>
|
||||||
|
For example, this command will generate a report, listing which linux distros include the
|
||||||
|
sources for each of the poky recipe.
|
||||||
|
</para>
|
||||||
|
<programlisting>
|
||||||
|
bitbake world -f -c distro_check
|
||||||
|
</programlisting>
|
||||||
|
<para>
|
||||||
|
The results will be stored in the build/tmp/log/distro_check-${DATETIME}.results file.
|
||||||
|
</para>
|
||||||
|
</tip>
|
||||||
|
</section>
|
||||||
|
</section>
|
||||||
</chapter>
|
</chapter>
|
||||||
|
|
||||||
<!--
|
<!--
|
||||||
vim: expandtab tw=80 ts=4
|
vim: expandtab tw=80 ts=4
|
||||||
-->
|
-->
|
||||||
|
|
|
@ -216,6 +216,19 @@
|
||||||
</glossdef>
|
</glossdef>
|
||||||
</glossentry>
|
</glossentry>
|
||||||
|
|
||||||
|
<glossentry id='var-DISTRO_PN_ALIAS'><glossterm>DISTRO_PN_ALIAS</glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para>Alias names of the recipe in various Linux distributions. </para>
|
||||||
|
<para>See the "meta/package/xorg-app/xset_1.0.4.bb" file for an example</para>
|
||||||
|
<para>More information in
|
||||||
|
<link
|
||||||
|
linkend='usingpoky-configuring-DISTRO_PN_ALIAS'>
|
||||||
|
Configuring the DISTRO_PN_ALIAS variable section
|
||||||
|
</link>
|
||||||
|
</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
|
||||||
<glossentry id='var-DISTRO_VERSION'><glossterm>DISTRO_VERSION</glossterm>
|
<glossentry id='var-DISTRO_VERSION'><glossterm>DISTRO_VERSION</glossterm>
|
||||||
<glossdef>
|
<glossdef>
|
||||||
<para>Version of distribution</para>
|
<para>Version of distribution</para>
|
||||||
|
@ -406,6 +419,10 @@
|
||||||
<para> This is an optional variable now. And the plan is to make
|
<para> This is an optional variable now. And the plan is to make
|
||||||
it a required variable in the future </para>
|
it a required variable in the future </para>
|
||||||
<para>See the "meta/package/zlib/zlib_${PV}.bb" file for an example</para>
|
<para>See the "meta/package/zlib/zlib_${PV}.bb" file for an example</para>
|
||||||
|
|
||||||
|
<para>More information in <link
|
||||||
|
linkend='usingpoky-configuring-LIC_FILES_CHKSUM'>
|
||||||
|
Configuring the LIC_FILES_CHKSUM variable section</link></para>
|
||||||
</glossdef>
|
</glossdef>
|
||||||
</glossentry>
|
</glossentry>
|
||||||
|
|
||||||
|
|
|
@ -187,6 +187,10 @@
|
||||||
<title>Recipe Variables - Extra Build Information</title>
|
<title>Recipe Variables - Extra Build Information</title>
|
||||||
|
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para><glossterm><link
|
||||||
|
linkend='var-DISTRO_PN_ALIAS'>DISTRO_PN_ALIAS</link></glossterm></para>
|
||||||
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para><glossterm><link linkend='var-EXTRA_OECONF'>EXTRA_OECONF</link></glossterm></para>
|
<para><glossterm><link linkend='var-EXTRA_OECONF'>EXTRA_OECONF</link></glossterm></para>
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
Loading…
Reference in New Issue