Gnome 2.26 Upgrade Guide

-Due to a major rewrite of gnome-base/gnome-session, saved session= s will -most likely be lost because of a change in the format. +Due to a major rewrite of gnome-base/gnome-session, existing save= d +sessions will most likely be lost because of a change in the format.

Starting with 2.26, Brasero (app-cdr/brasero) is the official opt= ical -media burning utility. It replaces nautilus CD burner -(gnome-extra/nautilus-cd-burner) completely by providing an exten= sion to -nautilus that behaves the same way nautilus CD burner did and an applica= tion to -do more advanced tasks. +media burning utility. It completely replaces nautilus CD burner +(gnome-extra/nautilus-cd-burner) by providing an extension to +nautilus that behaves the same way nautilus CD burner did. In addition t= o this, +it also provides its own interface for more complex tasks.

-GNOME 2.26 now offers a complete pulseaudio integration. Please note tha= t on +GNOME 2.26 now offers complete pulseaudio integration. Please note that = on some hardware, enabling pulseaudio USE flag means that you will have to = enable -its support in other application using sound output (ie. mplayer). +its support in other application using sound output (e.g., mplayer). You= may want +to refer to the official +pulseaudio documentation for setting it up.

-Due to the GNOME goal of killing old libraries usage, gnome-desktop chan= ged its -API again. It should not break anything while upgrading but do not forge= t to run -revdep-rebuild or emerge @preserved-rebuild at then end of the upgrade p= rocess +Due to the GNOME goal of +removing deprecated libraries usage, gnome-desktop changed its API again= . It +should not break anything while upgrading but do not forget to run +revdep-rebuild or emerge @preserved-rebuild at the end of the upgrade pr= ocess and check that the old library is gone.

-gnome-menus and KDE file-collision changes +GNOME and KDE menu file-collision =20

@@ -90,9 +93,9 @@

=09

-If you are using a login manager and loose your menu, please re-select -gnome as your session at login prompt. If you start gnome by hand and ha= ve a -custom .xinitrc , please export XDG_MENU_PREFIX=3Dgnome- to get your men= u back. +If you are using a login manager and lose your menu, please re-select +gnome as your session at the login prompt. If you start gnome by hand an= d have +a custom .xinitrc , please export XDG_MENU_PREFIX=3Dgnome- to get your m= enu back. If you start gnome by hand but have no .xinitrc, just export XSESSION=3D= Gnome. See bug #256614 and=20 bug #279555 for detail= s. @@ -121,38 +124,16 @@ =20

-With gnome-session rewrite, nautilus is consider as an insecable part of= the -GNOME desktop. Unfortunately, since nautilus exists when it does not han= dle the -desktop, it will be automatically and immediately respawned by gnome-ses= sion -resulting in an infinite nautilus spawning loop. See -bug #266398 for update= s on this -issue. +With the gnome-session rewrite, gnome-base/nautilus is considered= as a +basic part of the GNOME desktop. However, configuring nautilus so that i= t +doesn't handle the desktop results in gnome-base/gnome-session re= peatedly +spawning multiple instances of it at login.

=20 - -

-net-libs/libsoup does not build with USE=3D"-gnome doc" - -

-During GNOME 2.26 development cycle, libsoup got split into libsoup and -libsoup-gnome which contains GNOME oriented functions. The problem is th= at the -documentation does not reflect this split so well. Progress is tracked a= t -bug #268592. +Currently the workaround is to not configure nautilus in such a w= ay. +See bug #266398 for up= dates on +this issue.

=20