nightmorph 09/05/27 18:26:28 Modified: fluxbox-config.xml Log: updated fluxbox guide for bug 271433, thanks to lack for the patch
Revision Changes Path 1.33 xml/htdocs/doc/en/fluxbox-config.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/fluxbox-config.xml?rev=1.33&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/fluxbox-config.xml?rev=1.33&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/fluxbox-config.xml?r1=1.32&r2=1.33 Index: fluxbox-config.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/fluxbox-config.xml,v retrieving revision 1.32 retrieving revision 1.33 diff -u -r1.32 -r1.33 --- fluxbox-config.xml 6 Nov 2008 22:32:46 -0000 1.32 +++ fluxbox-config.xml 27 May 2009 18:26:28 -0000 1.33 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="UTF-8"?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/fluxbox-config.xml,v 1.32 2008/11/06 22:32:46 nightmorph Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/fluxbox-config.xml,v 1.33 2009/05/27 18:26:28 nightmorph Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> <guide link="/doc/en/fluxbox-config.xml"> @@ -14,6 +14,9 @@ <author title="Editor"> <mail link="nightmo...@gentoo.org">Joshua Saddler</mail> </author> +<author title="Contributor"> + <mail link="lack"/> +</author> <abstract> This howto will show you how to set up the Fluxbox window manager for X11. @@ -23,8 +26,8 @@ <!-- See http://creativecommons.org/licenses/by-sa/2.0 --> <license/> -<version>1.11</version> -<date>2008-11-06</date> +<version>1.12</version> +<date>2009-05-27</date> <chapter> <title>Introduction</title> @@ -234,38 +237,38 @@ </body> </section> <section> -<title>Application Launcher</title> +<title>Running Fluxbox for the first time</title> <body> <p> -Every window manager has (or should have) a custom program used for launching -applications, without having to open a console and run the application from it. -Fluxbox's launcher is called <c>fbrun</c>, which is already installed. It could -be run it by typing <c>fbrun</c> at the command line, but running <c>fbrun</c> -from a console and then launch an application from it is even worse than -running the application itself from that console. That's why a keyboard -shortcut should be defined or an entry inserted into fluxbox's menu which -points to the <c>fbrun</c> command, or both. +Now you are ready to run Fluxbox for the first time. It will create a directory +called <path>~/.fluxbox/</path> in your home directory, which is where Fluxbox +stores all its settings, and populate it with some default values. </p> +<pre caption="Starting Fluxbox from the console"> +$ <i>startx</i> +</pre> + <p> -You can define a menu entry called "Run...", by editing your -<path>~/.fluxbox/menu</path> to say: +If you've installed SLiM or another display manager, start it by becoming root +and running: </p> -<pre caption="Defining a menu entry to launch fbrun"> -[exec] (Run...) {fbrun} +<pre caption="Starting the display manager"> +# <i>/etc/init.d/xdm start</i> </pre> <p> -You'll find more information about menus in fluxbox later in this guide. +Then choose Fluxbox as your session and login with your regular user. </p> <p> -For more information, such as command line options, please read its manual page -by typing <c>man fbrun</c>. Remember that to use command-line options, it will -be necessary to edit your keys and/or menu files again to include those -options. +Once Fluxbox is running, it will look pretty plain. You should see a blank +desktop with a toolbar at the bottom. You can then right-click anywhere on your +desktop to bring up the menu. From there you should be able to start up any X +applications you would like to run, or open up a terminal from which you can run +anything you like. </p> </body> @@ -583,6 +586,13 @@ other programs, which do not understand Gentoo's directory structure. </p> +<p> +This can also be done from the Fluxbox menu itself. There is usually an entry +in the "Fluxbox" menu called "Regen Menu" which will re-run this script, looking +for any new applications that have been installed since the last time you ran +it. +</p> + <note> It is possible to use this method to auto-generate menus and still have some manual control over your menu. Creating and editing
