summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r--documentation/ref-manual/migration.xml165
1 files changed, 83 insertions, 82 deletions
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index a7bab5aa36..4f46d6348d 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -247,30 +247,30 @@
247 Differences include the following: 247 Differences include the following:
248 <itemizedlist> 248 <itemizedlist>
249 <listitem><para><emphasis>Comment Continuation:</emphasis> 249 <listitem><para><emphasis>Comment Continuation:</emphasis>
250 If a comment ends with a line continuation (\) character, 250 If a comment ends with a line continuation (\) character,
251 then the next line must also be a comment. 251 then the next line must also be a comment.
252 Any instance where this is not the case, now triggers 252 Any instance where this is not the case, now triggers
253 a warning. 253 a warning.
254 You must either remove the continuation character, or be 254 You must either remove the continuation character, or be
255 sure the next line is a comment. 255 sure the next line is a comment.
256 </para></listitem> 256 </para></listitem>
257 <listitem><para><emphasis>Package Name Overrides:</emphasis> 257 <listitem><para><emphasis>Package Name Overrides:</emphasis>
258 The runtime package specific variables 258 The runtime package specific variables
259 <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link>, 259 <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link>,
260 <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>, 260 <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>,
261 <link linkend='var-RSUGGESTS'><filename>RSUGGESTS</filename></link>, 261 <link linkend='var-RSUGGESTS'><filename>RSUGGESTS</filename></link>,
262 <link linkend='var-RPROVIDES'><filename>RPROVIDES</filename></link>, 262 <link linkend='var-RPROVIDES'><filename>RPROVIDES</filename></link>,
263 <link linkend='var-RCONFLICTS'><filename>RCONFLICTS</filename></link>, 263 <link linkend='var-RCONFLICTS'><filename>RCONFLICTS</filename></link>,
264 <link linkend='var-RREPLACES'><filename>RREPLACES</filename></link>, 264 <link linkend='var-RREPLACES'><filename>RREPLACES</filename></link>,
265 <link linkend='var-FILES'><filename>FILES</filename></link>, 265 <link linkend='var-FILES'><filename>FILES</filename></link>,
266 <link linkend='var-ALLOW_EMPTY'><filename>ALLOW_EMPTY</filename></link>, 266 <link linkend='var-ALLOW_EMPTY'><filename>ALLOW_EMPTY</filename></link>,
267 and the pre, post, install, and uninstall script functions 267 and the pre, post, install, and uninstall script functions
268 <filename>pkg_preinst</filename>, 268 <filename>pkg_preinst</filename>,
269 <filename>pkg_postinst</filename>, 269 <filename>pkg_postinst</filename>,
270 <filename>pkg_prerm</filename>, and 270 <filename>pkg_prerm</filename>, and
271 <filename>pkg_postrm</filename> should always have a 271 <filename>pkg_postrm</filename> should always have a
272 package name override. 272 package name override.
273 For example, use <filename>RDEPENDS_${PN}</filename> for 273 For example, use <filename>RDEPENDS_${PN}</filename> for
274 the main package instead of <filename>RDEPENDS</filename>. 274 the main package instead of <filename>RDEPENDS</filename>.
275 BitBake uses more strict checks when it parses recipes. 275 BitBake uses more strict checks when it parses recipes.
276 </para></listitem> 276 </para></listitem>
@@ -285,33 +285,34 @@
285 Differences include the following: 285 Differences include the following:
286 <itemizedlist> 286 <itemizedlist>
287 <listitem><para><emphasis>Shared State Code:</emphasis> 287 <listitem><para><emphasis>Shared State Code:</emphasis>
288 The shared state code has been optimized to avoid running 288 The shared state code has been optimized to avoid running
289 unnecessary tasks. 289 unnecessary tasks.
290 For example, 290 For example,
291 <filename>bitbake -c rootfs some-image</filename> from 291 <filename>bitbake -c rootfs some-image</filename> from
292 shared state no longer populates the target sysroot 292 shared state no longer populates the target sysroot
293 since that is not necessary. 293 since that is not necessary.
294 Instead, the system just needs to extract the output 294 Instead, the system just needs to extract the output
295 package contents, re-create the packages, and construct 295 package contents, re-create the packages, and construct
296 the root filesystem. 296 the root filesystem.
297 This change is unlikely to cause any problems unless 297 This change is unlikely to cause any problems unless
298 you have missing declared dependencies. 298 you have missing declared dependencies.
299 </para></listitem> 299 </para></listitem>
300 <listitem><para><emphasis>Scanning Directory Names:</emphasis> 300 <listitem><para><emphasis>Scanning Directory Names:</emphasis>
301 When scanning for files in 301 When scanning for files in
302 <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link>, 302 <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link>,
303 the build system now uses <filename>FILESOVERRIDES</filename> 303 the build system now uses
304 instead of <filename>OVERRIDES</filename> for the directory 304 <link linkend='var-FILESOVERRIDES'><filename>FILESOVERRIDES</filename></link>
305 names. 305 instead of <link linkend='var-OVERRIDES'><filename>OVERRIDES</filename></link>
306 for the directory names.
306 In general, the values previously in 307 In general, the values previously in
307 <filename>OVERRIDES</filename> are now in 308 <filename>OVERRIDES</filename> are now in
308 <filename>FILESOVERRIDES</filename> as well. 309 <filename>FILESOVERRIDES</filename> as well.
309 However, if you relied upon an additional value 310 However, if you relied upon an additional value
310 you previously added to <filename>OVERRIDES</filename>, 311 you previously added to <filename>OVERRIDES</filename>,
311 you might now need to add it to 312 you might now need to add it to
312 <filename>FILESOVERRIDES</filename> unless you are already 313 <filename>FILESOVERRIDES</filename> unless you are already
313 adding it through the 314 adding it through the
314 <link linkend='var-MACHINEOVERRIDES'><filename>MACHINEOVERRIDES</filename></link> 315 <link linkend='var-MACHINEOVERRIDES'><filename>MACHINEOVERRIDES</filename></link>
315 or <link linkend='var-DISTROOVERRIDES'><filename>DISTROOVERRIDES</filename></link> 316 or <link linkend='var-DISTROOVERRIDES'><filename>DISTROOVERRIDES</filename></link>
316 variables, as appropriate. 317 variables, as appropriate.
317 For more related changes, see the 318 For more related changes, see the
@@ -327,9 +328,9 @@
327 <title>Proxies and Fetching Source</title> 328 <title>Proxies and Fetching Source</title>
328 329
329 <para> 330 <para>
330 A new <filename>oe-git-proxy</filename> script has been added to 331 A new <filename>oe-git-proxy</filename> script has been added to
331 replace previous methods of handling proxies and fetching source 332 replace previous methods of handling proxies and fetching source
332 from Git. 333 from Git.
333 See the <filename>meta-yocto/conf/site.conf.sample</filename> file 334 See the <filename>meta-yocto/conf/site.conf.sample</filename> file
334 for information on how to use this script. 335 for information on how to use this script.
335 </para> 336 </para>
@@ -339,15 +340,15 @@
339 <title>Custom Interfaces File (netbase change)</title> 340 <title>Custom Interfaces File (netbase change)</title>
340 341
341 <para> 342 <para>
342 If you have created your own custom 343 If you have created your own custom
343 <filename>etc/network/interfaces</filename> file by creating 344 <filename>etc/network/interfaces</filename> file by creating
344 an append file for the <filename>netbase</filename> recipe, 345 an append file for the <filename>netbase</filename> recipe,
345 you now need to create an append file for the 346 you now need to create an append file for the
346 <filename>init-ifupdown</filename> recipe instead, which you can 347 <filename>init-ifupdown</filename> recipe instead, which you can
347 find in the 348 find in the
348 <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink> 349 <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>
349 at <filename>meta/recipes-core/init-ifupdown</filename>. 350 at <filename>meta/recipes-core/init-ifupdown</filename>.
350 For information on how to use append files, see the 351 For information on how to use append files, see the
351 "<ulink url='&YOCTO_DOCS_DEV_URL;#using-bbappend-files'>Using .bbappend Files</ulink>" 352 "<ulink url='&YOCTO_DOCS_DEV_URL;#using-bbappend-files'>Using .bbappend Files</ulink>"
352 in the Yocto Project Development Manual. 353 in the Yocto Project Development Manual.
353 </para> 354 </para>
@@ -357,12 +358,12 @@
357 <title>Remote Debugging</title> 358 <title>Remote Debugging</title>
358 359
359 <para> 360 <para>
360 Support for remote debugging with the Eclipse IDE is now 361 Support for remote debugging with the Eclipse IDE is now
361 separated into an image feature 362 separated into an image feature
362 (<filename>eclipse-debug</filename>) that corresponds to the 363 (<filename>eclipse-debug</filename>) that corresponds to the
363 <filename>packagegroup-core-eclipse-debug</filename> package group. 364 <filename>packagegroup-core-eclipse-debug</filename> package group.
364 Previously, the debugging feature was included through the 365 Previously, the debugging feature was included through the
365 <filename>tools-debug</filename> image feature, which corresponds 366 <filename>tools-debug</filename> image feature, which corresponds
366 to the <filename>packagegroup-core-tools-debug</filename> 367 to the <filename>packagegroup-core-tools-debug</filename>
367 package group. 368 package group.
368 </para> 369 </para>
@@ -375,36 +376,36 @@
375 The following variables have changed: 376 The following variables have changed:
376 <itemizedlist> 377 <itemizedlist>
377 <listitem><para><emphasis><filename>SANITY_TESTED_DISTROS</filename>:</emphasis> 378 <listitem><para><emphasis><filename>SANITY_TESTED_DISTROS</filename>:</emphasis>
378 This variable now uses a distribution ID, which is composed 379 This variable now uses a distribution ID, which is composed
379 of the host distributor ID followed by the release. 380 of the host distributor ID followed by the release.
380 Previously, 381 Previously,
381 <link linkend='var-SANITY_TESTED_DISTROS'><filename>SANITY_TESTED_DISTROS</filename></link> 382 <link linkend='var-SANITY_TESTED_DISTROS'><filename>SANITY_TESTED_DISTROS</filename></link>
382 was composed of the description field. 383 was composed of the description field.
383 For example, "Ubuntu 12.10" becomes "Ubuntu-12.10". 384 For example, "Ubuntu 12.10" becomes "Ubuntu-12.10".
384 You do not need to worry about this change if you are not 385 You do not need to worry about this change if you are not
385 specifically setting this variable, or if you are 386 specifically setting this variable, or if you are
386 specifically setting it to "". 387 specifically setting it to "".
387 </para></listitem> 388 </para></listitem>
388 <listitem><para><emphasis><filename>SRC_URI</filename>:</emphasis> 389 <listitem><para><emphasis><filename>SRC_URI</filename>:</emphasis>
389 The <filename>${</filename><link linkend='var-PN'><filename>PN</filename></link><filename>}</filename>, 390 The <filename>${</filename><link linkend='var-PN'><filename>PN</filename></link><filename>}</filename>,
390 <filename>${</filename><link linkend='var-PF'><filename>PF</filename></link><filename>}</filename>, 391 <filename>${</filename><link linkend='var-PF'><filename>PF</filename></link><filename>}</filename>,
391 <filename>${</filename><link linkend='var-P'><filename>P</filename></link><filename>}</filename>, 392 <filename>${</filename><link linkend='var-P'><filename>P</filename></link><filename>}</filename>,
392 and <filename>FILE_DIRNAME</filename> directories have been 393 and <filename>FILE_DIRNAME</filename> directories have been
393 dropped from the default value of the 394 dropped from the default value of the
394 <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link> 395 <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link>
395 variable, which is used as the search path for finding files 396 variable, which is used as the search path for finding files
396 referred to in 397 referred to in
397 <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link>. 398 <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link>.
398 If you have a recipe that relied upon these directories, 399 If you have a recipe that relied upon these directories,
399 which would be unusual, then you will need to add the 400 which would be unusual, then you will need to add the
400 appropriate paths within the recipe or, alternatively, 401 appropriate paths within the recipe or, alternatively,
401 rearrange the files. 402 rearrange the files.
402 The most common locations are still covered by 403 The most common locations are still covered by
403 <filename>${BP}</filename>, <filename>${BPN}</filename>, 404 <filename>${BP}</filename>, <filename>${BPN}</filename>,
404 and "files", which all remain in the default value of 405 and "files", which all remain in the default value of
405 <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link>. 406 <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link>.
406 </para></listitem> 407 </para></listitem>
407 </itemizedlist> 408 </itemizedlist>
408 </para> 409 </para>
409 </section> 410 </section>
410 411
@@ -412,10 +413,10 @@
412 <title>Target Package Management with RPM</title> 413 <title>Target Package Management with RPM</title>
413 414
414 <para> 415 <para>
415 If runtime package management is enabled and the RPM backend 416 If runtime package management is enabled and the RPM backend
416 is selected, Smart is now installed for package download, dependency 417 is selected, Smart is now installed for package download, dependency
417 resolution, and upgrades instead of Zypper. 418 resolution, and upgrades instead of Zypper.
418 For more information on how to use Smart, run the following command 419 For more information on how to use Smart, run the following command
419 on the target: 420 on the target:
420 <literallayout class='monospaced'> 421 <literallayout class='monospaced'>
421 smart --help 422 smart --help
@@ -427,8 +428,8 @@
427 <title>Recipes Moved</title> 428 <title>Recipes Moved</title>
428 429
429 <para> 430 <para>
430 The following recipes were moved from their previous locations 431 The following recipes were moved from their previous locations
431 because they are no longer used by anything in 432 because they are no longer used by anything in
432 the OpenEmbedded-Core: 433 the OpenEmbedded-Core:
433 <itemizedlist> 434 <itemizedlist>
434 <listitem><para><emphasis><filename>clutter-box2d</filename>:</emphasis> 435 <listitem><para><emphasis><filename>clutter-box2d</filename>:</emphasis>
@@ -478,7 +479,7 @@
478 The following list shows what has been removed or renamed: 479 The following list shows what has been removed or renamed:
479 <itemizedlist> 480 <itemizedlist>
480 <listitem><para><emphasis><filename>evieext</filename>:</emphasis> 481 <listitem><para><emphasis><filename>evieext</filename>:</emphasis>
481 Removed because it has been removed from 482 Removed because it has been removed from
482 <filename>xserver</filename> since 2008. 483 <filename>xserver</filename> since 2008.
483 </para></listitem> 484 </para></listitem>
484 <listitem><para><emphasis>Gtk+ DirectFB:</emphasis> 485 <listitem><para><emphasis>Gtk+ DirectFB:</emphasis>
@@ -489,7 +490,7 @@
489 Removed because they were removed from the Xorg server in 2008. 490 Removed because they were removed from the Xorg server in 2008.
490 </para></listitem> 491 </para></listitem>
491 <listitem><para><emphasis><filename>libxp / libxprintapputil / libxprintutil / printproto</filename>:</emphasis> 492 <listitem><para><emphasis><filename>libxp / libxprintapputil / libxprintutil / printproto</filename>:</emphasis>
492 Removed because the XPrint server was removed from 493 Removed because the XPrint server was removed from
493 Xorg in 2008. 494 Xorg in 2008.
494 </para></listitem> 495 </para></listitem>
495 <listitem><para><emphasis><filename>libxtrap / xtrapproto</filename>:</emphasis> 496 <listitem><para><emphasis><filename>libxtrap / xtrapproto</filename>:</emphasis>
@@ -501,7 +502,7 @@
501 as part of the release. 502 as part of the release.
502 </para></listitem> 503 </para></listitem>
503 <listitem><para><emphasis><filename>lsbsetup</filename>:</emphasis> 504 <listitem><para><emphasis><filename>lsbsetup</filename>:</emphasis>
504 Removed with functionality now provided by 505 Removed with functionality now provided by
505 <filename>lsbtest</filename>. 506 <filename>lsbtest</filename>.
506 </para></listitem> 507 </para></listitem>
507 <listitem><para><emphasis><filename>matchbox-stroke</filename>:</emphasis> 508 <listitem><para><emphasis><filename>matchbox-stroke</filename>:</emphasis>
@@ -509,8 +510,8 @@
509 </para></listitem> 510 </para></listitem>
510 <listitem><para><emphasis><filename>matchbox-wm-2 / matchbox-theme-sato-2</filename>:</emphasis> 511 <listitem><para><emphasis><filename>matchbox-wm-2 / matchbox-theme-sato-2</filename>:</emphasis>
511 Removed because they are not maintained. 512 Removed because they are not maintained.
512 However, <filename>matchbox-wm</filename> and 513 However, <filename>matchbox-wm</filename> and
513 <filename>matchbox-theme-sato</filename> are still 514 <filename>matchbox-theme-sato</filename> are still
514 provided. 515 provided.
515 </para></listitem> 516 </para></listitem>
516 <listitem><para><emphasis><filename>mesa-dri</filename>:</emphasis> 517 <listitem><para><emphasis><filename>mesa-dri</filename>:</emphasis>
@@ -520,7 +521,7 @@
520 Removed because it was no longer useful. 521 Removed because it was no longer useful.
521 </para></listitem> 522 </para></listitem>
522 <listitem><para><emphasis><filename>mutter</filename>:</emphasis> 523 <listitem><para><emphasis><filename>mutter</filename>:</emphasis>
523 Removed because nothing ever uses it and the recipe is 524 Removed because nothing ever uses it and the recipe is
524 very old. 525 very old.
525 </para></listitem> 526 </para></listitem>
526 <listitem><para><emphasis><filename>orinoco-conf</filename>:</emphasis> 527 <listitem><para><emphasis><filename>orinoco-conf</filename>:</emphasis>
@@ -528,27 +529,27 @@
528 </para></listitem> 529 </para></listitem>
529 <listitem><para><emphasis><filename>update-modules</filename>:</emphasis> 530 <listitem><para><emphasis><filename>update-modules</filename>:</emphasis>
530 Removed because it is no longer used. 531 Removed because it is no longer used.
531 The kernel module <filename>postinstall</filename> and 532 The kernel module <filename>postinstall</filename> and
532 <filename>postrm</filename> scripts can now do the same 533 <filename>postrm</filename> scripts can now do the same
533 task without the use of this script. 534 task without the use of this script.
534 </para></listitem> 535 </para></listitem>
535 <listitem><para><emphasis><filename>web</filename>:</emphasis> 536 <listitem><para><emphasis><filename>web</filename>:</emphasis>
536 Removed because it is not maintained. Superseded by 537 Removed because it is not maintained. Superseded by
537 <filename>web-webkit</filename>. 538 <filename>web-webkit</filename>.
538 </para></listitem> 539 </para></listitem>
539 <listitem><para><emphasis><filename>xf86bigfontproto</filename>:</emphasis> 540 <listitem><para><emphasis><filename>xf86bigfontproto</filename>:</emphasis>
540 Removed because upstream it has been disabled by default 541 Removed because upstream it has been disabled by default
541 since 2007. 542 since 2007.
542 Nothing uses <filename>xf86bigfontproto</filename>. 543 Nothing uses <filename>xf86bigfontproto</filename>.
543 </para></listitem> 544 </para></listitem>
544 <listitem><para><emphasis><filename>xf86rushproto</filename>:</emphasis> 545 <listitem><para><emphasis><filename>xf86rushproto</filename>:</emphasis>
545 Removed because its dependency in 546 Removed because its dependency in
546 <filename>xserver</filename> was spurious and it was 547 <filename>xserver</filename> was spurious and it was
547 removed in 2005. 548 removed in 2005.
548 </para></listitem> 549 </para></listitem>
549 <listitem><para><emphasis><filename>zypper / libzypp / sat-solver</filename>:</emphasis> 550 <listitem><para><emphasis><filename>zypper / libzypp / sat-solver</filename>:</emphasis>
550 Removed and been functionally replaced with Smart 551 Removed and been functionally replaced with Smart
551 (<filename>python-smartpm</filename>) when RPM packaging 552 (<filename>python-smartpm</filename>) when RPM packaging
552 is used and package management is enabled on the target. 553 is used and package management is enabled on the target.
553 </para></listitem> 554 </para></listitem>
554 </itemizedlist> 555 </itemizedlist>