Gentoo Logo

Disclaimer : This document is not valid and is not maintained anymore.

Gnome 2.26 Upgrade Guide


1.  Changes

Session handling

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

Brasero Disc Burner

Starting with 2.26, Brasero (app-cdr/brasero) is the official optical 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 to this, it also provides its own interface for more complex tasks.

If you are happy with Brasero after completing the GNOME upgrade, you may consider uninstalling gnome-extra/nautilus-cd-burner.

Pulseaudio integration

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 applications using sound output (e.g. mplayer). You may want to refer to the official pulseaudio documentation for setting it up.

gnome-desktop API changes

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 process and check that the old library is gone.

GNOME and KDE menu file-collision

Due to file-collision between GNOME menus and KDE's own menus, gnome-base/gnome-menus was changed to use a prefixed location for its menu. It means that menus can disappear in the middle of the upgrade. To get them back, just make sure you install >=gnome-base/gnome-session-2.26.2 and >=gnome-base/gnome-menus-2.26.2.

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 and have a custom .xinitrc , please export XDG_MENU_PREFIX=gnome- to get your menu back. If you start gnome by hand but have no .xinitrc, just export XSESSION=Gnome. See bug #256614 and bug #279555 for details.

Other changes

Please see the GNOME 2.26 Release Notes for what else new is in this major release of GNOME.

2.  Known Issues

Nautilus constantly restarting

With the gnome-session rewrite, gnome-base/nautilus is considered as a basic part of the GNOME desktop. However, configuring nautilus so that it doesn't handle the desktop results in gnome-base/gnome-session repeatedly spawning multiple instances of it at login.

Currently the workaround is to not configure nautilus in such a way. See bug #266398 for updates on this issue.


Page updated September 29, 2009

Summary: This is a guide for upgrading from GNOME 2.24.x to GNOME 2.26.x.

Gilles Dartiguelongue

Donate to support our development efforts.

Copyright 2001-2015 Gentoo Foundation, Inc. Questions, Comments? Contact us.