ref-manual, dev-manual: Removed information about package name alias.
The section on "Handling a Package Name Alias" was confusing and wrong. We decided to eliminate it. The section was removed from the dev-manual. The corresponding variable DISTRO_PN_ALIAS remains for now but without the cross-reference link to the now missing section. Reported-by: Robert P. J. Day <rpjday@crashcourse.ca> (From yocto-docs rev: 9938cdcc8488baffa4252288bf45243055e76fed) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
parent
db874ed595
commit
44ddc355ef
|
@ -6203,9 +6203,6 @@
|
|||
<listitem><para>
|
||||
<link linkend='incrementing-a-package-revision-number'>Incrementing a package revision number</link>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<link linkend='usingpoky-configuring-DISTRO_PN_ALIAS'>Handling a package name alias</link>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<link linkend='handling-optional-module-packaging'>Handling optional module packaging</link>
|
||||
</para></listitem>
|
||||
|
@ -6492,53 +6489,6 @@
|
|||
</section>
|
||||
</section>
|
||||
|
||||
<section id="usingpoky-configuring-DISTRO_PN_ALIAS">
|
||||
<title>Handling a Package Name Alias</title>
|
||||
<para>
|
||||
Sometimes a package name you are using might exist under
|
||||
an alias or as a similarly named package in a different
|
||||
distribution.
|
||||
The OpenEmbedded build system implements a
|
||||
<filename>do_distro_check</filename>
|
||||
task that automatically connects to major distributions
|
||||
and checks for these situations.
|
||||
If the package exists under a different name in a different
|
||||
distribution, you get a <filename>distro_check</filename>
|
||||
mismatch.
|
||||
You can resolve this problem by defining a per-distro recipe
|
||||
name alias using the
|
||||
<filename><ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_PN_ALIAS'>DISTRO_PN_ALIAS</ulink></filename>
|
||||
variable.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Following is an example that shows how you specify the <filename>DISTRO_PN_ALIAS</filename>
|
||||
variable:
|
||||
<literallayout class='monospaced'>
|
||||
DISTRO_PN_ALIAS_pn-PACKAGENAME = "distro1=package_name_alias1 \
|
||||
distro2=package_name_alias2 \
|
||||
distro3=package_name_alias3 \
|
||||
..."
|
||||
</literallayout>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
If you have more than one distribution alias, separate them with a space.
|
||||
Note that the build system currently automatically checks the
|
||||
Fedora, OpenSUSE, Debian, Ubuntu,
|
||||
and Mandriva distributions for source package recipes without having to specify them
|
||||
using the <filename>DISTRO_PN_ALIAS</filename> variable.
|
||||
For example, the following command generates a report that lists the Linux distributions
|
||||
that include the sources for each of the recipes.
|
||||
<literallayout class='monospaced'>
|
||||
$ bitbake world -f -c distro_check
|
||||
</literallayout>
|
||||
The results are stored in the <filename>build/tmp/log/distro_check-${DATETIME}.results</filename>
|
||||
file found in the
|
||||
<link linkend='source-directory'>Source Directory</link>.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id='handling-optional-module-packaging'>
|
||||
<title>Handling Optional Module Packaging</title>
|
||||
|
||||
|
|
|
@ -2740,10 +2740,6 @@
|
|||
</info>
|
||||
<glossdef>
|
||||
<para>Alias names used for the recipe in various Linux distributions.</para>
|
||||
<para>See the
|
||||
"<ulink url='&YOCTO_DOCS_DEV_URL;#usingpoky-configuring-DISTRO_PN_ALIAS'>Handling
|
||||
a Package Name Alias</ulink>" section in the Yocto Project Development
|
||||
Manual for more information.</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
|
||||
|
|
Loading…
Reference in New Issue