diff options
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r-- | documentation/ref-manual/migration.xml | 165 |
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> |