/[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.19 - (hide annotations) (download) (as text)
Wed Jul 4 23:17:39 2007 UTC (7 years, 5 months ago) by jkt
Branch: MAIN
Changes since 1.18: +5 -5 lines
File MIME type: application/xml
fixing section about updating runlevels

1 swift 1.1 <?xml version='1.0' encoding='UTF-8'?>
2    
3 jkt 1.19 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gnome-config.xml,v 1.18 2007/01/28 04:54:48 nightmorph Exp $ -->
4 swift 1.1
5     <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
6    
7     <guide link="/doc/en/gnome-config.xml">
8    
9     <title>The GNOME Configuration HOWTO</title>
10    
11     <author title="Author">
12 nightmorph 1.14 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
13 swift 1.1 </author>
14 dertobi123 1.3 <author title="Editor">
15     <mail link="lars@strojny.net">Lars Strojny</mail>
16     </author>
17 swift 1.1
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 neysx 1.7 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25 swift 1.1 <license/>
26    
27 jkt 1.19 <version>1.16</version>
28     <date>2007-07-05</date>
29 swift 1.1
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     <p>
81     Before you start installing GNOME, you might want to edit your USE variables.
82 rane 1.9 Make sure that <c>gtk</c> and <c>gnome</c> are in your USE variable listed in
83 dertobi123 1.3 <path>/etc/make.conf</path>. If you want support for <c>hald</c>, the hardware
84     abstraction layer daemon add <c>hal</c> to your USE flags. USE variable
85 neysx 1.7 <c>avahi</c> brings DNS-detection to GNOME (similiar to Rendevouz under Mac OS
86     X). If you don't want KDE support (the other big desktop environment), remove
87     <c>qt*</c>, <c>arts</c> and <c>kde</c>.
88 swift 1.1 </p>
89    
90     <pre caption="Example USE in /etc/make.conf">
91 nightmorph 1.10 USE="-qt3 -qt4 -arts -kde gtk gnome hal avahi"
92 swift 1.1 </pre>
93    
94     <p>
95 nightmorph 1.17 You can add the <c>branding</c> USE flag to get a lovely Gentoo-branded
96     splashscreen instead of the default Gnome splashscreen:
97     </p>
98    
99     <pre caption="Enabling Gentoo branding">
100     # <i>echo "gnome-base/gnome-session branding" &gt;&gt; /etc/portage/package.use</i>
101     </pre>
102    
103     <p>
104 nightmorph 1.18 Once done, start installing GNOME by emerging <c>gnome</c>:
105 swift 1.1 </p>
106    
107     <pre caption="Installing GNOME">
108 nightmorph 1.18 # <i>emerge gnome</i>
109 swift 1.1 </pre>
110    
111     <p>
112 swift 1.4 You can also opt for a minimal Gnome installation using <c>gnome-light</c>:
113     </p>
114    
115     <pre caption="Installing a minimal GNOME environment">
116     # <i>emerge gnome-light</i>
117     </pre>
118    
119     <p>
120 swift 1.1 This will take a while, so you might want to start reading all those books your
121     mother bought you but you never opened. Done? Great, now update your
122     environment variables:
123     </p>
124    
125     <pre caption="Updating environment variables">
126     # <i>env-update &amp;&amp; source /etc/profile</i>
127     </pre>
128    
129     <p>
130     If you paid attention to the output of your previous <c>emerge</c> command,
131 nightmorph 1.6 you'll notice that it suggests using <c>gamin</c> to have nautilus and
132     gnome-vfs monitor file changes:
133 swift 1.1 </p>
134    
135 nightmorph 1.6 <pre caption="Installing gamin, a file alteration monitor">
136     # <i>emerge gamin</i>
137     </pre>
138    
139     <impo>
140     If you are switching from <c>fam</c> (the old, deprecated file monitor) to
141     <c>gamin</c>, you will need to remove <c>famd</c> from all runlevels and then
142     unmerge it:
143     </impo>
144    
145 nightmorph 1.15 <pre caption="Optional: switching to gamin from fam">
146 jkt 1.19 # <i>rc-update del famd</i>
147 nightmorph 1.15 # <i>emerge --unmerge app-admin/fam</i>
148 nightmorph 1.6 </pre>
149    
150     <p>
151 jkt 1.19 Next we'll clean up the remaining services.
152 nightmorph 1.6 </p>
153 dertobi123 1.3
154 neysx 1.7 <pre caption="Adding hald and avahi-dnsconfd to the default runlevel">
155 dertobi123 1.3 # <i>/etc/init.d/hald start</i>
156     # <i>rc-update add hald default</i>
157    
158 neysx 1.7 # <i>/etc/init.d/avahi-dnsconfd start</i>
159     # <i>rc-update add avahi-dnsconfd default</i>
160 swift 1.1 </pre>
161    
162     </body>
163     </section>
164     <section>
165     <title>First Impressions</title>
166     <body>
167    
168     <p>
169     Let us first take a look at what we just built. Exit your root shell and log on
170     as a regular user. We will configure our session to run GNOME when we issue the
171 swift 1.5 <c>startx</c> command (see also
172     <uri link="/doc/en/xorg-config.xml#using_startx">Using startx</uri> in the
173     <uri link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>):
174 swift 1.1 </p>
175    
176     <pre caption="Having GNOME as default desktop environment">
177     $ <i>echo "exec gnome-session" &gt; ~/.xinitrc</i>
178     </pre>
179    
180     <p>
181     Now start your graphical environment by running <c>startx</c>:
182     </p>
183    
184     <pre caption="Starting GNOME">
185     $ <i>startx</i>
186     </pre>
187    
188     <p>
189     If all goes well, you should be greeted by GNOME. Congratulations. Now let us
190     take a look at how you can configure GNOME to suit your needs.
191     </p>
192    
193     </body>
194     </section>
195     </chapter>
196     <chapter>
197     <title>Configuring GNOME</title>
198     <section>
199     <title>GNOME's Graphical Login Manager</title>
200     <body>
201    
202     <p>
203     If you want the GNOME Display Manager (GDM) to run automatically when you boot
204     (so you can log on graphically), you must add the <c>xdm</c> init script to the
205     default runlevel:
206     </p>
207    
208     <pre caption="Adding xdm to the default runlevel">
209     # <i>rc-update add xdm default</i>
210     </pre>
211    
212     <p>
213 nightmorph 1.16 Now edit <path>/etc/conf.d/xdm</path> and alter the DISPLAYMANAGER variable.
214 swift 1.1 </p>
215    
216 nightmorph 1.16 <pre caption="Editing /etc/conf.d/xdm">
217 swift 1.1 DISPLAYMANAGER="gdm"
218     </pre>
219    
220     <p>
221     If you reboot now, the GNOME Display Manager will prompt you for your username
222     and password and will default to using GNOME as Desktop Environment (even though
223 swift 1.5 you will have the option of selecting a different one of course, choosing from
224     those available in <path>/usr/share/xsessions/</path>). Thus, if you use GDM,
225     you don't need to edit <path>~/.xinitrc</path>.
226 swift 1.1 </p>
227    
228 dertobi123 1.3 <p>
229     To use the functionality of <c>hald</c> just start <c>gnome-volume-manager</c>
230 nightmorph 1.11 and edit its preferences. Also, you'll need to add your user to the
231     <c>plugdev</c> group.
232 dertobi123 1.3 </p>
233    
234 swift 1.1 </body>
235     </section>
236     </chapter>
237     </guide>

  ViewVC Help
Powered by ViewVC 1.1.20