diff options
Diffstat (limited to 'documentation/ref-manual/ref-variables.xml')
-rw-r--r-- | documentation/ref-manual/ref-variables.xml | 75 |
1 files changed, 74 insertions, 1 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 7b88ffe5ca..099846412b 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml | |||
@@ -1727,7 +1727,7 @@ Core layer for images cannot be removed | |||
1727 | <glossentry id='var-IMAGE_FSTYPES'><glossterm>IMAGE_FSTYPES</glossterm> | 1727 | <glossentry id='var-IMAGE_FSTYPES'><glossterm>IMAGE_FSTYPES</glossterm> |
1728 | <glossdef> | 1728 | <glossdef> |
1729 | <para> | 1729 | <para> |
1730 | Specifes the format of the root filesystem created by | 1730 | Specifies the format of the root filesystem created by |
1731 | the OpenEmbedded build system. | 1731 | the OpenEmbedded build system. |
1732 | Available formats are a subset of the | 1732 | Available formats are a subset of the |
1733 | supported images listed in | 1733 | supported images listed in |
@@ -2009,6 +2009,33 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
2009 | </glossdef> | 2009 | </glossdef> |
2010 | </glossentry> | 2010 | </glossentry> |
2011 | 2011 | ||
2012 | <glossentry id='var-INCOMPATIBLE_LICENSE'><glossterm>INCOMPATIBLE_LICENSE</glossterm> | ||
2013 | <glossdef> | ||
2014 | <para> | ||
2015 | Specifies a space-separated list of license names | ||
2016 | (as they would appear in | ||
2017 | <link linkend='var-LICENSE'><filename>LICENSE</filename></link>) | ||
2018 | that should be excluded from the build. | ||
2019 | Recipes that provide no alternatives to listed incompatible | ||
2020 | licenses are not built. | ||
2021 | Packages that are individually licensed with the specified | ||
2022 | incompatible licenses will be deleted. | ||
2023 | </para> | ||
2024 | |||
2025 | <note> | ||
2026 | This functionality is only regularly tested using | ||
2027 | the following setting: | ||
2028 | <literallayout class='monospaced'> | ||
2029 | INCOMPATIBLE_LICENSE = "GPLv3" | ||
2030 | </literallayout> | ||
2031 | Although you can use other settings, you might be required | ||
2032 | to remove dependencies on or provide alternatives to | ||
2033 | components that are required to produce a functional system | ||
2034 | image. | ||
2035 | </note> | ||
2036 | </glossdef> | ||
2037 | </glossentry> | ||
2038 | |||
2012 | <glossentry id='var-INHIBIT_DEFAULT_DEPS'><glossterm>INHIBIT_DEFAULT_DEPS</glossterm> | 2039 | <glossentry id='var-INHIBIT_DEFAULT_DEPS'><glossterm>INHIBIT_DEFAULT_DEPS</glossterm> |
2013 | <glossdef> | 2040 | <glossdef> |
2014 | <para> | 2041 | <para> |
@@ -2583,6 +2610,21 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
2583 | The final example is from <filename>sysstat</filename>, | 2610 | The final example is from <filename>sysstat</filename>, |
2584 | which presents a single license. | 2611 | which presents a single license. |
2585 | </para> | 2612 | </para> |
2613 | |||
2614 | <para> | ||
2615 | You can also specify licenses on a per-package basis to | ||
2616 | handle situations where components of the output have | ||
2617 | different licenses. | ||
2618 | For example, a piece of software whose code is | ||
2619 | licensed under GPLv2 but has accompanying documentation | ||
2620 | licensed under the GNU Free Documentation License 1.2 could | ||
2621 | be specified as follows: | ||
2622 | <literallayout class='monospaced'> | ||
2623 | LICENSE = "GFDL-1.2 & GPLv2" | ||
2624 | LICENSE_${PN} = "GPLv2" | ||
2625 | LICENSE_${PN}-doc = "GFDL-1.2" | ||
2626 | </literallayout> | ||
2627 | </para> | ||
2586 | </glossdef> | 2628 | </glossdef> |
2587 | </glossentry> | 2629 | </glossentry> |
2588 | 2630 | ||
@@ -3417,6 +3459,37 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
3417 | </glossdef> | 3459 | </glossdef> |
3418 | </glossentry> | 3460 | </glossentry> |
3419 | 3461 | ||
3462 | <glossentry id='var-PKGD'><glossterm>PKGD</glossterm> | ||
3463 | <glossdef> | ||
3464 | <para> | ||
3465 | Points to the destination directory for files to be | ||
3466 | packaged before they are split into individual packages. | ||
3467 | This directory defaults to the following: | ||
3468 | <literallayout class='monospaced'> | ||
3469 | ${WORKDIR}/package | ||
3470 | </literallayout> | ||
3471 | Do not change this default. | ||
3472 | </para> | ||
3473 | </glossdef> | ||
3474 | </glossentry> | ||
3475 | |||
3476 | <glossentry id='var-PKGDEST'><glossterm>PKGDEST</glossterm> | ||
3477 | <glossdef> | ||
3478 | <para> | ||
3479 | Points to the parent directory for files to be packaged | ||
3480 | after they have been split into individual packages. | ||
3481 | This directory defaults to the following: | ||
3482 | <literallayout class='monospaced'> | ||
3483 | ${WORKDIR}/packages-split | ||
3484 | </literallayout> | ||
3485 | Under this default directory, the build system creates | ||
3486 | directories for each package specified in | ||
3487 | <link linkend='var-PACKAGES'><filename>PACKAGES</filename></link>. | ||
3488 | Do not change this default. | ||
3489 | </para> | ||
3490 | </glossdef> | ||
3491 | </glossentry> | ||
3492 | |||
3420 | <glossentry id='var-PN'><glossterm>PN</glossterm> | 3493 | <glossentry id='var-PN'><glossterm>PN</glossterm> |
3421 | <glossdef> | 3494 | <glossdef> |
3422 | <para>This variable can have two separate functions depending on the context: a recipe | 3495 | <para>This variable can have two separate functions depending on the context: a recipe |