mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-05-09 05:29:32 +00:00
Code Issues Projects Releases Wiki Activity

ref-manual: Added the migration section for 1.6.

Browse Source 
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>
This commit is contained in:
Scott Rifenbark
2014-04-01 15:19:37 -06:00
committed by Richard Purdie
parent 583b6a4527
commit 89e4e722ce
1 changed files with 206 additions and 47 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/ref-manual/migration.xml
+206 -47
View File
@@ -1092,19 +1092,44 @@
Yocto Project 1.6 Release from the prior release. Yocto Project 1.6 Release from the prior release.
</para> </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> <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> </para>
</section> </section>
<section id='migration-1.6-atom-pc-bsp'> <section id='migration-1.6-packaging-changes'>
<title><filename>atom-pc</filename> Board Support Package (BSP)</title> <title>Packaging Changes</title>
<para> <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> </para>
</section> </section>
@@ -1266,87 +1291,160 @@
<title>Directory Layout Changes</title> <title>Directory Layout Changes</title>
<para> <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> </para>
</section> </section>
<section id='migration-1.6-shortened-git-srcrev-values'> <section id='migration-1.6-build-changes'>
<title>Shortened Git <filename>SRCREV</filename> Values</title> <title>Build Changes</title>
<para> <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> </para>
</section> </section>
<section id='migration-1.6-image-features'> <section id='migration-1.6-building-qemu-native'>
<title><filename>IMAGE_FEATURES</filename></title> <title><filename>qemu-native</filename></title>
<para> <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> </para>
</section> </section>
<section id='migration-1.6-run'> <section id='migration-1.6-core-image-basic'>
<title><filename>run</filename></title> <title><filename>core-image-basic</filename></title>
<para> <para>
Sample section. <filename>core-image-basic</filename> has been renamed to
<filename>core-image-full-cmdline</filename>.
</para> </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>
<para> <para>
Sample section. 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> </para>
</section> </section>
<section id='migration-1.6-images-now-rebuild-only-on-changes-instead-of-every-time'> <section id='migration-1.6-licensing'>
<title>Images Now Rebuild Only on Changes Instead of Every Time</title> <title>Licensing</title>
<para> <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> </para>
</section> </section>
<section id='migration-1.6-task-recipes'> <section id='migration-1.6-cflags-options'>
<title><filename>CFLAGS</filename> Options</title>
<para>
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-custom-images'>
<title>Custom Images</title>
<para>
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-do-package-write-task'>
<title>Task Recipes</title> <title>Task Recipes</title>
<para> <para>
Sample section. The <filename>do_package_write</filename> task has been removed.
The task is no longer needed.
</para> </para>
</section> </section>
<section id='migration-1.6-busybox'> <section id='migration-1.6-update-alternatives-provider'>
<title>BusyBox</title> <title><filename>update-alternative</filename> Provider</title>
<para> <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> </para>
</section> </section>
<section id='migration-1.6-automated-image-testing'> <section id='migration-1.6-virtclass-overrides'>
<title>Automated Image Testing</title> <title><filename>virtclass</filename> Overrides</title>
<para> <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> </para>
</section> </section>
<section id='migration-1.6-build-history'> <section id='migration-1.6-task-taskname-overrides'>
<title>Build History</title> <title><filename>task-&lt;taskname&gt;</filename> Overrides</title>
<para> <para>
Sample section. <filename>task-&lt;taskname&gt;</filename> overrides have been
</para> adjusted so that tasks whose names contain underscores have the
</section> underscores replaced by hyphens for the override so that they
now function properly.
<section id='migration-1.6-udev'> For example, the task override for
<title><filename>udev</filename></title> <filename>do_populate_sdk</filename> is
<filename>task-populate-sdk</filename>.
<para>
Sample section.
</para> </para>
</section> </section>
@@ -1354,15 +1452,76 @@
<title>Removed and Renamed Recipes</title> <title>Removed and Renamed Recipes</title>
<para> <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> </para>
</section> </section>
<section id='migration-1.6-other-changes'> <section id='migration-1.6-removed-classes'>
<title>Other Changes</title> <title>Removed Classes</title>
<para> <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> </para>
</section> </section>
</section> </section>