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

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

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.30 Revision 1.37
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gnome-config.xml,v 1.30 2010/02/11 19:59:46 nightmorph Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gnome-config.xml,v 1.37 2012/12/09 20:04:22 swift Exp $ -->
4 4
5<guide> 5<guide>
6<title>The GNOME Configuration HOWTO</title> 6<title>The GNOME Configuration HOWTO</title>
7 7
8<author title="Author"> 8<author title="Author">
22 22
23<!-- The content of this document is licensed under the CC-BY-SA license --> 23<!-- The content of this document is licensed under the CC-BY-SA license -->
24<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 24<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25<license/> 25<license/>
26 26
27<version>1.23</version> 27<version>6</version>
28<date>2010-02-11</date> 28<date>2012-12-09</date>
29 29
30<chapter> 30<chapter>
31<title>What is GNOME?</title> 31<title>What is GNOME?</title>
32<section> 32<section>
33<title>The Project</title> 33<title>The Project</title>
59<title>The Community</title> 59<title>The Community</title>
60<body> 60<body>
61 61
62<p> 62<p>
63Like with any big free software project, GNOME has an extensive user- and 63Like with any big free software project, GNOME has an extensive user- and
64development base. <uri link="http://www.gnomedesktop.org">Footnotes</uri> 64development base. <uri link="http://planet.gnome.org">GnomePlanet</uri> is
65contains GNOME Desktop news for users; <uri 65a popular blog aggregator for GNOME hackers and contributors whereas <uri
66link="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 66link="http://developer.gnome.org">Developer.Gnome.Org</uri> is for the GNOME
68GNOME developers. 67developers. <uri link="http://library.gnome.org/users/">GNOME Library</uri>
68contains a huge list of GNOME resources for end users.
69</p> 69</p>
70 70
71</body> 71</body>
72</section> 72</section>
73</chapter> 73</chapter>
77<title>What do you need?</title> 77<title>What do you need?</title>
78<body> 78<body>
79 79
80<impo> 80<impo>
81First read and follow the instructions in the <uri 81First read and follow the instructions in the <uri
82link="/doc/en/xorg-confix.xml">X Server Configuration Howto</uri> to setup your 82link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri> to setup your
83X environment. 83X environment.
84</impo> 84</impo>
85 85
86<p> 86<p>
87Before you start installing GNOME, you might want to edit your USE variables. 87Before you start installing GNOME, you might want to edit your USE variables.
88Make sure that <c>X</c>, <c>gtk</c>, and <c>gnome</c> are in your USE variable 88Make sure that <c>X</c>, <c>gtk</c>, and <c>gnome</c> are in your USE variable
89listed in <path>/etc/make.conf</path>. If you want support for <c>hald</c>, the 89listed in <path>/etc/portage/make.conf</path>. If you want support for <c>dbus</c>, a
90hardware abstraction layer daemon add <c>hal</c> to your USE flags. The same 90system message bus Gnome uses extensively, add it to your USE flags. If you
91goes for <c>dbus</c>, a system message bus Gnome uses extensively. If you don't
92want KDE support (the other big desktop environment), remove <c>qt3</c>, 91don't want KDE support (the other big desktop environment), remove <c>qt4</c>
93<c>qt4</c>, <c>arts</c>, and <c>kde</c>. 92and <c>kde</c>.
94</p> 93</p>
95 94
96<pre caption="Example USE in /etc/make.conf"> 95<pre caption="Example USE in /etc/portage/make.conf">
97USE="-qt3 -qt4 -arts -kde X dbus gtk gnome hal" 96USE="-qt4 -kde X dbus gtk gnome"
98</pre> 97</pre>
99 98
100<p> 99<p>
101You can add the <c>branding</c> USE flag to get a lovely Gentoo-branded 100You can add the <c>branding</c> USE flag to get a lovely Gentoo-branded
102splashscreen instead of the default Gnome splashscreen: 101splashscreen instead of the default Gnome splashscreen:
104 103
105<pre caption="Enabling Gentoo branding"> 104<pre caption="Enabling Gentoo branding">
106# <i>echo "gnome-base/gnome-session branding" &gt;&gt; /etc/portage/package.use</i> 105# <i>echo "gnome-base/gnome-session branding" &gt;&gt; /etc/portage/package.use</i>
107</pre> 106</pre>
108 107
108<note>
109If you use the <c>desktop</c> profile, these USE flags will be set for you. You
110can check your profile by running <c>eselect profile list</c> and <c>eselect
111profile set &lt;profile-name&gt;</c> as root.
112</note>
113
109<p> 114<p>
110Once done, start installing GNOME by emerging <c>gnome</c>: 115Once done, start installing GNOME by emerging <c>gnome</c>:
111</p> 116</p>
112 117
113<pre caption="Installing GNOME"> 118<pre caption="Installing GNOME">
114# <i>emerge gnome</i> 119# <i>emerge gnome</i>
115</pre> 120</pre>
116 121
117<p> 122<p>
118You can also opt for a minimal Gnome installation using <c>gnome-light</c>: 123You can also opt for a minimal Gnome installation using <c>gnome-light</c>.
124If you do so, you will have a lightweight Gnome installation without
125the additional tools that a full Gnome installation provides so you might need
126to install additional packages afterwards.
119</p> 127</p>
120 128
121<pre caption="Installing a minimal GNOME environment"> 129<pre caption="Installing a minimal GNOME environment">
122# <i>emerge gnome-light</i> 130# <i>emerge gnome-light</i>
123</pre> 131</pre>
131<pre caption="Updating environment variables"> 139<pre caption="Updating environment variables">
132# <i>env-update &amp;&amp; source /etc/profile</i> 140# <i>env-update &amp;&amp; source /etc/profile</i>
133</pre> 141</pre>
134 142
135<p> 143<p>
136Next we'll clean up the remaining services. 144Next we'll clean up the remaining services and user groups.
137</p> 145</p>
138 146
139<pre caption="Adding hald and dbus to the default runlevel"> 147<pre caption="Setting up the DBUS service">
140# <i>/etc/init.d/hald start</i>
141# <i>rc-update add hald default</i>
142
143# <i>/etc/init.d/dbus start</i> 148# <i>/etc/init.d/dbus start</i>
144# <i>rc-update add dbus default</i> 149# <i>rc-update add dbus default</i>
150</pre>
151
152<p>
153Check if the <e>plugdev</e> group exists. If it does, it is adviseable to make
154yourself member of that group, but this is optional (the group is not that
155common anymore).
156</p>
157
158<pre caption="Checking and adding users to plugdev">
159~# <i>getent group plugdev</i>
160plugdev:x:104:
161
162<comment># Substitute yourUserName with your user name ;-)</comment>
163~# <i>gpasswd -a yourUserName plugdev</i>
145</pre> 164</pre>
146 165
147</body> 166</body>
148</section> 167</section>
149<section> 168<section>
156<c>startx</c> command (see also 175<c>startx</c> command (see also
157<uri link="/doc/en/xorg-config.xml#using_startx">Using startx</uri> in the 176<uri link="/doc/en/xorg-config.xml#using_startx">Using startx</uri> in the
158<uri link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>): 177<uri link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>):
159</p> 178</p>
160 179
161<pre caption="Having GNOME as default desktop environment"> 180<pre caption="Setting GNOME as the default desktop environment">
162$ <i>echo "exec gnome-session" &gt; ~/.xinitrc</i> 181$ <i>echo "exec gnome-session" &gt; ~/.xinitrc</i>
163</pre> 182</pre>
164 183
165<p> 184<p>
166Starting with <c>gnome-base/gnome-session-2.26.2</c>, you will need to prepend 185Starting with <c>gnome-base/gnome-session-2.26.2</c>, you will need to prepend
213<pre caption="Editing /etc/conf.d/xdm"> 232<pre caption="Editing /etc/conf.d/xdm">
214DISPLAYMANAGER="gdm" 233DISPLAYMANAGER="gdm"
215</pre> 234</pre>
216 235
217<p> 236<p>
237If you installed Gnome using the <c>gnome-light</c> package, you will need to
238install <c>gdm</c> too (as it is not defined as part of the <c>gnome-light</c>
239package).
240</p>
241
242<pre caption="Installing the gdm application">
243# <i>emerge gdm</i>
244</pre>
245
246<p>
218If you reboot now, the GNOME Display Manager will prompt you for your username 247If you reboot now, the GNOME Display Manager will prompt you for your username
219and password and will default to using GNOME as Desktop Environment (even though 248and password and will default to using GNOME as Desktop Environment (even though
220you will have the option of selecting a different one of course, choosing from 249you will have the option of selecting a different one of course, choosing from
221those available in <path>/usr/share/xsessions/</path>). Thus, if you use GDM, 250those available in <path>/usr/share/xsessions/</path>). Thus, if you use GDM,
222you don't need to edit <path>~/.xinitrc</path>. 251you don't need to edit <path>~/.xinitrc</path>.
223</p> 252</p>
224 253
225<p>
226To use the functionality of <c>hald</c> you need to add your user to the
227<c>plugdev</c> group. If you want support for devices not handled by the
228<c>nautilus</c> file manager, or if you're not using <c>nautilus</c> at all, you
229might want to make sure that <c>gnome-volume-manager</c> is built with the
230<c>automount</c> USE flag, and that it's started every time you login.
231</p>
232
233</body> 254</body>
234</section> 255</section>
235</chapter> 256</chapter>
236</guide> 257</guide>

Legend:
Removed from v.1.30  
changed lines
  Added in v.1.37

  ViewVC Help
Powered by ViewVC 1.1.20