summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/migration.xml
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2014-04-01 15:19:37 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-04-04 15:20:16 +0100
commit89e4e722ce784d9acd593cfc5b48583be1f4b8a7 (patch)
tree98ca56c04309b31f6d3cfeb8ca76a515d4002e3f /documentation/ref-manual/migration.xml
parent583b6a45273e1c71ce39427b670612550612bc70 (diff)
downloadpoky-89e4e722ce784d9acd593cfc5b48583be1f4b8a7.tar.gz
poky-89e4e722ce784d9acd593cfc5b48583be1f4b8a7.tar.bz2
poky-89e4e722ce784d9acd593cfc5b48583be1f4b8a7.zip
ref-manual: Added the migration section for 1.6.
This commit is really only 1/2 of the section (the final half). I put in the first half in a previous commit and pushed it before realizing those changes were in that commit. The commit that the first half of the migration changes are in is 88a075e6306349e5f8c0d53b5288ef1e64956cd3. (From yocto-docs rev: 8f94391f86ee9643256979332fa06541fb8b16f7) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual/migration.xml')
-rw-r--r--documentation/ref-manual/migration.xml241
1 files changed, 200 insertions, 41 deletions
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index 345332dda6..dd5f16017e 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -1092,19 +1092,44 @@
Yocto Project 1.6 Release from the prior release.
</para>
- <section id='migration-1.6-host-dependency-changes'>
- <title>Host Dependency Changes</title>
+
+ <section id='migration-1.6-archiver-class'>
+ <title><filename>archiver</filename> Class</title>
<para>
- Sample section.
+ The
+ <link linkend='ref-classes-archiver'><filename>archiver</filename></link>
+ class has been rewritten and its configuration has been simplified.
+ For more details on the source archiver, see the
+ "<ulink url='&YOCTO_DOCS_DEV_URL;#maintaining-open-source-license-compliance-during-your-products-lifecycle'>Maintaining Open Source License Compliance During Your Product's Lifecycle</ulink>"
+ section in the Yocto Project Development Manual.
</para>
</section>
- <section id='migration-1.6-atom-pc-bsp'>
- <title><filename>atom-pc</filename> Board Support Package (BSP)</title>
+ <section id='migration-1.6-packaging-changes'>
+ <title>Packaging Changes</title>
<para>
- Sample section.
+ The following packaging changes have been made:
+ <itemizedlist>
+ <listitem><para>
+ The <filename>binutils</filename> recipe no longer produces
+ a <filename>binutils-symlinks</filename> package.
+ <filename>update-alternatives</filename> is now used to
+ handle the preferred <filename>binutils</filename>
+ variant on the target instead.
+ </para></listitem>
+ <listitem><para>
+ The tc (traffic control) utilities have been split out of
+ the main <filename>iproute2</filename> package and put
+ into the <filename>iproute2-tc</filename> package.
+ </para></listitem>
+ <listitem><para>
+ The <filename>gtk-engines</filename> schemas have been
+ moved to a dedicated
+ <filename>gtk-engines-schemas</filename> package.
+ </para></listitem>
+ </itemizedlist>
</para>
</section>
@@ -1266,87 +1291,160 @@
<title>Directory Layout Changes</title>
<para>
- Sample section.
+ The <filename>meta-hob</filename> layer has been removed from
+ the top-level of the
+ <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>.
+ The contents of this layer are no longer needed by the Hob
+ user interface for building images and toolchains.
</para>
</section>
- <section id='migration-1.6-shortened-git-srcrev-values'>
- <title>Shortened Git <filename>SRCREV</filename> Values</title>
+ <section id='migration-1.6-build-changes'>
+ <title>Build Changes</title>
<para>
- Sample section.
+ 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
+ <link linkend='ref-classes-cmake'><filename>cmake</filename></link>
+ class.
+ In future releases the
+ <link linkend='ref-classes-autotools'><filename>autotools</filename></link>
+ class will enable a separate build directory by default as
+ well.
+ Recipes building <filename>autotools-based</filename>
+ software that fails to build with a separate build directory
+ should be changed to inherit from the
+ <link linkend='ref-classes-autotools-brokensep'><filename>autotools-brokensep</filename></link>
+ class instead of the <filename>autotools</filename> class.
</para>
</section>
- <section id='migration-1.6-image-features'>
- <title><filename>IMAGE_FEATURES</filename></title>
+ <section id='migration-1.6-building-qemu-native'>
+ <title><filename>qemu-native</filename></title>
<para>
- Sample section.
+ <filename>qemu-native</filename> now builds without
+ SDL-based graphical output support by default.
+ The following additional lines are needed in your
+ <filename>local.conf</filename> to enable it.
+ Remove the comments from the following two lines when you
+ need to build a headless server:
+ <literallayout class='monospaced'>
+ PACKAGECONFIG_pn-qemu-native = "sdl"
+ ASSUME_PROVIDED += "libsdl-native"
+ </literallayout>
+ <note>
+ The default <filename>local.conf</filename>
+ contains these statements as comments.
+ </note>
</para>
</section>
- <section id='migration-1.6-run'>
- <title><filename>run</filename></title>
+ <section id='migration-1.6-core-image-basic'>
+ <title><filename>core-image-basic</filename></title>
<para>
- Sample section.
+ <filename>core-image-basic</filename> has been renamed to
+ <filename>core-image-full-cmdline</filename>.
+ </para>
+
+ <para>
+ In addition to <filename>core-image-basic</filename> being renamed,
+ <filename>packagegroup-core-basic</filename> has been renamed to
+ <filename>packagegroup-core-full-cmdline</filename> to match.
</para>
</section>
- <section id='migration-1.6-removal-of-package-manager-database-within-image-recipes'>
- <title>Removal of Package Manager Database Within Image Recipes</title>
+ <section id='migration-1.6-licensing'>
+ <title>Licensing</title>
<para>
- Sample section.
+ The top-level <filename>LICENSE</filename> file has been changed
+ to better describe the license of the various components of
+ OE-Core.
+ Normally, this change would not cause any side-effects.
+ However, some recipes point to this file within
+ <link linkend='var-LIC_FILES_CHKSUM'><filename>LIC_FILES_CHKSUM</filename></link>
+ (as <filename>${COREBASE}/LICENSE</filename>) and thus the
+ accompanying checksum must be changed from
+ 3f40d7994397109285ec7b81fdeb3b58 to
+ 4d92cd373abda3937c2bc47fbc49d690.
</para>
</section>
- <section id='migration-1.6-images-now-rebuild-only-on-changes-instead-of-every-time'>
- <title>Images Now Rebuild Only on Changes Instead of Every Time</title>
+ <section id='migration-1.6-cflags-options'>
+ <title><filename>CFLAGS</filename> Options</title>
<para>
- Sample section.
+ The "-fpermissive" option has been removed from the default
+ <link linkend='var-CFLAGS'><filename>CFLAGS</filename></link>
+ 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
+ <filename>CFLAGS</filename> in the recipe.
</para>
</section>
- <section id='migration-1.6-task-recipes'>
- <title>Task Recipes</title>
+ <section id='migration-1.6-custom-images'>
+ <title>Custom Images</title>
<para>
- Sample section.
+ Custom image output types, as selected using
+ <link linkend='var-IMAGE_TYPES'><filename>IMAGE_TYPES</filename></link>,
+ must declare their dependencies on other image types (if any) using
+ a new
+ <link linkend='var-IMAGE_TYPEDEP'><filename>IMAGE_TYPEDEP</filename></link>
+ variable.
</para>
</section>
- <section id='migration-1.6-busybox'>
- <title>BusyBox</title>
+ <section id='migration-1.6-do-package-write-task'>
+ <title>Task Recipes</title>
<para>
- Sample section.
+ The <filename>do_package_write</filename> task has been removed.
+ The task is no longer needed.
</para>
</section>
- <section id='migration-1.6-automated-image-testing'>
- <title>Automated Image Testing</title>
+ <section id='migration-1.6-update-alternatives-provider'>
+ <title><filename>update-alternative</filename> Provider</title>
<para>
- Sample section.
+ The default <filename>update-alternatives</filename> provider has
+ been changed from <filename>opkg</filename> to
+ <filename>opkg-utils</filename>.
+ This change resolves some troublesome circular dependencies.
+ The runtime package has also been renamed from
+ <filename>update-alternatives-cworth</filename>
+ to <filename>update-alternatives-opkg</filename>.
</para>
</section>
- <section id='migration-1.6-build-history'>
- <title>Build History</title>
+ <section id='migration-1.6-virtclass-overrides'>
+ <title><filename>virtclass</filename> Overrides</title>
<para>
- Sample section.
+ The <filename>virtclass</filename> overrides are now deprecated.
+ Use the equivalent class overrides instead (e.g.
+ <filename>virtclass-native</filename> becomes
+ <filename>class-native</filename>.
</para>
</section>
- <section id='migration-1.6-udev'>
- <title><filename>udev</filename></title>
+ <section id='migration-1.6-task-taskname-overrides'>
+ <title><filename>task-&lt;taskname&gt;</filename> Overrides</title>
<para>
- Sample section.
+ <filename>task-&lt;taskname&gt;</filename> 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
+ <filename>do_populate_sdk</filename> is
+ <filename>task-populate-sdk</filename>.
</para>
</section>
@@ -1354,15 +1452,76 @@
<title>Removed and Renamed Recipes</title>
<para>
- Sample section.
+ The following recipes have been removed:
+ <itemizedlist>
+ <listitem><para><filename>packagegroup-toolset-native</filename> -
+ This recipe is largely unused.
+ </para></listitem>
+ <listitem><para><filename>linux-yocto-3.8</filename> -
+ Support for the Linux yocto 3.8 kernel has been dropped.
+ Support for the 3.10 and 3.14 kernels have been added
+ with the <filename>linux-yocto-3.10</filename> and
+ <filename>linux-yocto-3.14</filename> recipes.
+ </para></listitem>
+ <listitem><para><filename>ocf-linux</filename> -
+ This recipe has been functionally replaced using
+ <filename>cryptodev-linux</filename>.
+ </para></listitem>
+ <listitem><para><filename>genext2fs</filename> -
+ This upstream is no longer needed or maintained.
+ </para></listitem>
+ <listitem><para><filename>js</filename> -
+ This supported an ancient version of Mozilla's javascript
+ engine that is no longer needed.
+ </para></listitem>
+ <listitem><para><filename>zaurusd</filename> -
+ The recipe has been moved to the
+ <filename>meta-handheld</filename> layer.
+ </para></listitem>
+ <listitem><para><filename>eglibc 2.17</filename> -
+ Replaced by the <filename>eglibc 2.19</filename>
+ recipe.
+ </para></listitem>
+ <listitem><para><filename>gcc 4.7.2</filename> -
+ Replaced by the now stable
+ <filename>gcc 4.8.2</filename>.
+ </para></listitem>
+ <listitem><para><filename>external-sourcery-toolchain</filename> -
+ this recipe is now maintained in the
+ <filename>meta-sourcery</filename> layer.
+ </para></listitem>
+ <listitem><para><filename>linux-libc-headers-yocto 3.4+git</filename> -
+ Now using version 3.10 of the
+ <filename>linux-libc-headers</filename> by default.
+ </para></listitem>
+ <listitem><para><filename>meta-toolchain-gmae</filename> -
+ This recipe is obsolete.
+ </para></listitem>
+ <listitem><para><filename>packagegroup-core-sdk-gmae</filename> -
+ This recipe is obsolete.
+ </para></listitem>
+ <listitem><para><filename>packagegroup-core-standalone-gmae-sdk-target</filename> -
+ This recipe is obsolete.
+ </para></listitem>
+ </itemizedlist>
</para>
</section>
- <section id='migration-1.6-other-changes'>
- <title>Other Changes</title>
+ <section id='migration-1.6-removed-classes'>
+ <title>Removed Classes</title>
<para>
- Sample section.
+ The following classes have become obsolete and have been removed:
+ <itemizedlist>
+ <listitem><para><filename>module_strip</filename>
+ </para></listitem>
+ <listitem><para><filename>pkg_metainfo</filename>
+ </para></listitem>
+ <listitem><para><filename>pkg_distribute</filename>
+ </para></listitem>
+ <listitem><para><filename>image-empty</filename>
+ </para></listitem>
+ </itemizedlist>
</para>
</section>
</section>