diff options
Diffstat (limited to 'documentation/ref-manual/migration.xml')
-rw-r--r-- | documentation/ref-manual/migration.xml | 224 |
1 files changed, 224 insertions, 0 deletions
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml index c648d8d442..1b902914bc 100644 --- a/documentation/ref-manual/migration.xml +++ b/documentation/ref-manual/migration.xml @@ -6325,6 +6325,230 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>. </para> </section> </section> + +<section id='moving-to-the-yocto-project-2.7-release'> + <title>Moving to the Yocto Project 2.7 Release</title> + + <para> + This section provides migration information for moving to the + Yocto Project 2.7 Release from the prior release. + </para> + + <section id='migration-2.7-bitbake-changes'> + <title>BitBake Changes</title> + + <para> + The following changes have been made to BitBake: + <itemizedlist> + <listitem><para> + The BBHandler now checks tab indentation for Python code. + </para></listitem> + <listitem><para> + Bitbake now checks + <link linkend='var-BBFILE_COLLECTIONS'><filename>BBFILE_COLLECTIONS</filename></link> + for duplicate entries and triggers an error if any are + found. + </para></listitem> + </itemizedlist> + </para> + </section> + + <section id='migration-2.7-qemu-native-splits-system-and-user-mode-parts'> + <title><filename>qemu-native</filename> Splits the System and User-Mode Parts</title> + + <para> + The system and user-mode parts of <filename>qemu-native</filename> + are now split. + <filename>qemu-native</filename> provides the user-mode components + and <filename>qemu-system-native</filename> provides the system + components. + If you have recipes that depend on QEMU's system emulation + functionality at build time, they should now depend upon + <filename>qemu-system-native</filename> instead of + <filename>qemu-native</filename>. + </para> + </section> + + <section id='migration-2.7-upstream-tracking.inc-removed'> + <title>The <filename>upstream-tracking.inc</filename> File Has Been Removed</title> + + <para> + The previously deprecated <filename>upstream-tracking.inc</filename> + file is now removed. + Any <filename>UPSTREAM_TRACKING*</filename> variables are now set + in the corresponding recipes instead. + </para> + + <para> + Remove any references you have to the + <filename>upstream-tracking.inc</filename> file in your + configuration. + </para> + </section> + + <section id='migration-2.7-distro-features-libc-removed'> + <title>The <filename>DISTRO_FEATURES_LIBC</filename> Variable Has Been Removed</title> + + <para> + The <filename>DISTRO_FEATURES_LIBC</filename> variable is no + longer used. + The ability to configure glibc using kconfig has been removed + for quite some time making the <filename>libc-*</filename> features + set no longer effective. + </para> + + <para> + Remove any references you have to + <filename>DISTRO_FEATURES_LIBC</filename> in your own layers. + </para> + </section> + + <section id='migration-2.7-packaging-changes'> + <title>Packaging Changes</title> + + <para> + This section provides information about packaging changes. + <itemizedlist> + <listitem><para> + <filename>bind</filename>: The + <filename>nsupdate</filename> binary has been moved to + the <filename>bind-utils</filename> package. + </para></listitem> + <listitem><para> + Debug split: The default debug split has been changed to + create separate source packages. + </para></listitem> + <listitem><para> + <filename>util-linux</filename>: + <itemizedlist> + <listitem><para> + <filename>blkdiscard</filename> has been split out + into own package. + </para></listitem> + <listitem><para> + one package per binary (pt 1: + <filename>base_sbindir</filename>) + </para></listitem> + <listitem><para> + one package per binary (pt 2: + <filename>base_bindir</filename>) + </para></listitem> + <listitem><para> + one package per binary (pt 3: + <filename>sbindir</filename>) + </para></listitem> + <listitem><para> + one package per binary (pt 4: + <filename>bindir</filename>) + </para></listitem> + <listitem><para> + <filename>/etc/default/mountall</filename> has + moved into the -mount sub-package. + </para></listitem> + </itemizedlist> + </para></listitem> + <listitem><para> + <filename>netbase/base-files</filename>: + <filename>/etc/hosts</filename> has moved from + <filename>netbase</filename> to + <filename>base-files</filename>. + </para></listitem> + <listitem><para> + <filename>tzdata</filename>: The main package has been + converted to an empty meta package that pulls in all + <filename>tzdata</filename> packages by default. + </para></listitem> + <listitem><para> + <filename>lrzsz</filename>: This package has been removed + from <filename>packagegroup-self-hosted</filename> and + <filename>packagegroup-core-tools-testapps</filename>. + The X/Y/ZModem support is less likely to be needed on + modern systems. + If you are relying on these packagegroups to include the + <filename>lrzsz</filename> package in your image, you + now need to explicitly add the package. + </para></listitem> + </itemizedlist> + </para> + </section> + + <section id='migration-2.7-removed-recipes'> + <title>Removed Recipes</title> + + <para> + The following recipes have been removed: + <literallayout class='monospaced'> + gcc: Drop version 7.3 recipes. Version 8.3 now remains. + linux-yocto: Drop versions 4.14 and 4.18 recipes. Versions 4.19 and 5.0 remain. + go: Drop version 1.9 recipes. Versions 1.11 and 1.12 remain. + xvideo-tests: Became obsolete. + libart-lgpl: Became obsolete. + gtk-icon-utils-native: These tools are now provided by gtk+3-native + gcc-cross-initial: No longer needed. gcc-cross/gcc-crosssdk are now used. + gcc-crosssdk-initial: No longer needed. gcc-cross/gcc-crosssdk are now used. + glibc-initial: Removed because the benefits of having it for site_config are + currently outweighed by the cost of building the recipe. + </literallayout> + </para> + </section> + + <section id='migration-2.7-removed-classes'> + <title>Removed Classes</title> + + <para> + The following classes have been removed: + <literallayout class='monospaced'> + distutils-tools: This class was never used. + bugzilla.bbclass: Became obsolete. + distrodata: This functionally has been replaced by a more modern + tinfoil-based implementation. + </literallayout> + </para> + </section> + + <section id='migration-2.7-miscellaneous-changes'> + <title>Miscellaneous Changes</title> + + <para> + The following miscellaneous changes occurred: + <itemizedlist> + <listitem><para> + The <filename>distro</filename> subdirectory of the Poky + repository has been removed from the top-level + <filename>scripts</filename> directory. + </para></listitem> + <listitem><para> + Perl added a version that builds recipes using + <filename>perl-cross</filename> + </para></listitem> + <listitem><para> + <filename>arm-tunes</filename>: Removed the "-march" + option if mcpu is already added. + </para></listitem> + <listitem><para> + <filename>update-alternatives</filename>: Convert file + renames to + <link linkend='var-PACKAGE_PREPROCESS_FUNCS'><filename>PACKAGE_PREPROCESS_FUNCS</filename></link> + </para></listitem> + <listitem><para> + <filename>base/pixbufcache</filename>: Obsolete + <filename>sstatecompletions</filename> code has been + removed. + </para></listitem> + <listitem><para> + <link linkend='ref-classes-native'><filename>native</filename></link> + class: + <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link> + handling has been enabled. + </para></listitem> + <listitem><para> + <filename>inetutils</filename>: This recipe has rsh + disabled. + </para></listitem> + </itemizedlist> + </para> + </section> +</section> </chapter> <!-- vim: expandtab tw=80 ts=4 |