From a8a0e805bb41c00f731fedeac33ff2f2c3ad542a Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 4 Apr 2014 16:43:53 -0700 Subject: ref-manual: Edits to the 1.6 migration section. Applied review comments from Paul Eggleton to the section on migrating to the 1.6 version of YP. (From yocto-docs rev: ffd224a16cef4d643cc2c527ad8dc5e15d715faa) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/ref-manual/migration.xml | 112 ++++++++++++++++++++++----------- 1 file changed, 74 insertions(+), 38 deletions(-) (limited to 'documentation/ref-manual') diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml index dd5f16017e..9dc0e131d7 100644 --- a/documentation/ref-manual/migration.xml +++ b/documentation/ref-manual/migration.xml @@ -1145,15 +1145,15 @@ Python Definition substitutions - had some previously deprecated Python definitions within - its bb module removed. + BitBake had some previously deprecated Python definitions + within its bb module removed. You should use their sub-module counterparts instead: bb.MalformedUrl: Use bb.fetch.MalformedUrl. - bb.encodeurl: - Use bb.fetch: encodeurl. + bb.fetch.encodeurl: + Use bb.fetch.encodeurl. bb.decodeurl: Use bb.fetch.decodeurl @@ -1187,6 +1187,20 @@ The SVK fetcher has been removed from BitBake. + +
+ <filename>task-<taskname></filename> Overrides + + + task-<taskname> overrides have been + adjusted so that tasks whose names contain underscores have the + underscores replaced by hyphens for the override so that they + now function properly. + For example, the task override for + do_populate_sdk is + task-populate-sdk. + +
@@ -1210,12 +1224,9 @@ - The check for this does not occur on startup. + The check for this occurs on startup. If TMPDIR is detected on an NFS mount, an error occurs. - For more information on this restriction, see the - TMPDIR description in the - "Variables Glossary".
@@ -1305,14 +1316,14 @@ Separate build and source directories have been enabled by default for selected recipes where it is known to work - (a whitelist) and for when using the + (a whitelist) and for all recipes that inherit the cmake class. In future releases the autotools class will enable a separate build directory by default as well. - Recipes building autotools-based + Recipes building Autotools-based software that fails to build with a separate build directory should be changed to inherit from the autotools-brokensep @@ -1327,16 +1338,17 @@ qemu-native now builds without SDL-based graphical output support by default. The following additional lines are needed in your - local.conf to enable it. - Remove the comments from the following two lines when you - need to build a headless server: + local.conf to enable it: PACKAGECONFIG_pn-qemu-native = "sdl" ASSUME_PROVIDED += "libsdl-native" The default local.conf - contains these statements as comments. + contains these statements. + Consequently, if you are building a headless system and using + a default local.conf file, you will need + comment these two lines out. @@ -1363,6 +1375,10 @@ The top-level LICENSE file has been changed to better describe the license of the various components of OE-Core. + However, the licensing itself remains unchanged. + + + Normally, this change would not cause any side-effects. However, some recipes point to this file within LIC_FILES_CHKSUM @@ -1370,6 +1386,11 @@ accompanying checksum must be changed from 3f40d7994397109285ec7b81fdeb3b58 to 4d92cd373abda3937c2bc47fbc49d690. + A better alternative is to have + LIC_FILES_CHKSUM point to a file + describing the license that is distributed with the source + that the recipe is building, if possible, rather than pointing + to ${COREBASE}/LICENSE. @@ -1380,19 +1401,20 @@ The "-fpermissive" option has been removed from the default CFLAGS value. - Individual recipes that fail to build without it should either - be patched to fix the issues reported by the compiler. - Alternatively, you can add "-fpermissive" to - CFLAGS in the recipe. + You need to take action on individual recipes that fail when + building with this option. + You need to either patch the recipes to fix the issues reported by + the compiler, or you to add "-fpermissive" to + CFLAGS in the recipes.
- Custom Images + Custom Image Output Types Custom image output types, as selected using - IMAGE_TYPES, + IMAGE_FSTYPES, must declare their dependencies on other image types (if any) using a new IMAGE_TYPEDEP @@ -1401,7 +1423,7 @@
- Task Recipes + Tasks The do_package_write task has been removed. @@ -1430,21 +1452,7 @@ The virtclass overrides are now deprecated. Use the equivalent class overrides instead (e.g. virtclass-native becomes - class-native. - -
- -
- <filename>task-<taskname></filename> Overrides - - - task-<taskname> overrides have been - adjusted so that tasks whose names contain underscores have the - underscores replaced by hyphens for the override so that they - now function properly. - For example, the task override for - do_populate_sdk is - task-populate-sdk. + class-native.)
@@ -1468,10 +1476,11 @@ cryptodev-linux. genext2fs - - This upstream is no longer needed or maintained. + genext2fs is no longer used by the + build system and is unmaintained upstream. js - - This supported an ancient version of Mozilla's javascript + This provided an ancient version of Mozilla's javascript engine that is no longer needed. zaurusd - @@ -1524,6 +1533,33 @@ + +
+ Reference Board Support Packages (BSPs) + + + The following reference BSPs changes occurred: + + The BeagleBoard + (beagleboard) ARM reference hardware + has been replaced by the BeagleBone + (beaglebone) hardware. + + The RouterStation Pro + (routerstationpro) MIPS reference + hardware has been replaced by the EdgeRouter Lite + (edgerouter) hardware. + + + The previous reference BSPs for the + beagleboard and + routerstationpro machines are still available + in a new meta-yocto-bsp-old layer in the + Source Repositories + at + http://git.yoctoproject.org/cgit/cgit.cgi/meta-yocto-bsp-old/. + +