| 1 |
commit: 746e81006151a43402368c3bb81bb3b3dbbf4e97 |
| 2 |
Author: Alexandre Rostovtsev <tetromino <AT> gmail <DOT> com> |
| 3 |
AuthorDate: Sun Jul 31 03:00:08 2011 +0000 |
| 4 |
Commit: Alexandre Restovtsev <tetromino <AT> gmail <DOT> com> |
| 5 |
CommitDate: Sun Jul 31 03:00:08 2011 +0000 |
| 6 |
URL: http://git.overlays.gentoo.org/gitweb/?p=proj/gnome.git;a=commit;h=746e8100 |
| 7 |
|
| 8 |
status: first draft of the upgrade guide |
| 9 |
|
| 10 |
--- |
| 11 |
status/gnome-3.0-upgrade.xml | 234 ++++++++++++++++++++++++++++++++++++++++++ |
| 12 |
1 files changed, 234 insertions(+), 0 deletions(-) |
| 13 |
|
| 14 |
diff --git a/status/gnome-3.0-upgrade.xml b/status/gnome-3.0-upgrade.xml |
| 15 |
new file mode 100644 |
| 16 |
index 0000000..124b45a |
| 17 |
--- /dev/null |
| 18 |
+++ b/status/gnome-3.0-upgrade.xml |
| 19 |
@@ -0,0 +1,234 @@ |
| 20 |
+<?xml version="1.0" encoding="UTF-8"?> |
| 21 |
+<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 22 |
+<!-- $Header$ --> |
| 23 |
+ |
| 24 |
+<guide link="/proj/en/desktop/gnome/howtos/gnome-3.0-upgrade.xml" lang="en"> |
| 25 |
+<title>Gnome 3.0 Upgrade Guide</title> |
| 26 |
+ |
| 27 |
+<author title="Alexandre Rostovtsev"> |
| 28 |
+ <mail link="tetromino@×××××.com">Alexandre Rostovtsev</mail> |
| 29 |
+</author> |
| 30 |
+ |
| 31 |
+<abstract> |
| 32 |
+This is a guide for upgrading from GNOME 2.32.x to GNOME 3.0.x |
| 33 |
+</abstract> |
| 34 |
+ |
| 35 |
+<!-- The content of this document is licensed under the CC-BY-SA license --> |
| 36 |
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 37 |
+<license/> |
| 38 |
+ |
| 39 |
+<version>0.1</version> |
| 40 |
+<date>2011-07-30</date> |
| 41 |
+ |
| 42 |
+<chapter> |
| 43 |
+<title>Changes</title> |
| 44 |
+ |
| 45 |
+<section> |
| 46 |
+<title>General changes</title> |
| 47 |
+<body> |
| 48 |
+ |
| 49 |
+<p> |
| 50 |
+Please see the <uri link="http://library.gnome.org/misc/release-notes/3.0/">GNOME |
| 51 |
+3.0 Release Notes</uri> for what is new in this major release of GNOME. |
| 52 |
+</p> |
| 53 |
+ |
| 54 |
+<p> |
| 55 |
+Briefly: GNOME 3.0 includes two desktop modes—standard and fallback. |
| 56 |
+Fallback mode uses <c>gnome-base/gnome-panel</c> and <c>x11-wm/metacity</c>, and |
| 57 |
+is similar in appearance and behavior to GNOME 2. Standard mode uses |
| 58 |
+<c>gnome-base/gnome-shell</c> and <c>x11-wm/mutter</c>, and looks and behaves |
| 59 |
+<e>completely</e> differently from previous GNOME releases. By default, the |
| 60 |
+choice of desktop mode is determined by the system's graphics hardware and |
| 61 |
+drivers (the standard mode requires modern 3D graphics capabilities). |
| 62 |
+</p> |
| 63 |
+ |
| 64 |
+<p>For a comprehensive introduction to using standard mode's GNOME Shell, please |
| 65 |
+see <uri link="https://live.gnome.org/GnomeShell/CheatSheet">the GNOME Shell |
| 66 |
+cheat sheet</uri>. GNOME Shell at first may feel alien and limited to an |
| 67 |
+experienced GNOME 2 user. We strongly encourage users to persist and force |
| 68 |
+themselves to use GNOME Shell for a few days; users who take the time to get |
| 69 |
+used to GNOME Shell's behavior grow to love it and don't want to go back to an |
| 70 |
+old-fashioned GNOME 2-like desktop environment. |
| 71 |
+</p> |
| 72 |
+</body> |
| 73 |
+</section> |
| 74 |
+ |
| 75 |
+<section> |
| 76 |
+<title>Languages and encodings</title> |
| 77 |
+<body> |
| 78 |
+ |
| 79 |
+<p> |
| 80 |
+GNOME 3.0 obtains user language settings from <c>sys-apps/accountsservice</c>. |
| 81 |
+The language can be set in GNOME from the <e>My Account</e> entry in the upper |
| 82 |
+right corner menu. Alternatively, you can directly edit accountsservice user |
| 83 |
+files. For example, to have user <c>jrandom</c> use British English with UTF-8 |
| 84 |
+Unicode text encoding, you can (as root) edit |
| 85 |
+<c>/var/lib/AccountsService/users/jrandom</c> so it reads the following: |
| 86 |
+</p> |
| 87 |
+<pre> |
| 88 |
+[User] |
| 89 |
+Language=en_GB.utf8 |
| 90 |
+</pre> |
| 91 |
+ |
| 92 |
+</body> |
| 93 |
+</section> |
| 94 |
+ |
| 95 |
+<section> |
| 96 |
+<title>Fonts</title> |
| 97 |
+<body> |
| 98 |
+ |
| 99 |
+<p> |
| 100 |
+GNOME 3.0 uses <c>media-fonts/cantarell</c> as its default font. Unfortunately, |
| 101 |
+Cantarell only includes a subset of the extended Latin alphabet. Users of |
| 102 |
+languages whose writing systems are not covered by Cantarell will probably want |
| 103 |
+to switch to another font, such as <c>media-fonts/dejavu</c>: |
| 104 |
+</p> |
| 105 |
+ |
| 106 |
+<pre caption="Set DejaVu (size 10) as the default font"> |
| 107 |
+$ <i>export GSETTINGS_BACKEND=dconf</i> |
| 108 |
+$ <i>gsettings set org.gnome.desktop.interface font-name 'DejaVu Sans 10'</i> |
| 109 |
+$ <i>gsettings set org.gnome.desktop.interface document-font-name 'DejaVu Sans 10'</i> |
| 110 |
+$ <i>gconftool-2 -s -t string /apps/metacity/general/titlebar_font 'DejaVu Sans Bold 10'</i> |
| 111 |
+</pre> |
| 112 |
+ |
| 113 |
+</body> |
| 114 |
+</section> |
| 115 |
+ |
| 116 |
+<section> |
| 117 |
+<title>Applets <e>(FIXME add a gnome-applets snapshot)</e></title> |
| 118 |
+<body> |
| 119 |
+<p> |
| 120 |
+GNOME 2 applets cannot be used in GNOME 3.0. The fallback mode allows applets, |
| 121 |
+although most have not yet been ported to the new, gtk3-based APIs. In the |
| 122 |
+standard mode, there are no applets at all. Some traditional applet |
| 123 |
+functionality can be replicated using third-party GNOME Shell extensions. |
| 124 |
+</p> |
| 125 |
+</body> |
| 126 |
+</section> |
| 127 |
+ |
| 128 |
+<section> |
| 129 |
+<title>Shut down and reboot <e>(FIXME: fix bug 377107)</e> </title> |
| 130 |
+<body> |
| 131 |
+<p> |
| 132 |
+GNOME Shell developers made a <uri |
| 133 |
+link="https://live.gnome.org/GnomeShell/Design/Whiteboards/SystemStopRestart">controversial |
| 134 |
+decision</uri> to not show any sort of shut down or power off menu by default. |
| 135 |
+The <em>Power Off</em> menu item becomes visible after clicking on the upper |
| 136 |
+right corner menu and holding down Alt. |
| 137 |
+</p> |
| 138 |
+ |
| 139 |
+<p> |
| 140 |
+If you need an easily discoverable GUI for shutting down the machine (for |
| 141 |
+example, if deploying GNOME 3.0 in a corporate environment where users are |
| 142 |
+required to turn off their computers at the end of the day), you can install the |
| 143 |
+alternative-status-menu extension. To do so, add |
| 144 |
+<c>GNOME_SHELL_EXTENSIONS="alternative-status-menu"</c> to your |
| 145 |
+<c>/etc/make.conf</c>, and emerge <c>gnome-extra/gnome-shell-extensions</c>. |
| 146 |
+</p> |
| 147 |
+ |
| 148 |
+</body> |
| 149 |
+</section> |
| 150 |
+ |
| 151 |
+<section> |
| 152 |
+<title>Icons on the desktop</title> |
| 153 |
+<body> |
| 154 |
+ |
| 155 |
+<p> |
| 156 |
+In GNOME 3.0, Nautilus by default no longer manages the desktop, and the |
| 157 |
+<c>~/Desktop</c> folder is simply treated as a normal folder with files. |
| 158 |
+</p> |
| 159 |
+ |
| 160 |
+</body> |
| 161 |
+</section> |
| 162 |
+ |
| 163 |
+<section> |
| 164 |
+<title>General configurability and extensions</title> |
| 165 |
+<body> |
| 166 |
+ |
| 167 |
+<p> |
| 168 |
+GNOME 3.0 is designed to appear significantly less configurable than GNOME 2. |
| 169 |
+For example, by default there is no easily discoverable GUI for changing the |
| 170 |
+Gtk+ theme. Many configuration settings are hidden, but can still be changed |
| 171 |
+from dconf, gconf, or <c>gnome-extra/gnome-tweak-tool</c>. Discussion of such |
| 172 |
+hidden settings is outside the scope of this document. |
| 173 |
+</p> |
| 174 |
+ |
| 175 |
+<p> |
| 176 |
+GNOME Shell's behavior can be significantly altered using <uri |
| 177 |
+link="https://live.gnome.org/GnomeShell/Extensions">extensions</uri>. Gentoo |
| 178 |
+packages the extensions from the official GNOME repository as |
| 179 |
+<c>gnome-extra/gnome-shell-extensions</c>; there are also numerous third-party |
| 180 |
+developers publishing extensions on various websites. |
| 181 |
+</p> |
| 182 |
+ |
| 183 |
+<impo> |
| 184 |
+By default, GNOME Shell loads all installed extensions. However, extension code |
| 185 |
+quality is highly variable, and some extensions can render GNOME completely |
| 186 |
+unusable. Gentoo cannot offer support for problems caused by third-party |
| 187 |
+extensions. |
| 188 |
+</impo> |
| 189 |
+ |
| 190 |
+</body> |
| 191 |
+</section> |
| 192 |
+ |
| 193 |
+</chapter> |
| 194 |
+ |
| 195 |
+<chapter> |
| 196 |
+<title>Troubleshooting</title> |
| 197 |
+ |
| 198 |
+<section> |
| 199 |
+<title>GDM freezes after the password has been entered</title> |
| 200 |
+ |
| 201 |
+<body> |
| 202 |
+<p> |
| 203 |
+As reported in <uri link="https://bugs.gentoo.org/show_bug.cgi?id=375615">bug |
| 204 |
+#375615</uri>, for some people certain versions of |
| 205 |
+<c>x11-drives/nvidia-drivers</c> cause some Gtk+ applications to crash; one |
| 206 |
+effect of this is to break login using GDM. Until the problem is fixed, try |
| 207 |
+using a different version of <c>nvidia-drivers</c>; 275.09.07 is believed to |
| 208 |
+work well. |
| 209 |
+</p> |
| 210 |
+ |
| 211 |
+</body> |
| 212 |
+</section> |
| 213 |
+ |
| 214 |
+<section> |
| 215 |
+<title>GNOME starts in fallback mode</title> |
| 216 |
+<body> |
| 217 |
+ |
| 218 |
+<p> |
| 219 |
+GNOME will start in fallback mode if it detects that the graphics hardware and |
| 220 |
+drivers are insufficiently capable. To see a more detailed explanation of why |
| 221 |
+GNOME does not start in standard mode, run |
| 222 |
+<c>/usr/libexec/gnome-session-check-accelerated-helper</c>: |
| 223 |
+</p> |
| 224 |
+ |
| 225 |
+<pre caption="Sample gnome-session-check-accelerated-helper output"> |
| 226 |
+$ <i>/usr/libexec/gnome-session-check-accelerated-helper</i> |
| 227 |
+gnome-session-is-accelerated: No hardware 3D support. |
| 228 |
+</pre> |
| 229 |
+ |
| 230 |
+</body> |
| 231 |
+</section> |
| 232 |
+ |
| 233 |
+<section> |
| 234 |
+<title>GNOME starts in standard mode</title> |
| 235 |
+<body> |
| 236 |
+ |
| 237 |
+<p> |
| 238 |
+To force GNOME to start in fallback mode (e.g. due to poor performance or |
| 239 |
+personal taste), open System Settings (<c>gnome-control-center</c> from the |
| 240 |
+terminal), go to <e>System Info → Graphics</e>, and turn on <e>Forced |
| 241 |
+Fallback Mode</e>. Alternatively, from a terminal: |
| 242 |
+</p> |
| 243 |
+ |
| 244 |
+<pre caption="Force GNOME to start in fallback mode"> |
| 245 |
+$ <i>export GSETTINGS_BACKEND=dconf</i> |
| 246 |
+$ <i>gsettings set org.gnome.desktop.session session-name gnome-fallback</i> |
| 247 |
+</pre> |
| 248 |
+ |
| 249 |
+</body> |
| 250 |
+</section> |
| 251 |
+ |
| 252 |
+</chapter> |
| 253 |
+</guide> |
Archives