nightmorph 08/11/06 22:32:46 Modified: fluxbox-config.xml Log: Added new material to the Fluxbox guide on available USE flags, inspired by bug 245893. also some other updates throughout the doc.
Revision Changes Path 1.32 xml/htdocs/doc/en/fluxbox-config.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/fluxbox-config.xml?rev=1.32&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/fluxbox-config.xml?rev=1.32&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/fluxbox-config.xml?r1=1.31&r2=1.32 Index: fluxbox-config.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/fluxbox-config.xml,v retrieving revision 1.31 retrieving revision 1.32 diff -u -r1.31 -r1.32 --- fluxbox-config.xml 10 Mar 2008 06:03:41 -0000 1.31 +++ fluxbox-config.xml 6 Nov 2008 22:32:46 -0000 1.32 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="UTF-8"?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/fluxbox-config.xml,v 1.31 2008/03/10 06:03:41 nightmorph Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/fluxbox-config.xml,v 1.32 2008/11/06 22:32:46 nightmorph Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> <guide link="/doc/en/fluxbox-config.xml"> @@ -23,8 +23,8 @@ <!-- See http://creativecommons.org/licenses/by-sa/2.0 --> <license/> -<version>1.10</version> -<date>2008-03-09</date> +<version>1.11</version> +<date>2008-11-06</date> <chapter> <title>Introduction</title> @@ -86,15 +86,49 @@ <body> <p> -Gentoo provides an ebuild to quickly and easily install Fluxbox. While Gentoo -provides the <c>gnome</c> and <c>kde</c> USE flags to give compatibility with -these environments, it has been the author's experience that these USE flags are -not needed. If you desire qt, gtk+, or any KDE/GNOME utility then you are free -to emerge and configure those independently. For example, the author uses -Fluxbox with <c>k3b</c>, the KDE optical disc burning utility. +Before you install Fluxbox, you should take a look at some of the available USE +flags. </p> <p> +While the <c>gnome</c> and <c>kde</c> USE flags are provided to give +compatibility with these environments, it has been the author's experience that +these USE flags are not needed. If you desire qt, gtk+, or any KDE/GNOME utility +then you are free to emerge and configure those independently. The <c>gnome</c> +and <c>kde</c> flags simply add support for the respective protocols, and do not +depend on external libraries. However, they do increase the Fluxbox binary +size. +</p> + +<p> +There is also a <c>vim-syntax</c> flag to make configuration easier later on. +This flag will install <c>fluxbox-syntax</c>, a special Fluxbox color scheme for +<c>vim</c>. This enables users to more readily see the contents of their keys +and init files for Fluxbox. It's a tiny extension for vim, so it's highly +recommended. +</p> + +<p> +Finally, there are two flags that customize the functionality of Fluxbox, +<c>slit</c> and <c>toolbar</c>. These flags are provided so that users who don't +need the <uri +link="http://fluxbox-wiki.org/index.php?title=Faqs#What_is_the_slit";>slit</uri> +or the <uri link="http://fluxbox.org/features/";>toolbar</uri> can compile +Fluxbox without them. This is useful if you want to run an extremely minimal +environment, or if you plan to use different applications that provide these +features, such as standalone panels or docks. +</p> + +<p> +Once you've decided on your USE flags, add them to +<path>/etc/portage/package.use</path>: +</p> + +<pre caption="Example: adding USE flags"> +# <i>echo "x11-wm/fluxbox -gnome -kde truetype vim-syntax" >> /etc/portage/package.use</i> +</pre> + +<p> It is also necessary to have a program lock the X display to prevent unauthorized access, so it would be wise to also emerge <c>xlockmore</c>. The vast majority of users will also want the ability to set their own background, @@ -102,7 +136,7 @@ </p> <pre caption="Emerging Fluxbox"> -# <i>emerge fluxbox xlockmore x11-terms/eterm</i> +# <i>emerge fluxbox xlockmore eterm</i> </pre> <p> @@ -200,25 +234,6 @@ </body> </section> <section> -<title>Fluxbox Syntax for Vim</title> -<body> - -<p> -Next, install the special Fluxbox color scheme for <c>vim</c>. This enables -users to more readily see the contents of their keys and init files for -Fluxbox. This is a quite small extension for vim, so it is highly recommended -(unless of course you are one of those emacs people, in which case I recommend -<c>emerge -C emacs && emerge gvim</c> ;-). -</p> - -<pre caption="Emerging Fluxbox Syntax"> -# <i>emerge fluxbox-syntax</i> -</pre> - - -</body> -</section> -<section> <title>Application Launcher</title> <body>
