summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
Diffstat
-rw-r--r--documentation/ref-manual/migration.xml224
1 files changed, 224 insertions, 0 deletions
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index c648d8d442..1b902914bc 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -6325,6 +6325,230 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
6325 </para> 6325 </para>
6326 </section> 6326 </section>
6327</section> 6327</section>
6328
6329<section id='moving-to-the-yocto-project-2.7-release'>
6330 <title>Moving to the Yocto Project 2.7 Release</title>
6331
6332 <para>
6333 This section provides migration information for moving to the
6334 Yocto Project 2.7 Release from the prior release.
6335 </para>
6336
6337 <section id='migration-2.7-bitbake-changes'>
6338 <title>BitBake Changes</title>
6339
6340 <para>
6341 The following changes have been made to BitBake:
6342 <itemizedlist>
6343 <listitem><para>
6344 The BBHandler now checks tab indentation for Python code.
6345 </para></listitem>
6346 <listitem><para>
6347 Bitbake now checks
6348 <link linkend='var-BBFILE_COLLECTIONS'><filename>BBFILE_COLLECTIONS</filename></link>
6349 for duplicate entries and triggers an error if any are
6350 found.
6351 </para></listitem>
6352 </itemizedlist>
6353 </para>
6354 </section>
6355
6356 <section id='migration-2.7-qemu-native-splits-system-and-user-mode-parts'>
6357 <title><filename>qemu-native</filename> Splits the System and User-Mode Parts</title>
6358
6359 <para>
6360 The system and user-mode parts of <filename>qemu-native</filename>
6361 are now split.
6362 <filename>qemu-native</filename> provides the user-mode components
6363 and <filename>qemu-system-native</filename> provides the system
6364 components.
6365 If you have recipes that depend on QEMU's system emulation
6366 functionality at build time, they should now depend upon
6367 <filename>qemu-system-native</filename> instead of
6368 <filename>qemu-native</filename>.
6369 </para>
6370 </section>
6371
6372 <section id='migration-2.7-upstream-tracking.inc-removed'>
6373 <title>The <filename>upstream-tracking.inc</filename> File Has Been Removed</title>
6374
6375 <para>
6376 The previously deprecated <filename>upstream-tracking.inc</filename>
6377 file is now removed.
6378 Any <filename>UPSTREAM_TRACKING*</filename> variables are now set
6379 in the corresponding recipes instead.
6380 </para>
6381
6382 <para>
6383 Remove any references you have to the
6384 <filename>upstream-tracking.inc</filename> file in your
6385 configuration.
6386 </para>
6387 </section>
6388
6389 <section id='migration-2.7-distro-features-libc-removed'>
6390 <title>The <filename>DISTRO_FEATURES_LIBC</filename> Variable Has Been Removed</title>
6391
6392 <para>
6393 The <filename>DISTRO_FEATURES_LIBC</filename> variable is no
6394 longer used.
6395 The ability to configure glibc using kconfig has been removed
6396 for quite some time making the <filename>libc-*</filename> features
6397 set no longer effective.
6398 </para>
6399
6400 <para>
6401 Remove any references you have to
6402 <filename>DISTRO_FEATURES_LIBC</filename> in your own layers.
6403 </para>
6404 </section>
6405
6406 <section id='migration-2.7-packaging-changes'>
6407 <title>Packaging Changes</title>
6408
6409 <para>
6410 This section provides information about packaging changes.
6411 <itemizedlist>
6412 <listitem><para>
6413 <filename>bind</filename>: The
6414 <filename>nsupdate</filename> binary has been moved to
6415 the <filename>bind-utils</filename> package.
6416 </para></listitem>
6417 <listitem><para>
6418 Debug split: The default debug split has been changed to
6419 create separate source packages.
6420 </para></listitem>
6421 <listitem><para>
6422 <filename>util-linux</filename>:
6423 <itemizedlist>
6424 <listitem><para>
6425 <filename>blkdiscard</filename> has been split out
6426 into own package.
6427 </para></listitem>
6428 <listitem><para>
6429 one package per binary (pt 1:
6430 <filename>base_sbindir</filename>)
6431 </para></listitem>
6432 <listitem><para>
6433 one package per binary (pt 2:
6434 <filename>base_bindir</filename>)
6435 </para></listitem>
6436 <listitem><para>
6437 one package per binary (pt 3:
6438 <filename>sbindir</filename>)
6439 </para></listitem>
6440 <listitem><para>
6441 one package per binary (pt 4:
6442 <filename>bindir</filename>)
6443 </para></listitem>
6444 <listitem><para>
6445 <filename>/etc/default/mountall</filename> has
6446 moved into the -mount sub-package.
6447 </para></listitem>
6448 </itemizedlist>
6449 </para></listitem>
6450 <listitem><para>
6451 <filename>netbase/base-files</filename>:
6452 <filename>/etc/hosts</filename> has moved from
6453 <filename>netbase</filename> to
6454 <filename>base-files</filename>.
6455 </para></listitem>
6456 <listitem><para>
6457 <filename>tzdata</filename>: The main package has been
6458 converted to an empty meta package that pulls in all
6459 <filename>tzdata</filename> packages by default.
6460 </para></listitem>
6461 <listitem><para>
6462 <filename>lrzsz</filename>: This package has been removed
6463 from <filename>packagegroup-self-hosted</filename> and
6464 <filename>packagegroup-core-tools-testapps</filename>.
6465 The X/Y/ZModem support is less likely to be needed on
6466 modern systems.
6467 If you are relying on these packagegroups to include the
6468 <filename>lrzsz</filename> package in your image, you
6469 now need to explicitly add the package.
6470 </para></listitem>
6471 </itemizedlist>
6472 </para>
6473 </section>
6474
6475 <section id='migration-2.7-removed-recipes'>
6476 <title>Removed Recipes</title>
6477
6478 <para>
6479 The following recipes have been removed:
6480 <literallayout class='monospaced'>
6481 gcc: Drop version 7.3 recipes. Version 8.3 now remains.
6482 linux-yocto: Drop versions 4.14 and 4.18 recipes. Versions 4.19 and 5.0 remain.
6483 go: Drop version 1.9 recipes. Versions 1.11 and 1.12 remain.
6484 xvideo-tests: Became obsolete.
6485 libart-lgpl: Became obsolete.
6486 gtk-icon-utils-native: These tools are now provided by gtk+3-native
6487 gcc-cross-initial: No longer needed. gcc-cross/gcc-crosssdk are now used.
6488 gcc-crosssdk-initial: No longer needed. gcc-cross/gcc-crosssdk are now used.
6489 glibc-initial: Removed because the benefits of having it for site_config are
6490 currently outweighed by the cost of building the recipe.
6491 </literallayout>
6492 </para>
6493 </section>
6494
6495 <section id='migration-2.7-removed-classes'>
6496 <title>Removed Classes</title>
6497
6498 <para>
6499 The following classes have been removed:
6500 <literallayout class='monospaced'>
6501 distutils-tools: This class was never used.
6502 bugzilla.bbclass: Became obsolete.
6503 distrodata: This functionally has been replaced by a more modern
6504 tinfoil-based implementation.
6505 </literallayout>
6506 </para>
6507 </section>
6508
6509 <section id='migration-2.7-miscellaneous-changes'>
6510 <title>Miscellaneous Changes</title>
6511
6512 <para>
6513 The following miscellaneous changes occurred:
6514 <itemizedlist>
6515 <listitem><para>
6516 The <filename>distro</filename> subdirectory of the Poky
6517 repository has been removed from the top-level
6518 <filename>scripts</filename> directory.
6519 </para></listitem>
6520 <listitem><para>
6521 Perl added a version that builds recipes using
6522 <filename>perl-cross</filename>
6523 </para></listitem>
6524 <listitem><para>
6525 <filename>arm-tunes</filename>: Removed the "-march"
6526 option if mcpu is already added.
6527 </para></listitem>
6528 <listitem><para>
6529 <filename>update-alternatives</filename>: Convert file
6530 renames to
6531 <link linkend='var-PACKAGE_PREPROCESS_FUNCS'><filename>PACKAGE_PREPROCESS_FUNCS</filename></link>
6532 </para></listitem>
6533 <listitem><para>
6534 <filename>base/pixbufcache</filename>: Obsolete
6535 <filename>sstatecompletions</filename> code has been
6536 removed.
6537 </para></listitem>
6538 <listitem><para>
6539 <link linkend='ref-classes-native'><filename>native</filename></link>
6540 class:
6541 <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link>
6542 handling has been enabled.
6543 </para></listitem>
6544 <listitem><para>
6545 <filename>inetutils</filename>: This recipe has rsh
6546 disabled.
6547 </para></listitem>
6548 </itemizedlist>
6549 </para>
6550 </section>
6551</section>
6328</chapter> 6552</chapter>
6329<!-- 6553<!--
6330vim: expandtab tw=80 ts=4 6554vim: expandtab tw=80 ts=4
generated by cgit v1.2.3-54-g00ecf (git 2.39.0) at 2025-12-14 23:23:05 +0000