/[gentoo]/xml/htdocs/doc/en/gnome-config.xml
Gentoo

Contents of /xml/htdocs/doc/en/gnome-config.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.34 - (show annotations) (download) (as text)
Sun Aug 14 15:08:59 2011 UTC (2 years, 8 months ago) by swift
Branch: MAIN
Changes since 1.33: +18 -5 lines
File MIME type: application/xml
Bug #377885 - Tell users about adding themselves to the plugdev group if that group exists

1 <?xml version='1.0' encoding='UTF-8'?>
2 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gnome-config.xml,v 1.33 2011/07/03 04:07:04 nightmorph Exp $ -->
4
5 <guide>
6 <title>The GNOME Configuration HOWTO</title>
7
8 <author title="Author">
9 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
10 </author>
11 <author title="Editor">
12 <mail link="lars@strojny.net">Lars Strojny</mail>
13 </author>
14 <author title="Editor">
15 <mail link="nightmorph"/>
16 </author>
17
18 <abstract>
19 A frequently used environment is GNOME. This HOWTO tries to describe
20 all aspects of GNOME, including installation, configuration, usage, ...
21 </abstract>
22
23 <!-- The content of this document is licensed under the CC-BY-SA license -->
24 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25 <license/>
26
27 <version>3</version>
28 <date>2011-08-13</date>
29
30 <chapter>
31 <title>What is GNOME?</title>
32 <section>
33 <title>The Project</title>
34 <body>
35
36 <p>
37 The <uri link="http://www.gnome.org">GNOME</uri> project is a free software
38 project dedicated to the development of GNOME, a Unix/Linux desktop suite and
39 development platform. The <uri link="http://foundation.gnome.org">GNOME
40 Foundation</uri> coordinates the development and other aspects of the GNOME
41 Project.
42 </p>
43
44 </body>
45 </section>
46 <section>
47 <title>The Software</title>
48 <body>
49
50 <p>
51 GNOME is a desktop environment and a development platform. This piece of free
52 software is the desktop of choice for several industry leaders. It is
53 interesting both for business users, home users as well as developers.
54 </p>
55
56 </body>
57 </section>
58 <section>
59 <title>The Community</title>
60 <body>
61
62 <p>
63 Like with any big free software project, GNOME has an extensive user- and
64 development base. <uri link="http://www.gnomedesktop.org">Footnotes</uri>
65 contains GNOME Desktop news for users; <uri
66 link="http://planet.gnome.org">GnomePlanet</uri> is for hackers/contributors and
67 <uri link="http://developer.gnome.org">Developer.Gnome.Org</uri> is for the
68 GNOME developers.
69 </p>
70
71 </body>
72 </section>
73 </chapter>
74 <chapter>
75 <title>Installing GNOME</title>
76 <section>
77 <title>What do you need?</title>
78 <body>
79
80 <impo>
81 First read and follow the instructions in the <uri
82 link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri> to setup your
83 X environment.
84 </impo>
85
86 <p>
87 Before you start installing GNOME, you might want to edit your USE variables.
88 Make sure that <c>X</c>, <c>gtk</c>, and <c>gnome</c> are in your USE variable
89 listed in <path>/etc/make.conf</path>. If you want support for <c>dbus</c>, a
90 system message bus Gnome uses extensively, add it to your USE flags. If you
91 don't want KDE support (the other big desktop environment), remove <c>qt4</c>
92 and <c>kde</c>.
93 </p>
94
95 <pre caption="Example USE in /etc/make.conf">
96 USE="-qt4 -kde X dbus gtk gnome"
97 </pre>
98
99 <p>
100 You can add the <c>branding</c> USE flag to get a lovely Gentoo-branded
101 splashscreen instead of the default Gnome splashscreen:
102 </p>
103
104 <pre caption="Enabling Gentoo branding">
105 # <i>echo "gnome-base/gnome-session branding" &gt;&gt; /etc/portage/package.use</i>
106 </pre>
107
108 <note>
109 If you use the <c>desktop</c> profile, these USE flags will be set for you. You
110 can check your profile by running <c>eselect profile list</c> and <c>eselect
111 profile set &lt;profile-name&gt;</c> as root.
112 </note>
113
114 <p>
115 Once done, start installing GNOME by emerging <c>gnome</c>:
116 </p>
117
118 <pre caption="Installing GNOME">
119 # <i>emerge gnome</i>
120 </pre>
121
122 <p>
123 You can also opt for a minimal Gnome installation using <c>gnome-light</c>:
124 </p>
125
126 <pre caption="Installing a minimal GNOME environment">
127 # <i>emerge gnome-light</i>
128 </pre>
129
130 <p>
131 This will take a while, so you might want to start reading all those books your
132 mother bought you but you never opened. Done? Great, now update your
133 environment variables:
134 </p>
135
136 <pre caption="Updating environment variables">
137 # <i>env-update &amp;&amp; source /etc/profile</i>
138 </pre>
139
140 <p>
141 Next we'll clean up the remaining services and user groups.
142 </p>
143
144 <pre caption="Setting up the DBUS service">
145 # <i>/etc/init.d/dbus start</i>
146 # <i>rc-update add dbus default</i>
147 </pre>
148
149 <p>
150 Check if the <e>plugdev</e> group exists. If it does, it is adviseable to make
151 yourself member of that group, but this is optional (the group is not that
152 common anymore).
153 </p>
154
155 <pre caption="Checking and adding users to plugdev">
156 ~# <i>getent group plugdev</i>
157 plugdev:x:104:
158
159 <comment># Substitute yourUserName with your user name ;-)</comment>
160 ~# <i>gpasswd -a yourUserName plugdev</i>
161 </pre>
162
163 </body>
164 </section>
165 <section>
166 <title>First Impressions</title>
167 <body>
168
169 <p>
170 Let us first take a look at what we just built. Exit your root shell and log on
171 as a regular user. We will configure our session to run GNOME when we issue the
172 <c>startx</c> command (see also
173 <uri link="/doc/en/xorg-config.xml#using_startx">Using startx</uri> in the
174 <uri link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>):
175 </p>
176
177 <pre caption="Setting GNOME as the default desktop environment">
178 $ <i>echo "exec gnome-session" &gt; ~/.xinitrc</i>
179 </pre>
180
181 <p>
182 Starting with <c>gnome-base/gnome-session-2.26.2</c>, you will need to prepend
183 the XDG_MENU_PREFIX variable to get the Gnome menus if you're using the
184 <path>~/.xinitrc</path> method to start your desktop. (If you're not using
185 <path>~/.xinitrc</path>, it will be handled automatically for you; no additional
186 configuration is needed.)
187 </p>
188
189 <pre caption="Prepending XDG_MENU_PREFIX to ~/.xinitrc">
190 $ <i>sed -i '1i\export XDG_MENU_PREFIX=gnome-' ~/.xinitrc</i>
191 </pre>
192
193 <p>
194 Now start your graphical environment by running <c>startx</c>:
195 </p>
196
197 <pre caption="Starting GNOME">
198 $ <i>startx</i>
199 </pre>
200
201 <p>
202 If all goes well, you should be greeted by GNOME. Congratulations. Now let us
203 take a look at how you can configure GNOME to suit your needs.
204 </p>
205
206 </body>
207 </section>
208 </chapter>
209 <chapter>
210 <title>Configuring GNOME</title>
211 <section>
212 <title>GNOME's Graphical Login Manager</title>
213 <body>
214
215 <p>
216 If you want the GNOME Display Manager (GDM) to run automatically when you boot
217 (so you can log on graphically), you must add the <c>xdm</c> init script to the
218 default runlevel:
219 </p>
220
221 <pre caption="Adding xdm to the default runlevel">
222 # <i>rc-update add xdm default</i>
223 </pre>
224
225 <p>
226 Now edit <path>/etc/conf.d/xdm</path> and alter the DISPLAYMANAGER variable.
227 </p>
228
229 <pre caption="Editing /etc/conf.d/xdm">
230 DISPLAYMANAGER="gdm"
231 </pre>
232
233 <p>
234 If you reboot now, the GNOME Display Manager will prompt you for your username
235 and password and will default to using GNOME as Desktop Environment (even though
236 you will have the option of selecting a different one of course, choosing from
237 those available in <path>/usr/share/xsessions/</path>). Thus, if you use GDM,
238 you don't need to edit <path>~/.xinitrc</path>.
239 </p>
240
241 </body>
242 </section>
243 </chapter>
244 </guide>

  ViewVC Help
Powered by ViewVC 1.1.20