Gentoo Archives: gentoo-commits

From: "Joshua Saddler (nightmorph)" <nightmorph@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/doc/en: fluxbox-config.xml
Date: Wed, 27 May 2009 18:26:38
Message-Id: E1M9Npd-0004eq-4c@stork.gentoo.org
1 nightmorph 09/05/27 18:26:29
2
3 Modified: fluxbox-config.xml
4 Log:
5 updated fluxbox guide for bug 271433, thanks to lack for the patch
6
7 Revision Changes Path
8 1.33 xml/htdocs/doc/en/fluxbox-config.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/fluxbox-config.xml?rev=1.33&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/fluxbox-config.xml?rev=1.33&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/fluxbox-config.xml?r1=1.32&r2=1.33
13
14 Index: fluxbox-config.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/fluxbox-config.xml,v
17 retrieving revision 1.32
18 retrieving revision 1.33
19 diff -u -r1.32 -r1.33
20 --- fluxbox-config.xml 6 Nov 2008 22:32:46 -0000 1.32
21 +++ fluxbox-config.xml 27 May 2009 18:26:28 -0000 1.33
22 @@ -1,5 +1,5 @@
23 <?xml version="1.0" encoding="UTF-8"?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/fluxbox-config.xml,v 1.32 2008/11/06 22:32:46 nightmorph Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/fluxbox-config.xml,v 1.33 2009/05/27 18:26:28 nightmorph Exp $ -->
26 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
27
28 <guide link="/doc/en/fluxbox-config.xml">
29 @@ -14,6 +14,9 @@
30 <author title="Editor">
31 <mail link="nightmorph@g.o">Joshua Saddler</mail>
32 </author>
33 +<author title="Contributor">
34 + <mail link="lack"/>
35 +</author>
36
37 <abstract>
38 This howto will show you how to set up the Fluxbox window manager for X11.
39 @@ -23,8 +26,8 @@
40 <!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
41 <license/>
42
43 -<version>1.11</version>
44 -<date>2008-11-06</date>
45 +<version>1.12</version>
46 +<date>2009-05-27</date>
47
48 <chapter>
49 <title>Introduction</title>
50 @@ -234,38 +237,38 @@
51 </body>
52 </section>
53 <section>
54 -<title>Application Launcher</title>
55 +<title>Running Fluxbox for the first time</title>
56 <body>
57
58 <p>
59 -Every window manager has (or should have) a custom program used for launching
60 -applications, without having to open a console and run the application from it.
61 -Fluxbox's launcher is called <c>fbrun</c>, which is already installed. It could
62 -be run it by typing <c>fbrun</c> at the command line, but running <c>fbrun</c>
63 -from a console and then launch an application from it is even worse than
64 -running the application itself from that console. That's why a keyboard
65 -shortcut should be defined or an entry inserted into fluxbox's menu which
66 -points to the <c>fbrun</c> command, or both.
67 +Now you are ready to run Fluxbox for the first time. It will create a directory
68 +called <path>~/.fluxbox/</path> in your home directory, which is where Fluxbox
69 +stores all its settings, and populate it with some default values.
70 </p>
71
72 +<pre caption="Starting Fluxbox from the console">
73 +$ <i>startx</i>
74 +</pre>
75 +
76 <p>
77 -You can define a menu entry called "Run...", by editing your
78 -<path>~/.fluxbox/menu</path> to say:
79 +If you've installed SLiM or another display manager, start it by becoming root
80 +and running:
81 </p>
82
83 -<pre caption="Defining a menu entry to launch fbrun">
84 -[exec] (Run...) {fbrun}
85 +<pre caption="Starting the display manager">
86 +# <i>/etc/init.d/xdm start</i>
87 </pre>
88
89 <p>
90 -You'll find more information about menus in fluxbox later in this guide.
91 +Then choose Fluxbox as your session and login with your regular user.
92 </p>
93
94 <p>
95 -For more information, such as command line options, please read its manual page
96 -by typing <c>man fbrun</c>. Remember that to use command-line options, it will
97 -be necessary to edit your keys and/or menu files again to include those
98 -options.
99 +Once Fluxbox is running, it will look pretty plain. You should see a blank
100 +desktop with a toolbar at the bottom. You can then right-click anywhere on your
101 +desktop to bring up the menu. From there you should be able to start up any X
102 +applications you would like to run, or open up a terminal from which you can run
103 +anything you like.
104 </p>
105
106 </body>
107 @@ -583,6 +586,13 @@
108 other programs, which do not understand Gentoo's directory structure.
109 </p>
110
111 +<p>
112 +This can also be done from the Fluxbox menu itself. There is usually an entry
113 +in the "Fluxbox" menu called "Regen Menu" which will re-run this script, looking
114 +for any new applications that have been installed since the last time you ran
115 +it.
116 +</p>
117 +
118 <note>
119 It is possible to use this method to auto-generate menus and still have some
120 manual control over your menu. Creating and editing