/[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.3 - (show annotations) (download) (as text)
Mon Feb 14 00:36:50 2005 UTC (9 years, 5 months ago) by dertobi123
Branch: MAIN
Changes since 1.2: +24 -7 lines
File MIME type: application/xml
Add information about hald and mDNSResponder.
Thanks to Lars Strojny (lars@strojny.net)!

1 <?xml version='1.0' encoding='UTF-8'?>
2
3 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gnome-config.xml,v 1.2 2005/01/13 18:19:34 swift Exp $ -->
4
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 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
13 </author>
14 <author title="Editor">
15 <mail link="lars@strojny.net">Lars Strojny</mail>
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/1.0 -->
25 <license/>
26
27 <version>1.3</version>
28 <date>2005-02-14</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 <p>
81 Before you start installing GNOME, you might want to edit your USE variables.
82 Make sure that <c>gtk</c> and <c>gnome</c> are in your USE variable listed in
83 <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 <c>howl</c> brings DNS-detection to GNOME (similiar to Rendevouz under Mac OS X).
86 If you don't want KDE support (the other big desktop environment), remove
87 <c>qt</c> and <c>kde</c>.
88 </p>
89
90 <pre caption="Example USE in /etc/make.conf">
91 USE="-qt -kde gtk gnome hal howl"
92 </pre>
93
94 <p>
95 Once done, start installing GNOME by emerging <c>gnome</c> and
96 <c>xscreensaver</c>:
97 </p>
98
99 <pre caption="Installing GNOME">
100 # <i>emerge gnome xscreensaver</i>
101 </pre>
102
103 <p>
104 This will take a while, so you might want to start reading all those books your
105 mother bought you but you never opened. Done? Great, now update your
106 environment variables:
107 </p>
108
109 <pre caption="Updating environment variables">
110 # <i>env-update &amp;&amp; source /etc/profile</i>
111 </pre>
112
113 <p>
114 If you paid attention to the output of your previous <c>emerge</c> command,
115 you'll notice that it suggests adding <c>famd</c> to the default runlevel to
116 have nautilus and gnome-vfs monitor file changes:
117 </p>
118
119 <pre caption="Adding famd, hald and mDNSResponder to the default runlevel">
120 # <i>/etc/init.d/famd start</i>
121 # <i>rc-update add famd default</i>
122
123 # <i>/etc/init.d/hald start</i>
124 # <i>rc-update add hald default</i>
125
126 # <i>/etc/init.d/mDNSResponder start</i>
127 # <i>rc-update add mDNSResponder default</i>
128 </pre>
129
130 </body>
131 </section>
132 <section>
133 <title>First Impressions</title>
134 <body>
135
136 <p>
137 Let us first take a look at what we just built. Exit your root shell and log on
138 as a regular user. We will configure our session to run GNOME when we issue the
139 <c>startx</c> command:
140 </p>
141
142 <pre caption="Having GNOME as default desktop environment">
143 $ <i>echo "exec gnome-session" &gt; ~/.xinitrc</i>
144 </pre>
145
146 <p>
147 Now start your graphical environment by running <c>startx</c>:
148 </p>
149
150 <pre caption="Starting GNOME">
151 $ <i>startx</i>
152 </pre>
153
154 <p>
155 If all goes well, you should be greeted by GNOME. Congratulations. Now let us
156 take a look at how you can configure GNOME to suit your needs.
157 </p>
158
159 </body>
160 </section>
161 </chapter>
162 <chapter>
163 <title>Configuring GNOME</title>
164 <section>
165 <title>GNOME's Graphical Login Manager</title>
166 <body>
167
168 <p>
169 If you want the GNOME Display Manager (GDM) to run automatically when you boot
170 (so you can log on graphically), you must add the <c>xdm</c> init script to the
171 default runlevel:
172 </p>
173
174 <pre caption="Adding xdm to the default runlevel">
175 # <i>rc-update add xdm default</i>
176 </pre>
177
178 <p>
179 Now check the contents of the <path>/usr/share/xsessions</path>:
180 </p>
181
182 <pre caption="Checking the contents of /usr/share/xsessions">
183 # <i>ls /usr/share/xsessions</i>
184 fluxbox.desktop gnome.desktop
185 </pre>
186
187 <p>
188 As you can see, there is a session called <c>gnome</c> available. Now edit
189 <path>/etc/rc.conf</path> and alter two variables: DISPLAYMANAGER (which should
190 be set to <c>gdm</c>) and XSESSION (which should be set to <c>Gnome</c>):
191 </p>
192
193 <pre caption="Editing /etc/rc.conf">
194 DISPLAYMANAGER="gdm"
195 XSESSION="gnome"
196 </pre>
197
198 <p>
199 If you reboot now, the GNOME Display Manager will prompt you for your username
200 and password and will default to using GNOME as Desktop Environment (even though
201 you will have the option of selecting a different one of course).
202 </p>
203
204 <p>
205 To use the functionality of <c>hald</c> just start <c>gnome-volume-manager</c>
206 and edit its preferences.
207 </p>
208
209 </body>
210 </section>
211 </chapter>
212 </guide>

  ViewVC Help
Powered by ViewVC 1.1.20