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

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

  ViewVC Help
Powered by ViewVC 1.1.20