/[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 - (hide annotations) (download) (as text)
Mon Feb 14 00:36:50 2005 UTC (9 years, 7 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 swift 1.1 <?xml version='1.0' encoding='UTF-8'?>
2    
3 dertobi123 1.3 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gnome-config.xml,v 1.2 2005/01/13 18:19:34 swift 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     <mail link="swift@gentoo.org">Sven Vermeulen</mail>
13     </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     <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
25     <license/>
26    
27 dertobi123 1.3 <version>1.3</version>
28     <date>2005-02-14</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     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     <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 swift 1.1 </p>
89    
90     <pre caption="Example USE in /etc/make.conf">
91 dertobi123 1.3 USE="-qt -kde gtk gnome hal howl"
92 swift 1.1 </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 dertobi123 1.3 <pre caption="Adding famd, hald and mDNSResponder to the default runlevel">
120 swift 1.1 # <i>/etc/init.d/famd start</i>
121     # <i>rc-update add famd default</i>
122 dertobi123 1.3
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 swift 1.1 </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 swift 1.2 Now check the contents of the <path>/usr/share/xsessions</path>:
180 swift 1.1 </p>
181    
182 swift 1.2 <pre caption="Checking the contents of /usr/share/xsessions">
183     # <i>ls /usr/share/xsessions</i>
184     fluxbox.desktop gnome.desktop
185 swift 1.1 </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 swift 1.2 XSESSION="gnome"
196 swift 1.1 </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 dertobi123 1.3 <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 swift 1.1 </body>
210     </section>
211     </chapter>
212     </guide>

  ViewVC Help
Powered by ViewVC 1.1.20