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

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

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

Revision 1.12 Revision 1.16
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xfce-config.xml,v 1.12 2007/10/03 20:12:24 nightmorph Exp $ -->
3
4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xfce-config.xml,v 1.16 2008/02/24 08:36:44 nightmorph Exp $ -->
5 4
6<guide link="/doc/en/xfce-config.xml"> 5<guide link="/doc/en/xfce-config.xml">
7<title>The Xfce Configuration Guide</title> 6<title>The Xfce Configuration Guide</title>
8 7
9<author title="Author"> 8<author title="Author">
17 16
18<!-- The content of this document is licensed under the CC-BY-SA license --> 17<!-- The content of this document is licensed under the CC-BY-SA license -->
19<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 18<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
20<license/> 19<license/>
21 20
22<version>1.9</version> 21<version>1.12</version>
23<date>2007-10-03</date> 22<date>2008-02-24</date>
24 23
25<chapter> 24<chapter>
26<title>Introduction</title> 25<title>Introduction</title>
27<section> 26<section>
28<title>The Xfce desktop environment</title> 27<title>The Xfce desktop environment</title>
46This guide will not only show you how to install and configure a minimal Xfce 45This guide will not only show you how to install and configure a minimal Xfce
47environment, but will also explore options to create a full-featured desktop in 46environment, but will also explore options to create a full-featured desktop in
48keeping with the Xfce philosophy: light, fast, and modular. 47keeping with the Xfce philosophy: light, fast, and modular.
49</p> 48</p>
50 49
51<p>
52Additionally, this guide will show you how to <uri link="#upgrade">upgrade</uri>
53from version 4.2 to 4.4.
54</p>
55
56</body> 50</body>
57</section> 51</section>
58</chapter> 52</chapter>
59 53
60<chapter> 54<chapter>
68link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>. 62link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>.
69</p> 63</p>
70 64
71<p> 65<p>
72Next, double-check your USE flags in <path>/etc/make.conf</path>; you'll 66Next, double-check your USE flags in <path>/etc/make.conf</path>; you'll
73probably at least want <c>USE="dbus -gnome hal startup-notification 67probably at least want <c>USE="-gnome -kde -qt3 -qt4 X dbus hal startup-notification xscreensaver"</c>.
74xscreensaver"</c>.
75</p> 68</p>
76 69
77<p> 70<p>
78Now, let's install Xfce. 71Now, let's install Xfce.
79</p> 72</p>
379</pre> 372</pre>
380 373
381<p> 374<p>
382We aren't quite finished yet. We have to pick a display manager and set the 375We aren't quite finished yet. We have to pick a display manager and set the
383appropriate variable. Though there are a few choices available in Portage, for 376appropriate variable. Though there are a few choices available in Portage, for
384this guide, we'll stick with two display manager options: <c>xdm</c> and 377this guide, we'll stick with <uri link="http://slim.berlios.de">SLiM</uri>, the
385<c>gdm</c>. 378Simple Login Manager.
386</p>
387
388<p> 379</p>
389<c>xdm</c> is speedy and lightweight, but it isn't pretty, and isn't really 380
390customizable. If you'd like to use it, first <c>emerge</c> it:
391</p> 381<p>
382<c>slim</c> is speedy and lightweight, with minimal dependencies. Perfect for
383Xfce!
384</p>
392 385
393<pre caption="Installing XDM"> 386<pre caption="Installing SLiM">
394# <i>emerge -avt xdm</i> 387# <i>emerge -avt slim</i>
395</pre> 388</pre>
396 389
397<p> 390<p>
398Then edit the DISPLAYMANAGER variable in <path>/etc/conf.d/xdm</path>: 391Then edit the DISPLAYMANAGER variable in <path>/etc/conf.d/xdm</path>:
399</p> 392</p>
400 393
401<pre caption="Editing /etc/conf.d/xdm"> 394<pre caption="Editing /etc/conf.d/xdm">
402DISPLAYMANAGER="xdm" 395DISPLAYMANAGER="slim"
403</pre> 396</pre>
404 397
405<p>
406<c>xdm</c> can automatically start your Xfce session if you add XSESSION="Xfce4"
407to <path>/etc/rc.conf</path>.
408</p> 398<p>
409 399SLiM can automatically start your Xfce session if you add
400<c>XSESSION="Xfce4"</c> to <path>/etc/rc.conf</path>.
410<p> 401</p>
411While you can choose to stick with (the rather ugly) <c>xdm</c>, why not try
412<c>gdm</c> instead? It's far more configurable, and much, much prettier. First,
413let's <c>emerge</c> it. Note that though it has a few dependencies, they're
414small, and they're not as nearly as numerous as other display managers.
415</p>
416
417<pre caption="Installing GDM">
418# <i>emerge -avt gdm</i>
419</pre>
420
421<p>
422Next, change the DISPLAYMANAGER variable to use <c>gdm</c> instead of
423<c>xdm</c>:
424</p>
425
426<pre caption="Editing /etc/conf.d/xdm">
427DISPLAYMANAGER="gdm"
428</pre>
429 402
430</body> 403</body>
431</section> 404</section>
432<section> 405<section>
433<title>Beautifying your desktop</title> 406<title>Beautifying your desktop</title>
453to be able to access themes and icon sets. Individual users can install themes 426to be able to access themes and icon sets. Individual users can install themes
454and icon sets to <path>~/.themes/</path> and <path>~/.icons/</path>. 427and icon sets to <path>~/.themes/</path> and <path>~/.icons/</path>.
455</p> 428</p>
456 429
457<p> 430<p>
458If you installed GDM as your display manager, take a look at the many GDM themes 431If you installed SLiM as your display manager, there are lots of themes in the
459available on <uri link="http://www.gnome-look.org">Gnome-Look</uri>. To install 432<c>slim-themes</c> package available in Portage. Also, be sure to check the SLiM
460them, you can either unpack and move them to 433<uri link="http://slim.berlios.de/themes01.php">themes page</uri> for more
461<path>/usr/share/gdm/themes/</path> on the command line, or you can run 434themes. Creating your own SLiM theme is fairly easy; just read the <uri
462<c>gdmsetup</c> as <b>root</b> and drag'n'drop the archive into the GDM window. 435link="http://slim.berlios.de/themes_howto.php">Themes HowTo</uri>.
463There are some <uri
464link="http://gnome-look.org/content/show.php?content=45575">very nice</uri>
465Gentoo <uri
466link="http://gnome-look.org/content/show.php?content=20071">themes</uri>
467available.
468</p> 436</p>
469 437
470<p> 438<p>
471Finally, Xfce has its own built-in compositor to manage window transparency. 439Finally, Xfce has its own built-in compositor to manage window transparency.
472This option can be found in Menu --> Settings --> Window Manager. For best 440This option can be found in Menu --> Settings --> Window Manager. For best
493 461
494</body> 462</body>
495</section> 463</section>
496</chapter> 464</chapter>
497 465
498<chapter id="upgrade">
499<title>Upgrading</title>
500<section>
501<title>Upgrading from 4.2 to 4.4</title>
502<body>
503
504<p>
505Upgrading from Xfce 4.2 to 4.4 isn't hard, but neither is it as simple as most
506upgrades. With the release of 4.4, many older packages are either deprecated, or
507their functionality has been included into the desktop in some other manner.
508</p>
509
510<p>
511First, update your Portage tree (<c>emerge --sync</c>), then see what Xfce
512updates are available (<c>emerge -pvtuD world</c>).
513</p>
514
515<p>
516You'll notice that there will be a list of packages that block upgrading, as
517most 4.2 packages cannot coexist with 4.4 packages. Here, the solution is pretty
518straightforward: just unmerge the blocking packages, as described in the <uri
519link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=1">Portage
520Handbook</uri> and <c>man emerge</c>, then continue with the update.
521</p>
522
523<p>
524Next, you may need to rebuild certain packages, such as applications linked
525against <c>dbus</c>. You'll need to first install <c>gentoolkit</c> for this.
526Then, once <c>gentoolkit</c> is installed, run:
527</p>
528
529<pre caption="Rebuilding packages">
530# <i>revdep-rebuild -p</i>
531<comment>(If you see any output about broken packages, run this next command)</comment>
532# <i>revdep-rebuild</i>
533</pre>
534
535<note>
536For more information, please read <c>man revdep-rebuild</c> and our <uri
537link="/doc/en/gentoolkit.xml">Gentoolkit Guide</uri>.
538</note>
539
540<p>
541Once the rebuild has finished, run <c>revdep-rebuild -p</c> again, just to make
542sure you have a clean and consistent world. If anything still shows up, keep
543repeating <c>revdep-rebuild -p</c> and <c>revdep-rebuild</c> until there's no
544more output about broken packages. Most Xfce update problems stem from
545<c>dbus</c> issues, as Xfce uses <c>dbus</c> quite extensively.
546</p>
547
548<p>
549Next, restart <c>dbus</c> and/or <c>hal</c>.
550</p>
551
552<pre caption="Restarting dbus and hal">
553# <i>/etc/init.d/dbus restart</i>
554# <i>/etc/init.d/hald restart</i>
555</pre>
556
557<p>
558Finally, give yourself a fresh environment.
559</p>
560
561<pre caption="Updating the environment variables">
562# <i>env-update &amp;&amp; source /etc/profile</i>
563</pre>
564
565</body>
566</section>
567<section>
568<title>Settings</title>
569<body>
570
571<p>
572Make sure you familiarize yourself with all the new options available in the new
573Settings Manager. Of interest are the options in the Desktop screen; Xfce can
574now manage your desktop and place icons on it.
575</p>
576
577<p>
578There's also a Window Manager Tweaks screen, in which you can adjust the
579behavior of windows, workspaces, and transparency (if enabled). Xfce 4.4 has
580slightly changed the default behavior of workspaces and active window focus. If
581you find that clicking a hyperlink in one workspace switches your browser to
582that workspace from another one (or similar annoying window focus behavior), try
583Settings --> Window Manager Tweaks --> Focus --> Activate Focus Stealing
584Prevention.
585</p>
586
587<p>
588Be sure to read the <uri link="http://www.xfce.org/documentation/">Xfce
589Documentation</uri> and take the <uri link="http://www.xfce.org/about/tour">Xfce
590Tour</uri> to learn more about 4.4 and how to configure it.
591</p>
592
593</body>
594</section>
595</chapter>
596
597<chapter> 466<chapter>
598<title>Summary</title> 467<title>Summary</title>
599<section> 468<section>
600<body> 469<body>
601 470

Legend:
Removed from v.1.12  
changed lines
  Added in v.1.16

  ViewVC Help
Powered by ViewVC 1.1.20