nightmorph 10/08/24 07:24:38 Modified: xfce-config.xml Log: add xfce4-power-manager info. add XFCE_PLUGINS variable and explanations per bug 334181.
Revision Changes Path 1.32 xml/htdocs/doc/en/xfce-config.xml file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xfce-config.xml?rev=1.32&view=markup plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xfce-config.xml?rev=1.32&content-type=text/plain diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xfce-config.xml?r1=1.31&r2=1.32 Index: xfce-config.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/xfce-config.xml,v retrieving revision 1.31 retrieving revision 1.32 diff -u -r1.31 -r1.32 --- xfce-config.xml 26 Jul 2010 01:48:40 -0000 1.31 +++ xfce-config.xml 24 Aug 2010 07:24:38 -0000 1.32 @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='UTF-8'?> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xfce-config.xml,v 1.31 2010/07/26 01:48:40 nightmorph Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xfce-config.xml,v 1.32 2010/08/24 07:24:38 nightmorph Exp $ --> <guide> <title>The Xfce Configuration Guide</title> @@ -18,8 +18,8 @@ <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> <license/> -<version>1.26</version> -<date>2010-07-25</date> +<version>1.27</version> +<date>2010-08-23</date> <chapter> <title>Introduction</title> @@ -70,7 +70,31 @@ </p> <p> -Now, let's install Xfce. +There's also another variable you can set in <path>/etc/make.conf</path> called +XFCE_PLUGINS. This variable controls additional Xfce plugins; some for the +panel, and some for other applications. You can enable all of the plugins by +adding <c>XFCE_PLUGINS="brightness menu trash</c> to +<path>/etc/make.conf</path>. Here's a brief summary of the plugins: +</p> + +<dl> + <dt>brightness</dt> + <dd> + Lets you add a screen brightness applet to your panel, once you have + installed <c>xfce4-power-manager</c> + </dd> + <dt>menu</dt> + <dd>Lets you add a program menu to your panel</dd> + <dt>trash</dt> + <dd> + Adds Trash functionality to <c>thunar</c>, the file manager. The Trash + allows you to recover deleted files. + </dd> +</dl> + +<p> +Now that you've set your <c>USE</c> and <c>XFCE_PLUGINS</c> variables in +<path>/etc/make.conf</path>, it's time to install Xfce. </p> <pre caption="Installing Xfce"> @@ -222,10 +246,10 @@ <p> There are many plugins for the panel available in Portage; see for yourself with -<c>emerge --search xfce</c>. Though for the most part their names are self -explanatory, a few deserve some attention, as they are quite helpful. To use -them, simply <c>emerge</c> them. They'll be added to the list of available items -in the "Add New Item" menu shown when you right-click on the panel. +<c>emerge --search xfce</c>. Though for the most part their names are +self-explanatory, a few deserve extra attention, as they are quite helpful. To +use them, simply <c>emerge</c> them. They'll be added to the list of available +items in the "Add New Items" menu shown when you right-click on the panel. </p> <ul> @@ -267,8 +291,8 @@ <p> We should now <c>emerge</c> some useful applications and utilities: <c>xfce4-mixer</c>, <c>xfprint</c>, <c>xfce4-taskmanager</c>, -<c>xfwm4-themes</c>, <c>orage</c>, <c>mousepad</c>, <c>x11-terms/terminal</c>, -and <c>thunar</c>. +<c>xfwm4-themes</c>, <c>orage</c>, <c>mousepad</c>, <c>xfce4-power-manager</c>, +<c>x11-terms/terminal</c>, and <c>thunar</c>. </p> <p> @@ -290,14 +314,29 @@ <p> <c>orage</c> is a simple, handy calendar. <c>mousepad</c> is a barebones text -editor that starts up extremely quickly. <c>x11-terms/terminal</c> is an X11 -terminal emulator, far more configurable and useful than the barebones -<c>xterm</c>. <c>terminal</c> supports Unicode text, color schemes, -pseudo-transparency and hardware-accelerated transparency via Xfce's built-in -compositor, all out-of-the-box. Just make sure that the default action on the -terminal launcher of your panel runs <path>/usr/bin/Terminal</path> instead of -<path>xterm</path>. Right-click the launcher and choose "Properties" to change -the command. +editor that starts up extremely quickly. +</p> + +<p> +<c>xfce4-power-manager</c> is an application to monitor and manage power usage. +This is especially important for laptops! The power manager allows you to adjust +screen brightness, choose maximum performance or battery-saving modes, and setup +hibernate, suspend, and shutdown actions when the lid is shut or buttons are +pressed. You can set <uri +link="http://goodies.xfce.org/projects/applications/xfce4-power-manager">xfce4-power-manager</uri> +to warn you when your battery reaches certain levels, or even turn off your +machine. The application comes with a couple of helpful panel plugins to display +battery/charging status, and a brightness control. +</p> + +<p> +<c>x11-terms/terminal</c> is an X11 terminal emulator, far more configurable and +useful than the barebones <c>xterm</c>. <c>terminal</c> supports Unicode text, +color schemes, pseudo-transparency and hardware-accelerated transparency via +Xfce's built-in compositor, all out-of-the-box. Just make sure that the default +action on the terminal launcher of your panel runs +<path>/usr/bin/Terminal</path> instead of <path>xterm</path>. Right-click the +launcher and choose "Properties" to change the command. </p> <p>