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

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

  ViewVC Help
Powered by ViewVC 1.1.20