summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--documentation/ref-manual/migration.xml304
1 files changed, 254 insertions, 50 deletions
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index f0a03d2e78..7ebc10a76d 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -240,56 +240,260 @@
240 Yocto Project 1.4 Release from the prior release. 240 Yocto Project 1.4 Release from the prior release.
241 </para> 241 </para>
242 242
243 <para> 243 <section id='migration-1.4-bitbake'>
244 Here is the raw text from Paul: 244 <title>BitBake</title>
245 <literallayout class='monospaced'> 245
246* BitBake - Fix continuation on last line of a comment: if a comment ends in a line continuation (\) then the next line must also be a comment; any instance where this is not the case will now trigger a warning. Either remove the continuation character or make the next line a comment as well. 246 <para>
247 247 Differences include the following:
248* BitBake - The runtime package specific variables (RDEPENDS, RRECOMMENDS, RSUGGESTS, RPROVIDES, RCONFLICTS, RREPLACES, FILES, ALLOW_EMPTY, and the pre/post install/uninstall script functions pkg_preinst, pkg_postinst, pkg_prerm, and pkg_postrm) should always have a package name override, for example RDEPENDS_${PN} for the main package instead of RDEPENDS; there are now stricter checks at parse time to ensure this is done in all recipes. 248 <itemizedlist>
249 249 <listitem><para><emphasis>Comment Continuation:</emphasis>
250* Build Behavior - Shared state code has been optimised to avoid running tasks that are not really needed; for example, bitbake -c rootfs some-image from shared state will no longer populate the target sysroot since that is not necessary - the system just needs to extract the output package contents, re-create the packages and construct the root filesystem. This is unlikely to cause any problems unless you have missing declared dependencies. 250 If a comment ends with a line continuation (\) character,
251 251 then the next line must also be a comment.
252* Proxies and Fetching Source - A new oe-git-proxy script has been added to replace previous methods of handling proxies and fetching source from Git. See meta-yocto/conf/site.conf.sample for information on how to use this script. 252 Any instance where this is not the case, now triggers
253 253 a warning.
254* Build Behavior - When scanning for files in SRC_URI, the system now uses FILESOVERRIDES instead of OVERRIDES for the directory names. All of the sensible values previously in OVERRIDES are now in FILESOVERRIDES as well, however if you relied upon an additional value you added to OVERRIDES you may now need to add it to FILESOVERRIDES (unless you are already adding it via the MACHINEOVERRIDES or DISTROOVERRIDES variables, where this is appropriate). 254 You must either remove the continuation character, or be
255 255 sure the next line is a comment.
256* Remote Debugging - Support for remote debugging with the Eclipse IDE has been split out into a separate image feature (eclipse-debug) corresponding to the packagegroup-core-eclipse-debug package group. (Previously this was included in the tools-debug image feature which corresponds to the packagegroup-core-tools-debug package group.) 256 </para></listitem>
257 257 <listitem><para><emphasis>Package Name Overrides:</emphasis>
258* Variables - SANITY_TESTED_DISTROS now uses a distro ID composed of the host distributor ID followed by the release, rather than the description field being used previously (so "Ubuntu 12.10" becomes "Ubuntu-12.10"). If you aren't setting this variable (or are setting it to "") you don't need to worry about this. 258 The runtime package specific variables
259 259 <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link>,
260* Items Removed 260 <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>,
261- mesa-dri renamed to mesa 261 <filename>RSUGGESTS</filename>,
262- Gtk+ DirectFB support has been removed since it is no longer supported in upstream Gtk+ as of version 2.18 262 <filename>RPROVIDES</filename>,
263- linux-yocto 3.0 kernel has been removed and a version 3.8 has been added 263 <link linkend='var-RCONFLICTS'><filename>RCONFLICTS</filename></link>,
264- mesa-xlib removed - no longer useful 264 <link linkend='var-RREPLACES'><filename>RREPLACES</filename></link>,
265- polkit removed - now in the meta-oe layer 265 <link linkend='var-FILES'><filename>FILES</filename></link>,
266- libmusicbrainz removed - now in the meta-multimedia layer 266 <link linkend='var-ALLOW_EMPTY'><filename>ALLOW_EMPTY</filename></link>,
267- zeroconf removed - now in the meta-networking layer 267 and the pre, post, install, and uninstall script functions
268- web removed - unmaintained and superseded by web-webkit 268 <filename>pkg_preinst</filename>,
269- gtkhtml2 removed - now in the meta-oe layer 269 <filename>pkg_postinst</filename>,
270- clutter-box2d removed - now in the meta-oe layer 270 <filename>pkg_prerm</filename>, and
271- orinoco-conf removed - obsolete 271 <filename>pkg_postrm</filename> should always have a
272- matchbox-stroke removed - was never more than a proof-of-concept 272 package name override.
273- update-modules removed - no longer used (kernel module postinstall/postrm scripts can now do the same task without the use of this script) 273 For example, use <filename>RDEPENDS_${PN}</filename> for
274- zypper / libzypp / sat-solver removed - these have been functionally replaced with Smart (python-smartpm) when RPM packaging is used and package management is enabled on the target. 274 the main package instead of <filename>RDEPENDS</filename>.
275- libcanberra removed - now in the meta-gnome layer 275 BitBake uses more strict checks when it parses recipes.
276- metacity removed - now in the meta-gnome layer 276 </para></listitem>
277- gupnp removed - now in the meta-multimedia layer 277 </itemizedlist>
278- libgdata removed - now in the meta-gnome layer 278 </para>
279- gthumb removed - now in the meta-gnome layer 279 </section>
280- mutter removed - never used by anything else and recipe was very old 280
281- gypsy removed - now in the meta-oe layer 281 <section id='migration-1.4-build-behavior'>
282- matchbox-wm-2 / matchbox-theme-sato-2 removed - unmaintained (matchbox-wm / matchbox-theme-sato still provided) 282 <title>Build Behavior</title>
283- lsbsetup removed - functionality now provided by lsbtest 283
284- evolution-data-server removed - now in the meta-gnome layer 284 <para>
285- xf86bigfontproto removed - disabled by default upstream since 2007, nothing uses it 285 Differences include the following:
286- evieext removed - removed from xserver in 2008 286 <itemizedlist>
287- xf86rushproto removed - dependency in xserver was spurious and was removed in 2005 287 <listitem><para><emphasis>Shared State Code:</emphasis>
288- libxfontcache / xfontcacheproto removed - removed from the Xorg server in 2008 288 The shared state code has been optimized to avoid running
289- libxp / libxprintapputil / libxprintutil / printproto removed - the XPrint server was removed from Xorg in 2008 289 unnecessary tasks.
290- libxtrap / xtrapproto removed - functionality was broken upstream so it was removed 290 For example,
291 </literallayout> 291 <filename>bitbake -c rootfs some-image</filename> from
292 </para> 292 shared state no longer populates the target sysroot
293 since that is not necessary.
294 Instead, the system just needs to extract the output
295 package contents, re-create the packages, and construct
296 the root filesystem.
297 This change is unlikely to cause any problems unless
298 you have missing declared dependencies.
299 </para></listitem>
300 <listitem><para><emphasis>Scanning Directory Names:</emphasis>
301 When scanning for files in
302 <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link>,
303 the build system now uses <filename>FILESOVERRIDES</filename>
304 instead of <filename>OVERRIDES</filename> for the directory
305 names.
306 In general, the values previously in
307 <filename>OVERRIDES</filename> are now in
308 <filename>FILESOVERRIDES</filename> as well.
309 However, if you relied upon an additional value
310 you previously added to <filename>OVERRIDES</filename>,
311 you might now need to add it to
312 <filename>FILESOVERRIDES</filename> unless you are already
313 adding it through the <filename>MACHINEOVERRIDES</filename>
314 or <filename>DISTROOVERRIDES</filename> variables,
315 as appropriate.
316 </para></listitem>
317 </itemizedlist>
318 </para>
319 </section>
320
321
322 <section id='migration-1.4-proxies-and-fetching-source'>
323 <title>Proxies and Fetching Source</title>
324
325 <para>
326 A new <filename>oe-git-proxy</filename> script has been added to
327 replace previous methods of handling proxies and fetching source
328 from Git.
329 See the <filename>meta-yocto/conf/site.conf.sample</filename> file
330 for information on how to use this script.
331 </para>
332 </section>
333
334 <section id='migration-1.4-remote-debugging'>
335 <title>Remote Debugging</title>
336
337 <para>
338 Support for remote debugging with the Eclipse IDE is now
339 separated into an image feature
340 (<filename>eclipse-debug</filename>) that corresponds to the
341 <filename>packagegroup-core-eclipse-debug</filename> package group.
342 Previously, the debugging feature was included through the
343 <filename>tools-debug</filename> image feature, which corresponds
344 to the <filename>packagegroup-core-tools-debug</filename>
345 package group.
346 </para>
347 </section>
348
349 <section id='migration-1.4-variables'>
350 <title>Variables</title>
351
352 <para>
353 The <filename>SANITY_TESTED_DISTROS</filename> variable now uses a
354 distribution ID, which is composed of the host distributor ID
355 followed by the release.
356 Previously, it was composed of the description field.
357 For example, "Ubuntu 12.10" becomes "Ubuntu-12.10".
358 You do not need to worry about this change if you are not
359 specifically setting this variable, or if you are
360 specifically setting it to "".
361 </para>
362 </section>
363
364 <section id='migration-1.4-removals-and-renames'>
365 <title>Removals and Renames</title>
366
367 <para>
368 The following list shows what has been removed or renamed:
369 <itemizedlist>
370 <listitem><para><emphasis><filename>mesa-dri</filename>:</emphasis>
371 Renamed to <filename>mesa</filename>.
372 </para></listitem>
373 <listitem><para><emphasis><filename>Gtk+ DirectFB</filename>:</emphasis>
374 Removed support because upstream Gtk+ no longer supports it
375 as of version 2.18.
376 </para></listitem>
377 <listitem><para><emphasis><filename>linux-yocto 3.0 kernel</filename>:</emphasis>
378 Removed with linux-yocto 3.8 kernel being added.
379 </para></listitem>
380 <listitem><para><emphasis><filename>mesa-xlib</filename>:</emphasis>
381 Removed because it was no longer useful.
382 </para></listitem>
383 <listitem><para><emphasis><filename>polkit</filename>:</emphasis>
384 Removed from its previous location and now resides in the
385 <filename>meta-oe</filename> layer.
386 </para></listitem>
387 <listitem><para><emphasis><filename>libmusicbrainz</filename>:</emphasis>
388 Removed from its previous location and now resides in the
389 <filename>meta-multimedia</filename> layer.
390 </para></listitem>
391 <listitem><para><emphasis><filename>zeroconf</filename>:</emphasis>
392 Removed from its previous location and now resides in the
393 <filename>meta-networking</filename> layer.
394 </para></listitem>
395 <listitem><para><emphasis><filename>web</filename>:</emphasis>
396 Removed because it is not maintained. Superseded by
397 <filename>web-webkit</filename>.
398 </para></listitem>
399 <listitem><para><emphasis><filename>gtkhtml2</filename>:</emphasis>
400 Removed from its previous location and now resides in the
401 <filename>meta-oe</filename> layer.
402 </para></listitem>
403 <listitem><para><emphasis><filename>gtkhtml2</filename>:</emphasis>
404 Removed from its previous location and now resides in the
405 <filename>meta-oe</filename> layer.
406 </para></listitem>
407 <listitem><para><emphasis><filename>clutter-box2d</filename>:</emphasis>
408 Removed from its previous location and now resides in the
409 <filename>meta-oe</filename> layer.
410 </para></listitem>
411 <listitem><para><emphasis><filename>orinoco-conf</filename>:</emphasis>
412 Removed because it has become obsolete.
413 </para></listitem>
414 <listitem><para><emphasis><filename>omatchbox-stroke</filename>:</emphasis>
415 Removed because it was never more than a proof-of-concept.
416 </para></listitem>
417 <listitem><para><emphasis><filename>update-modules</filename>:</emphasis>
418 Removed because it is no longer used.
419 The kernel module <filename>postinstall</filename> and
420 <filename>postrm</filename> scripts can now do the same
421 task without the use of this script.
422 </para></listitem>
423 <listitem><para><emphasis><filename>zypper / libzypp / sat-solver</filename>:</emphasis>
424 Removed and been functionally replaced with Smart
425 (<filename>python-smartpm</filename>) when RPM packaging
426 is used and package management is enabled on the target.
427 </para></listitem>
428 <listitem><para><emphasis><filename>libcanberra</filename>:</emphasis>
429 Removed from its previous location and now resides in the
430 <filename>meta-gnome</filename> layer.
431 </para></listitem>
432 <listitem><para><emphasis><filename>metacity</filename>:</emphasis>
433 Removed from its previous location and now resides in the
434 <filename>meta-gnome</filename> layer.
435 </para></listitem>
436 <listitem><para><emphasis><filename>gupnp</filename>:</emphasis>
437 Removed from its previous location and now resides in the
438 <filename>meta-multimedia</filename> layer.
439 </para></listitem>
440 <listitem><para><emphasis><filename>libgdata</filename>:</emphasis>
441 Removed from its previous location and now resides in the
442 <filename>meta-gnome</filename> layer.
443 </para></listitem>
444 <listitem><para><emphasis><filename>gthumb</filename>:</emphasis>
445 Removed from its previous location and now resides in the
446 <filename>meta-gnome</filename> layer.
447 </para></listitem>
448 <listitem><para><emphasis><filename>mutter</filename>:</emphasis>
449 Removed because nothing ever uses it and the recipe is
450 very old.
451 </para></listitem>
452 <listitem><para><emphasis><filename>gypsy</filename>:</emphasis>
453 Removed from its previous location and now resides in the
454 <filename>meta-oe</filename> layer.
455 </para></listitem>
456 <listitem><para><emphasis><filename>matchbox-wm-2 / matchbox-theme-sato-2</filename>:</emphasis>
457 Removed because they are not maintained.
458 However, <filename>matchbox-wm</filename> and
459 <filename>matchbox-theme-sato</filename> are still
460 provided.
461 </para></listitem>
462 <listitem><para><emphasis><filename>lsbsetup</filename>:</emphasis>
463 Removed with functionality now provided by
464 <filename>lsbtest</filename>.
465 </para></listitem>
466 <listitem><para><emphasis><filename>evolution-data-server</filename>:</emphasis>
467 Removed from its previous location and now resides in the
468 <filename>meta-gnome</filename> layer.
469 </para></listitem>
470 <listitem><para><emphasis><filename>xf86bigfontproto</filename>:</emphasis>
471 Removed because upstream it has been disabled by default
472 since 2007.
473 Nothing uses <filename>xf86bigfontproto</filename>.
474 </para></listitem>
475 <listitem><para><emphasis><filename>evieext</filename>:</emphasis>
476 Removed because it has been removed from
477 <filename>xserver</filename> since 2008.
478 </para></listitem>
479 <listitem><para><emphasis><filename>xf86rushproto</filename>:</emphasis>
480 Removed because its dependency in
481 <filename>xserver</filename> was spurious and it was
482 removed in 2005.
483 </para></listitem>
484 <listitem><para><emphasis><filename>libxfontcache / xfontcacheproto</filename>:</emphasis>
485 Removed because they were removed from the Xorg server in 2008.
486 </para></listitem>
487 <listitem><para><emphasis><filename>libxp / libxprintapputil / libxprintutil / printproto</filename>:</emphasis>
488 Removed because the XPrint server was removed from
489 Xorg in 2008.
490 </para></listitem>
491 <listitem><para><emphasis><filename>libxtrap / xtrapproto</filename>:</emphasis>
492 Removed because their functionality was broken upstream.
493 </para></listitem>
494 </itemizedlist>
495 </para>
496 </section>
293</section> 497</section>
294</chapter> 498</chapter>
295<!-- 499<!--