diff options
| author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2015-01-21 11:45:26 -0800 |
|---|---|---|
| committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2015-02-17 15:16:53 +0000 |
| commit | 44ddc355ef25a7bf1c0ababab9f22db7e20ddb04 (patch) | |
| tree | 8839a32f2b1aa934926cc623a53776c9438762a5 /documentation/dev-manual | |
| parent | db874ed595fcfc7d7b078fb89a53d40747a32c72 (diff) | |
| download | poky-44ddc355ef25a7bf1c0ababab9f22db7e20ddb04.tar.gz | |
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>
Diffstat (limited to 'documentation/dev-manual')
| -rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 50 |
1 files changed, 0 insertions, 50 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 8ce303c6d5..f2184d09f3 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml | |||
| @@ -6204,9 +6204,6 @@ | |||
| 6204 | <link linkend='incrementing-a-package-revision-number'>Incrementing a package revision number</link> | 6204 | <link linkend='incrementing-a-package-revision-number'>Incrementing a package revision number</link> |
| 6205 | </para></listitem> | 6205 | </para></listitem> |
| 6206 | <listitem><para> | 6206 | <listitem><para> |
| 6207 | <link linkend='usingpoky-configuring-DISTRO_PN_ALIAS'>Handling a package name alias</link> | ||
| 6208 | </para></listitem> | ||
| 6209 | <listitem><para> | ||
| 6210 | <link linkend='handling-optional-module-packaging'>Handling optional module packaging</link> | 6207 | <link linkend='handling-optional-module-packaging'>Handling optional module packaging</link> |
| 6211 | </para></listitem> | 6208 | </para></listitem> |
| 6212 | <listitem><para> | 6209 | <listitem><para> |
| @@ -6492,53 +6489,6 @@ | |||
| 6492 | </section> | 6489 | </section> |
| 6493 | </section> | 6490 | </section> |
| 6494 | 6491 | ||
| 6495 | <section id="usingpoky-configuring-DISTRO_PN_ALIAS"> | ||
| 6496 | <title>Handling a Package Name Alias</title> | ||
| 6497 | <para> | ||
| 6498 | Sometimes a package name you are using might exist under | ||
| 6499 | an alias or as a similarly named package in a different | ||
| 6500 | distribution. | ||
| 6501 | The OpenEmbedded build system implements a | ||
| 6502 | <filename>do_distro_check</filename> | ||
| 6503 | task that automatically connects to major distributions | ||
| 6504 | and checks for these situations. | ||
| 6505 | If the package exists under a different name in a different | ||
| 6506 | distribution, you get a <filename>distro_check</filename> | ||
| 6507 | mismatch. | ||
| 6508 | You can resolve this problem by defining a per-distro recipe | ||
| 6509 | name alias using the | ||
| 6510 | <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_PN_ALIAS'>DISTRO_PN_ALIAS</ulink></filename> | ||
| 6511 | variable. | ||
| 6512 | </para> | ||
| 6513 | |||
| 6514 | <para> | ||
| 6515 | Following is an example that shows how you specify the <filename>DISTRO_PN_ALIAS</filename> | ||
| 6516 | variable: | ||
| 6517 | <literallayout class='monospaced'> | ||
| 6518 | DISTRO_PN_ALIAS_pn-PACKAGENAME = "distro1=package_name_alias1 \ | ||
| 6519 | distro2=package_name_alias2 \ | ||
| 6520 | distro3=package_name_alias3 \ | ||
| 6521 | ..." | ||
| 6522 | </literallayout> | ||
| 6523 | </para> | ||
| 6524 | |||
| 6525 | <para> | ||
| 6526 | If you have more than one distribution alias, separate them with a space. | ||
| 6527 | Note that the build system currently automatically checks the | ||
| 6528 | Fedora, OpenSUSE, Debian, Ubuntu, | ||
| 6529 | and Mandriva distributions for source package recipes without having to specify them | ||
| 6530 | using the <filename>DISTRO_PN_ALIAS</filename> variable. | ||
| 6531 | For example, the following command generates a report that lists the Linux distributions | ||
| 6532 | that include the sources for each of the recipes. | ||
| 6533 | <literallayout class='monospaced'> | ||
| 6534 | $ bitbake world -f -c distro_check | ||
| 6535 | </literallayout> | ||
| 6536 | The results are stored in the <filename>build/tmp/log/distro_check-${DATETIME}.results</filename> | ||
| 6537 | file found in the | ||
| 6538 | <link linkend='source-directory'>Source Directory</link>. | ||
| 6539 | </para> | ||
| 6540 | </section> | ||
| 6541 | |||
| 6542 | <section id='handling-optional-module-packaging'> | 6492 | <section id='handling-optional-module-packaging'> |
| 6543 | <title>Handling Optional Module Packaging</title> | 6493 | <title>Handling Optional Module Packaging</title> |
| 6544 | 6494 | ||
