Gentoo Archives: gentoo-commits

From: "Gilles Dartiguelongue (eva)" <eva@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/proj/en/desktop/gnome/howtos: gnome-2.26-upgrade.xml
Date: Tue, 28 Jul 2009 22:13:22
Message-Id: E1MVuvA-0007mG-Ne@stork.gentoo.org
1 eva 09/07/28 22:13:20
2
3 Added: gnome-2.26-upgrade.xml
4 Log:
5 First go at Gnome 2.26 upgrade guide.
6
7 Revision Changes Path
8 1.1 xml/htdocs/proj/en/desktop/gnome/howtos/gnome-2.26-upgrade.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/gnome/howtos/gnome-2.26-upgrade.xml?rev=1.1&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/gnome/howtos/gnome-2.26-upgrade.xml?rev=1.1&content-type=text/plain
12
13 Index: gnome-2.26-upgrade.xml
14 ===================================================================
15 <?xml version="1.0" encoding="UTF-8"?>
16 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
17 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/gnome/howtos/gnome-2.26-upgrade.xml,v 1.1 2009/07/28 22:13:20 eva Exp $ -->
18
19 <guide link="/proj/en/desktop/gnome/howtos/gnome-2.26-upgrade.xml">
20 <title>Gnome 2.26 Upgrade Guide</title>
21
22 <author title="Author">
23 <mail link="eva"/>
24 </author>
25
26 <abstract>
27 This is a guide for upgrading from GNOME 2.24.x to GNOME 2.26.x.
28 </abstract>
29
30 <!-- The content of this document is licensed under the CC-BY-SA license -->
31 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
32 <license/>
33
34 <version>1.0</version>
35 <date>2009-07-28</date>
36
37 <chapter>
38 <title>Changes</title>
39 <section>
40 <title>Session handling</title>
41 <body>
42
43 <p>
44 Due to a major rewrite of <c>gnome-base/gnome-session</c>, saved sessions will
45 most likely be lost because of a change in the format.
46 </p>
47
48 </body>
49 </section>
50 <section>
51 <title>Brasero Disc Burner</title>
52 <body>
53
54 <p>
55 Starting with 2.26, Brasero (<c>app-cdr/brasero</c>) is the official optical
56 media burning utility. It replaces nautilus CD burner
57 (<c>gnome-extra/nautilus-cd-burner</c>) completely by providing an extension to
58 nautilus that behaves the same way nautilus CD burner did and an application to
59 do more advanced tasks.
60 </p>
61
62 <p>
63 If you are happy with Brasero after completing the GNOME upgrade, you may
64 consider uninstalling <c>gnome-extra/nautilus-cd-burner</c>.
65 </p>
66
67 </body>
68 </section>
69 <section>
70 <title>Pulseaudio integration</title>
71 <body>
72
73 <p>
74 GNOME 2.26 now offers a complete pulseaudio integration. Please note that on
75 some hardware, enabling pulseaudio USE flag means that you will have to enable
76 its support in other application using sound output (ie. mplayer).
77 </p>
78
79 </body>
80 </section>
81 <section>
82 <title>gnome-desktop API changes</title>
83 <body>
84
85 <p>
86 Due to the GNOME goal of killing old libraries usage, gnome-desktop changed its
87 API again. It should not break anything while upgrading but do not forget to run
88 revdep-rebuild or emerge @preserved-rebuild at then end of the upgrade process
89 and check that the old library is gone.
90 </p>
91
92 </body>
93 </section>
94 <section>
95 <title>gnome-menus and KDE file-collision changes</title>
96 <body>
97
98 <p>
99 Due to file-collision between GNOME menus and KDE's own menus,
100 <c>gnome-base/gnome-menus</c> was changed to use a prefixed location for its
101 menu. If you are using a login manager and loose your menu, please re-select
102 gnome as your session at login prompt. If you start gnome by hand, please
103 export XDG_MENU_PREFIX=gnome- to get your menu back. See
104 <uri link="http://bugs.gentoo.org/256614">bug #256614</uri> for details.
105 </p>
106
107 </body>
108 </section>
109 <section>
110 <title>Other changes</title>
111 <body>
112
113 <p>
114 Please see the <uri
115 link="http://library.gnome.org/misc/release-notes/2.26/">GNOME 2.26 Release
116 Notes</uri> for what else new is in this major release of GNOME.
117 </p>
118
119 </body>
120 </section>
121 </chapter>
122
123 <chapter>
124 <title>Kwown Issues</title>
125 <section>
126 <title>Nautilus constantly restarting</title>
127 <body>
128
129 <p>
130 With gnome-session rewrite, nautilus is consider as an insecable part of the
131 GNOME desktop. Unfortunately, since nautilus exists when it does not handle the
132 desktop, it will be automatically and immediately respawned by gnome-session
133 resulting in an infinite nautilus spawning loop. See
134 <uri link="http://bugs.gentoo.org/266398">bug #266398</uri> for updates on this
135 issue.
136 </p>
137
138 </body>
139 </section>
140 <section>
141 <title>gnome-base/gnome-keyring build failures</title>
142 <body>
143
144 <p>
145 Due to changes in RPC code, gnome-keyring fails to build its API documentation
146 and to pass its tests. These issues are tracked at
147 <uri link="http://bugs.gentoo.org/272450">bug #272450</uri> and at
148 <uri link="http://bugs.gentoo.org/267957">bug #267957</uri>.
149 </p>
150
151 </body>
152 </section>
153 <section>
154 <title>net-libs/libsoup does not build with USE="-gnome doc"</title>
155 <body>
156
157 <p>
158 During GNOME 2.26 development cycle, libsoup got split into libsoup and
159 libsoup-gnome which contains GNOME oriented functions. The problem is that the
160 documentation does not reflect this split so well. Progress is tracked at
161 <uri link="http://bugs.gentoo.org/268592">bug #268592</uri>.
162 </p>
163
164 </body>
165 </section>
166 </chapter>
167 </guide>