From bd4438f4a4c945458fa9e373d0fe51886af8f49c Mon Sep 17 00:00:00 2001 From: Kristi Rifenbark Date: Fri, 18 May 2018 11:32:42 -0700 Subject: ref-manual: Finalized edits on the 2.5 Migration section (From yocto-docs rev: 54259a4d4d69be73e7c614baa2a8d87faa2e3ea5) Signed-off-by: Kristi Rifenbark Signed-off-by: Richard Purdie --- documentation/ref-manual/migration.xml | 196 +++++++++++++++------------------ 1 file changed, 88 insertions(+), 108 deletions(-) (limited to 'documentation/ref-manual') diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml index a4b3aede32..b060968000 100644 --- a/documentation/ref-manual/migration.xml +++ b/documentation/ref-manual/migration.xml @@ -5250,8 +5250,8 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message. libfm-gtk: - The libfm gtkpackage and bindings are - split into a separate libfm-gtk package. + The libfm GTK+ bindings are split into + a separate libfm-gtk package. flex-libfl: @@ -5274,10 +5274,11 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message. grub-efi recipe. - ARMv7-A Legacy Support: - Legacy support is removed for transitioning from ARMv7-A - to armv7a-vfp-neon in package feeds, which was previously - enabled by setting + armv7a Legacy Package Feed Support: + Legacy support is removed for transitioning from + armv7a to + armv7a-vfp-neon in package feeds, + which was previously enabled by setting PKGARCHCOMPAT_ARMV7A. This transition occurred in 2011 and active package feeds should by now be updated to the new naming. @@ -5303,7 +5304,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message. hostap-utils: - This recipe is obsolete. + This software package is obsolete. latencytop: @@ -5322,12 +5323,12 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message. man: - This recipe has been replaced by - modern man-db + This recipe has been replaced by modern + man-db mkelfimage: - This recipe has been removed in the upstream coreboot, + This tool has been removed in the upstream coreboot project, and is no longer needed with the removal of the ELF image type. @@ -5337,25 +5338,24 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message. neon: - This recipe is not maintained upstream and is not used by - anything in OpenEmbedded-Core. + This software package is no longer maintained upstream and + is no longer needed by anything in OpenEmbedded-Core. oprofile: The functionality of this recipe is replaced by - perf since keeping ongoing - compatibility on with musl is + perf and keeping compatibility on + an ongoing basis with musl is difficult. pax: - This recipe is obsolete. + This software package is obsolete. stat: - This recipe is not maintained upstream. - coreutils provides a modern binary for - the stat recipe. + This software package is not maintained upstream. + coreutils provides a modern stat binary. zisofs-tools-native: @@ -5410,8 +5410,8 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message. scripts/test-dependencies.sh script: The script is largely made obsolete by the - recipe-specific sysroots - functionality introduced in the previous release. + recipe-specific sysroots functionality introduced in the + previous release. @@ -5428,11 +5428,13 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message. There are two different behaviors people might want: + Behavior A: For a given target (or set of targets) look through the task graph and run task X only if it is present and will be built. + Behavior B: For a given target (or set of targets) look through the task graph and run task X if any recipe in the taskgraph has such a target, even if it is not in @@ -5440,11 +5442,11 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message. The --runall option now performs - list item (b) mentioned in the previous bullet point. - Previously --runall behaved like list - item (a) mentioned in the previous bullet point. - A --runonly option now exists to - retain the ability to perform list item (a). + "Behavior B". + Previously --runall behaved like + "Behavior A". + A --runonly option has been added to + retain the ability to perform "Behavior A". Several explicit "run this task for all recipes in the @@ -5468,6 +5470,44 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message. +
+ Python and Python 3 Changes + + + The following are auto-packaging changes to Python and Python 3: + + + The script-managed python-*-manifest.inc files + that were previously used to generate Python and Python 3 + packages have been replaced with a JSON-based file that is + easier to read and maintain. + A new task is available for maintainers of the Python recipes to + update the JSON file when upgrading to new Python versions. + You can now edit the file directly instead of having to edit a + script and run it to update the file. + + + One particular change to note is that the Python recipes no longer + have build-time provides for their packages. + This assumes python-foo is one of the packages + provided by the Python recipe. + You can no longer run bitbake python-foo or + have a DEPENDS on + python-foo, but doing either of the following + causes the package to work as expected: + + IMAGE_INSTALL_append = " python-foo" + + or + + RDEPENDS_${PN} = "python-foo" + + The earlier build-time provides behavior was a quirk of the way the + Python manifest file was created. + For more information on this change please see + this commit. + +
Miscellaneous Changes @@ -5526,94 +5566,33 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message. OECMAKE_GENERATOR = "Unix Makefiles" to change back to make. - - python: - This command restructures - Python packaging and replaces it with autopackaging. - - - python3: - This command restructures Python3 packaging and replaces it - with autopackaging. - The previously deprecated base_* functions have been removed in favor of their replacements in meta/lib/oe and bitbake/lib/bb. These are typically used from recipes and classes. - Any references to the old functions should be updated. - The following is a full list, along with each of their + Any references to the old functions must be updated. + The following table shows the removed functions and their replacements: - - - base_path_join() - is replaced by - oe.path.join(). - - - base_path_relative() - is replaced by - oe.path.relative(). - - - base_path_out() - is replaced by - oe.path.format_display(). - - - base_read_file() - is replaced by - oe.utils.read_file(). - - - base_ifelse() - is replaced by - oe.utils.ifelse(). - - - base_conditional() - is replaced by - oe.utils.conditional(). - - - base_less_or_equal() - is replaced by - oe.utils.less_or_equal(). - - - base_version_less_or_equal() - is replaced by - oe.utils.version_less_or_equal(). - - - base_contains() - is replaced by - bb.utils.contains(). - - - base_both_contain() - is replaced by - oe.utils.both_contain(). - - - base_prune_suffix() - is replaced by - oe.utils.prune_suffix(). - - - oe_filter() - is replaced by - oe.utils.str_filter(). - - - oe_filter_out() - is replaced by - oe.utils.str_filter_out() - (or use the _remove - operator). - - + + + Removed Replacement + ============================ ============================ + base_path_join() oe.path.join() + base_path_relative() oe.path.relative() + base_path_out() oe.path.format_display() + base_read_file() oe.utils.read_file() + base_ifelse() oe.utils.ifelse() + base_conditional() oe.utils.conditional() + base_less_or_equal() oe.utils.less_or_equal() + base_version_less_or_equal() oe.utils.version_less_or_equal() + base_contains() bb.utils.contains() + base_both_contain() oe.utils.both_contain() + base_prune_suffix() oe.utils.prune_suffix() + oe_filter() oe.utils.str_filter() + oe_filter_out() oe.utils.str_filter_out() (or use the _remove operator). + Using exit 1 to explicitly defer a @@ -5647,7 +5626,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message. unmaintained and squashfs provides better performance and compression. In order to build a live image with squashfs+lz4 compression - enabled you set + enabled you should now set LIVE_ROOTFS_TYPE = "squashfs-lz4" and ensure that live is in IMAGE_FSTYPES. @@ -5687,7 +5666,8 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message. LAYERSERIES_COMPAT_layername, a warning will is shown. If a layer sets a value that does not include the current - version, then an error is be produced. + version ("sumo" for the 2.5 release), then an error will be + produced. The TZ environment variable is set to -- cgit v1.2.3-54-g00ecf