ref-manual: Inserted Migration 2.7 section.

(From yocto-docs rev: 238ddd62995420741c2b97ccfa7d2c533b72837c)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2019-04-29 15:07:30 -07:00
committed by Richard Purdie
parent 5bc2625be5
commit 9bd52d6b2e

View File

@@ -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