summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
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
parent583b6a45273e1c71ce39427b670612550612bc70 (diff)
downloadpoky-89e4e722ce784d9acd593cfc5b48583be1f4b8a7.tar.gz
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')
-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 @@
1092 Yocto Project 1.6 Release from the prior release. 1092 Yocto Project 1.6 Release from the prior release.
1093 </para> 1093 </para>
1094 1094
1095 <section id='migration-1.6-host-dependency-changes'> 1095
1096 <title>Host Dependency Changes</title> 1096 <section id='migration-1.6-archiver-class'>
1097 <title><filename>archiver</filename> Class</title>
1097 1098
1098 <para> 1099 <para>
1099 Sample section. 1100 The
1101 <link linkend='ref-classes-archiver'><filename>archiver</filename></link>
1102 class has been rewritten and its configuration has been simplified.
1103 For more details on the source archiver, see the
1104 "<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>"
1105 section in the Yocto Project Development Manual.
1100 </para> 1106 </para>
1101 </section> 1107 </section>
1102 1108
1103 <section id='migration-1.6-atom-pc-bsp'> 1109 <section id='migration-1.6-packaging-changes'>
1104 <title><filename>atom-pc</filename> Board Support Package (BSP)</title> 1110 <title>Packaging Changes</title>
1105 1111
1106 <para> 1112 <para>
1107 Sample section. 1113 The following packaging changes have been made:
1114 <itemizedlist>
1115 <listitem><para>
1116 The <filename>binutils</filename> recipe no longer produces
1117 a <filename>binutils-symlinks</filename> package.
1118 <filename>update-alternatives</filename> is now used to
1119 handle the preferred <filename>binutils</filename>
1120 variant on the target instead.
1121 </para></listitem>
1122 <listitem><para>
1123 The tc (traffic control) utilities have been split out of
1124 the main <filename>iproute2</filename> package and put
1125 into the <filename>iproute2-tc</filename> package.
1126 </para></listitem>
1127 <listitem><para>
1128 The <filename>gtk-engines</filename> schemas have been
1129 moved to a dedicated
1130 <filename>gtk-engines-schemas</filename> package.
1131 </para></listitem>
1132 </itemizedlist>
1108 </para> 1133 </para>
1109 </section> 1134 </section>
1110 1135
@@ -1266,87 +1291,160 @@
1266 <title>Directory Layout Changes</title> 1291 <title>Directory Layout Changes</title>
1267 1292
1268 <para> 1293 <para>
1269 Sample section. 1294 The <filename>meta-hob</filename> layer has been removed from
1295 the top-level of the
1296 <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>.
1297 The contents of this layer are no longer needed by the Hob
1298 user interface for building images and toolchains.
1270 </para> 1299 </para>
1271 </section> 1300 </section>
1272 1301
1273 <section id='migration-1.6-shortened-git-srcrev-values'> 1302 <section id='migration-1.6-build-changes'>
1274 <title>Shortened Git <filename>SRCREV</filename> Values</title> 1303 <title>Build Changes</title>
1275 1304
1276 <para> 1305 <para>
1277 Sample section. 1306 Separate build and source directories have been enabled
1307 by default for selected recipes where it is known to work
1308 (a whitelist) and for when using the
1309 <link linkend='ref-classes-cmake'><filename>cmake</filename></link>
1310 class.
1311 In future releases the
1312 <link linkend='ref-classes-autotools'><filename>autotools</filename></link>
1313 class will enable a separate build directory by default as
1314 well.
1315 Recipes building <filename>autotools-based</filename>
1316 software that fails to build with a separate build directory
1317 should be changed to inherit from the
1318 <link linkend='ref-classes-autotools-brokensep'><filename>autotools-brokensep</filename></link>
1319 class instead of the <filename>autotools</filename> class.
1278 </para> 1320 </para>
1279 </section> 1321 </section>
1280 1322
1281 <section id='migration-1.6-image-features'> 1323 <section id='migration-1.6-building-qemu-native'>
1282 <title><filename>IMAGE_FEATURES</filename></title> 1324 <title><filename>qemu-native</filename></title>
1283 1325
1284 <para> 1326 <para>
1285 Sample section. 1327 <filename>qemu-native</filename> now builds without
1328 SDL-based graphical output support by default.
1329 The following additional lines are needed in your
1330 <filename>local.conf</filename> to enable it.
1331 Remove the comments from the following two lines when you
1332 need to build a headless server:
1333 <literallayout class='monospaced'>
1334 PACKAGECONFIG_pn-qemu-native = "sdl"
1335 ASSUME_PROVIDED += "libsdl-native"
1336 </literallayout>
1337 <note>
1338 The default <filename>local.conf</filename>
1339 contains these statements as comments.
1340 </note>
1286 </para> 1341 </para>
1287 </section> 1342 </section>
1288 1343
1289 <section id='migration-1.6-run'> 1344 <section id='migration-1.6-core-image-basic'>
1290 <title><filename>run</filename></title> 1345 <title><filename>core-image-basic</filename></title>
1291 1346
1292 <para> 1347 <para>
1293 Sample section. 1348 <filename>core-image-basic</filename> has been renamed to
1349 <filename>core-image-full-cmdline</filename>.
1350 </para>
1351
1352 <para>
1353 In addition to <filename>core-image-basic</filename> being renamed,
1354 <filename>packagegroup-core-basic</filename> has been renamed to
1355 <filename>packagegroup-core-full-cmdline</filename> to match.
1294 </para> 1356 </para>
1295 </section> 1357 </section>
1296 1358
1297 <section id='migration-1.6-removal-of-package-manager-database-within-image-recipes'> 1359 <section id='migration-1.6-licensing'>
1298 <title>Removal of Package Manager Database Within Image Recipes</title> 1360 <title>Licensing</title>
1299 1361
1300 <para> 1362 <para>
1301 Sample section. 1363 The top-level <filename>LICENSE</filename> file has been changed
1364 to better describe the license of the various components of
1365 OE-Core.
1366 Normally, this change would not cause any side-effects.
1367 However, some recipes point to this file within
1368 <link linkend='var-LIC_FILES_CHKSUM'><filename>LIC_FILES_CHKSUM</filename></link>
1369 (as <filename>${COREBASE}/LICENSE</filename>) and thus the
1370 accompanying checksum must be changed from
1371 3f40d7994397109285ec7b81fdeb3b58 to
1372 4d92cd373abda3937c2bc47fbc49d690.
1302 </para> 1373 </para>
1303 </section> 1374 </section>
1304 1375
1305 <section id='migration-1.6-images-now-rebuild-only-on-changes-instead-of-every-time'> 1376 <section id='migration-1.6-cflags-options'>
1306 <title>Images Now Rebuild Only on Changes Instead of Every Time</title> 1377 <title><filename>CFLAGS</filename> Options</title>
1307 1378
1308 <para> 1379 <para>
1309 Sample section. 1380 The "-fpermissive" option has been removed from the default
1381 <link linkend='var-CFLAGS'><filename>CFLAGS</filename></link>
1382 value.
1383 Individual recipes that fail to build without it should either
1384 be patched to fix the issues reported by the compiler.
1385 Alternatively, you can add "-fpermissive" to
1386 <filename>CFLAGS</filename> in the recipe.
1310 </para> 1387 </para>
1311 </section> 1388 </section>
1312 1389
1313 <section id='migration-1.6-task-recipes'> 1390 <section id='migration-1.6-custom-images'>
1314 <title>Task Recipes</title> 1391 <title>Custom Images</title>
1315 1392
1316 <para> 1393 <para>
1317 Sample section. 1394 Custom image output types, as selected using
1395 <link linkend='var-IMAGE_TYPES'><filename>IMAGE_TYPES</filename></link>,
1396 must declare their dependencies on other image types (if any) using
1397 a new
1398 <link linkend='var-IMAGE_TYPEDEP'><filename>IMAGE_TYPEDEP</filename></link>
1399 variable.
1318 </para> 1400 </para>
1319 </section> 1401 </section>
1320 1402
1321 <section id='migration-1.6-busybox'> 1403 <section id='migration-1.6-do-package-write-task'>
1322 <title>BusyBox</title> 1404 <title>Task Recipes</title>
1323 1405
1324 <para> 1406 <para>
1325 Sample section. 1407 The <filename>do_package_write</filename> task has been removed.
1408 The task is no longer needed.
1326 </para> 1409 </para>
1327 </section> 1410 </section>
1328 1411
1329 <section id='migration-1.6-automated-image-testing'> 1412 <section id='migration-1.6-update-alternatives-provider'>
1330 <title>Automated Image Testing</title> 1413 <title><filename>update-alternative</filename> Provider</title>
1331 1414
1332 <para> 1415 <para>
1333 Sample section. 1416 The default <filename>update-alternatives</filename> provider has
1417 been changed from <filename>opkg</filename> to
1418 <filename>opkg-utils</filename>.
1419 This change resolves some troublesome circular dependencies.
1420 The runtime package has also been renamed from
1421 <filename>update-alternatives-cworth</filename>
1422 to <filename>update-alternatives-opkg</filename>.
1334 </para> 1423 </para>
1335 </section> 1424 </section>
1336 1425
1337 <section id='migration-1.6-build-history'> 1426 <section id='migration-1.6-virtclass-overrides'>
1338 <title>Build History</title> 1427 <title><filename>virtclass</filename> Overrides</title>
1339 1428
1340 <para> 1429 <para>
1341 Sample section. 1430 The <filename>virtclass</filename> overrides are now deprecated.
1431 Use the equivalent class overrides instead (e.g.
1432 <filename>virtclass-native</filename> becomes
1433 <filename>class-native</filename>.
1342 </para> 1434 </para>
1343 </section> 1435 </section>
1344 1436
1345 <section id='migration-1.6-udev'> 1437 <section id='migration-1.6-task-taskname-overrides'>
1346 <title><filename>udev</filename></title> 1438 <title><filename>task-&lt;taskname&gt;</filename> Overrides</title>
1347 1439
1348 <para> 1440 <para>
1349 Sample section. 1441 <filename>task-&lt;taskname&gt;</filename> overrides have been
1442 adjusted so that tasks whose names contain underscores have the
1443 underscores replaced by hyphens for the override so that they
1444 now function properly.
1445 For example, the task override for
1446 <filename>do_populate_sdk</filename> is
1447 <filename>task-populate-sdk</filename>.
1350 </para> 1448 </para>
1351 </section> 1449 </section>
1352 1450
@@ -1354,15 +1452,76 @@
1354 <title>Removed and Renamed Recipes</title> 1452 <title>Removed and Renamed Recipes</title>
1355 1453
1356 <para> 1454 <para>
1357 Sample section. 1455 The following recipes have been removed:
1456 <itemizedlist>
1457 <listitem><para><filename>packagegroup-toolset-native</filename> -
1458 This recipe is largely unused.
1459 </para></listitem>
1460 <listitem><para><filename>linux-yocto-3.8</filename> -
1461 Support for the Linux yocto 3.8 kernel has been dropped.
1462 Support for the 3.10 and 3.14 kernels have been added
1463 with the <filename>linux-yocto-3.10</filename> and
1464 <filename>linux-yocto-3.14</filename> recipes.
1465 </para></listitem>
1466 <listitem><para><filename>ocf-linux</filename> -
1467 This recipe has been functionally replaced using
1468 <filename>cryptodev-linux</filename>.
1469 </para></listitem>
1470 <listitem><para><filename>genext2fs</filename> -
1471 This upstream is no longer needed or maintained.
1472 </para></listitem>
1473 <listitem><para><filename>js</filename> -
1474 This supported an ancient version of Mozilla's javascript
1475 engine that is no longer needed.
1476 </para></listitem>
1477 <listitem><para><filename>zaurusd</filename> -
1478 The recipe has been moved to the
1479 <filename>meta-handheld</filename> layer.
1480 </para></listitem>
1481 <listitem><para><filename>eglibc 2.17</filename> -
1482 Replaced by the <filename>eglibc 2.19</filename>
1483 recipe.
1484 </para></listitem>
1485 <listitem><para><filename>gcc 4.7.2</filename> -
1486 Replaced by the now stable
1487 <filename>gcc 4.8.2</filename>.
1488 </para></listitem>
1489 <listitem><para><filename>external-sourcery-toolchain</filename> -
1490 this recipe is now maintained in the
1491 <filename>meta-sourcery</filename> layer.
1492 </para></listitem>
1493 <listitem><para><filename>linux-libc-headers-yocto 3.4+git</filename> -
1494 Now using version 3.10 of the
1495 <filename>linux-libc-headers</filename> by default.
1496 </para></listitem>
1497 <listitem><para><filename>meta-toolchain-gmae</filename> -
1498 This recipe is obsolete.
1499 </para></listitem>
1500 <listitem><para><filename>packagegroup-core-sdk-gmae</filename> -
1501 This recipe is obsolete.
1502 </para></listitem>
1503 <listitem><para><filename>packagegroup-core-standalone-gmae-sdk-target</filename> -
1504 This recipe is obsolete.
1505 </para></listitem>
1506 </itemizedlist>
1358 </para> 1507 </para>
1359 </section> 1508 </section>
1360 1509
1361 <section id='migration-1.6-other-changes'> 1510 <section id='migration-1.6-removed-classes'>
1362 <title>Other Changes</title> 1511 <title>Removed Classes</title>
1363 1512
1364 <para> 1513 <para>
1365 Sample section. 1514 The following classes have become obsolete and have been removed:
1515 <itemizedlist>
1516 <listitem><para><filename>module_strip</filename>
1517 </para></listitem>
1518 <listitem><para><filename>pkg_metainfo</filename>
1519 </para></listitem>
1520 <listitem><para><filename>pkg_distribute</filename>
1521 </para></listitem>
1522 <listitem><para><filename>image-empty</filename>
1523 </para></listitem>
1524 </itemizedlist>
1366 </para> 1525 </para>
1367 </section> 1526 </section>
1368</section> 1527</section>