source: x/wm/fluxbox.xml@ 2b7420b

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 2b7420b was 2b7420b, checked in by Bruce Dubbs <bdubbs@…>, 9 months ago

Tag printer stack, window managers, and misc

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24262 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 12.4 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY fluxbox-download-http "&sourceforge-dl;/fluxbox/fluxbox-&fluxbox-version;.tar.xz">
8 <!-- <!ENTITY fluxbox-download-ftp
9 "&jaist-ftp-repo;/f/fl/fluxbox/fluxbox/&fluxbox-version;/fluxbox-&fluxbox-version;.tar.xz"> -->
10 <!-- This was reported to no longer work. After testing, I can confirm.
11 Trying to use it results in a "No such directory" error. -->
12 <!ENTITY fluxbox-download-ftp " ">
13 <!ENTITY fluxbox-md5sum "b44afd10ee1e64624c23115aa51dcd55">
14 <!ENTITY fluxbox-size "772 KB">
15 <!ENTITY fluxbox-buildsize "101 MB">
16 <!ENTITY fluxbox-time "0.9 SBU">
17]>
18
19<sect1 id="fluxbox" xreflabel="Fluxbox-&fluxbox-version;">
20 <?dbhtml filename="fluxbox.html" ?>
21
22 <sect1info>
23 <othername>$LastChangedBy$</othername>
24 <date>$Date$</date>
25 </sect1info>
26
27 <title>Fluxbox-&fluxbox-version;</title>
28
29 <indexterm zone="fluxbox">
30 <primary sortas="a-Fluxbox">Fluxbox</primary>
31 </indexterm>
32
33 <sect2 role="package">
34 <title>Introduction to Fluxbox</title>
35
36 <para>
37 The <application>Fluxbox</application> package contains a window
38 manager.
39 </para>
40
41 &lfs101_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&fluxbox-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&fluxbox-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &fluxbox-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &fluxbox-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &fluxbox-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &fluxbox-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">Fluxbox Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Required</bridgehead>
80 <para role="required">
81 <xref linkend="x-window-system"/>
82 </para>
83
84 <bridgehead renderas="sect4">Optional</bridgehead>
85 <para role="optional">
86 <xref role="runtime" linkend="dbus"/> (runtime),
87 <xref linkend="fribidi"/>, and
88 <xref linkend="imlib2"/> (if you wish to use other image formats in
89 addition to XPM)
90 </para>
91
92 <para condition="html" role="usernotes">User Notes:
93 <ulink url="&blfs-wiki;/fluxbox"/></para>
94
95 </sect2>
96
97 <sect2 role="installation">
98 <title>Installation of Fluxbox</title>
99
100 <para>
101 Install <application>Fluxbox</application> by running the following
102 commands:
103 </para>
104
105<screen><userinput>./configure --prefix=/usr &amp;&amp;
106make</userinput></screen>
107
108 <para>
109 This package does not have a working testsuite.
110 </para>
111
112 <para>
113 Now, as the <systemitem class="username">root</systemitem> user:
114 </para>
115
116<screen role="root"><userinput>make install</userinput></screen>
117
118 </sect2>
119
120 <sect2 role="configuration">
121 <title>Configuring Fluxbox</title>
122
123 <sect3 id="fluxbox-config">
124 <title>Config Files</title>
125
126 <para>
127 <filename>~/.fluxbox/init</filename>,
128 <filename>~/.fluxbox/keys</filename>, and
129 <filename>~/.fluxbox/menu</filename>
130 </para>
131
132 <indexterm zone="fluxbox fluxbox-config">
133 <primary sortas="e-AA.fluxbox-init">~/.fluxbox/init</primary>
134 </indexterm>
135
136 <indexterm zone="fluxbox fluxbox-config">
137 <primary sortas="e-AA.fluxbox-keys">~/.fluxbox/keys</primary>
138 </indexterm>
139
140 <indexterm zone="fluxbox fluxbox-config">
141 <primary sortas="e-AA.fluxbox-menu">~/.fluxbox/menu</primary>
142 </indexterm>
143
144 </sect3>
145
146 <sect3>
147 <title>Configuration Information</title>
148
149 <para>
150 If <application>Fluxbox</application> is the only Window Manager
151 you want to use, you can start it with an <filename>.xinitrc</filename>
152 file in your home folder. Be sure to backup your
153 current <filename>.xinitrc</filename> before proceeding.
154 </para>
155
156 <indexterm zone="fluxbox fluxbox-config">
157 <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
158 </indexterm>
159
160<screen><userinput>echo startfluxbox &gt; ~/.xinitrc</userinput></screen>
161
162 <para>
163 Or alternatively, if you use a login manager like
164 <xref linkend="gdm"/> or <xref linkend="lightdm"/>,
165 and would like to be able to choose <application>Fluxbox</application>
166 at the login prompt, create a <filename>fluxbox.desktop</filename>
167 file. As <systemitem class="username">root</systemitem>:
168 </para>
169
170<screen role="root"><userinput>mkdir -pv /usr/share/xsessions &amp;&amp;
171cat &gt; /usr/share/xsessions/fluxbox.desktop &lt;&lt; "EOF"
172<literal>[Desktop Entry]
173Encoding=UTF-8
174Name=Fluxbox
175Comment=This session logs you into Fluxbox
176Exec=startfluxbox
177Type=Application</literal>
178EOF</userinput></screen>
179
180 <para>
181 If you didn't install <xref linkend="gdm"/> or <xref
182 linkend="lightdm"/> in <filename class='directory'>/usr</filename>,
183 then change that command to fit the prefix you chose.
184 </para>
185
186 <para>
187 Now create the <application>Fluxbox</application> configuration files:
188 </para>
189
190<screen><userinput>mkdir -v ~/.fluxbox &amp;&amp;
191cp -v /usr/share/fluxbox/init ~/.fluxbox/init &amp;&amp;
192cp -v /usr/share/fluxbox/keys ~/.fluxbox/keys</userinput></screen>
193
194 <para>
195 To generate the application menu, first you may wish to run
196 <command>fluxbox-generate_menu -h</command>, in order to choose any
197 <replaceable>&lt;user_options&gt;</replaceable>, then issue:
198 </para>
199
200<screen role="nodump"><userinput>cd ~/.fluxbox &amp;&amp;
201fluxbox-generate_menu <replaceable>&lt;user_options&gt;</replaceable></userinput></screen>
202
203 <para>
204 Alternately, copy a pregenerated menu:
205 </para>
206
207<screen><userinput>cp -v /usr/share/fluxbox/menu ~/.fluxbox/menu</userinput></screen>
208
209 <para>
210 Menu items are added by editing <filename>~/.fluxbox/menu</filename>.
211 The syntax is explained on the <command>fluxbox</command> man page.
212 </para>
213
214 <para>
215 If you want to use an image as your desktop background, copy the
216 theme you like into <filename class='directory'>~/.fluxbox</filename>.
217 Then add a line to make it use the correct image. In the following
218 command, change <replaceable>&lt;theme&gt;</replaceable> for the name
219 of the theme you want and change
220 <replaceable>&lt;/path/to/nice/image.ext&gt;</replaceable> to point to
221 the actual image you want to use, where <replaceable>ext</replaceable>
222 must be <quote>xpm</quote>, if <xref linkend="imlib2"/> is not installed
223 to allow other image formats.
224 </para>
225
226<screen role="nodump"><userinput>cp /usr/share/fluxbox/styles/&lt;theme&gt; ~/.fluxbox/theme &amp;&amp;
227
228sed -i 's,\(session.styleFile:\).*,\1 ~/.fluxbox/theme,' ~/.fluxbox/init &amp;&amp;
229
230[ -f ~/.fluxbox/theme ] &amp;&amp;
231echo "background.pixmap: &lt;/path/to/nice/image.ext&gt;" >> ~/.fluxbox/theme ||
232[ -d ~/.fluxbox/theme ] &amp;&amp;
233echo "background.pixmap: &lt;/path/to/nice/image.ext&gt;" >> ~/.fluxbox/theme/theme.cfg</userinput></screen>
234
235 <para>
236 In some locales the font specified in the theme may not contain the
237 needed characters. This results in menus with blank items. You can fix
238 this by editing <filename>~/.fluxbox/theme</filename> with a text
239 editor and altering it so that it names a suitable font.
240 </para>
241
242 </sect3>
243
244 </sect2>
245
246 <sect2 role="content">
247 <title>Contents</title>
248
249 <segmentedlist>
250 <segtitle>Installed Programs</segtitle>
251 <segtitle>Installed Libraries</segtitle>
252 <segtitle>Installed Directories</segtitle>
253
254 <seglistitem>
255 <seg>fluxbox, fbsetbg, fbsetroot, fluxbox-generate_menu, startfluxbox,
256 fbrun, fluxbox-remote, and fluxbox-update_configs</seg>
257 <seg>None</seg>
258 <seg>/usr/share/fluxbox and ~/.fluxbox</seg>
259 </seglistitem>
260 </segmentedlist>
261
262 <variablelist>
263 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
264 <?dbfo list-presentation="list"?>
265 <?dbhtml list-presentation="table"?>
266
267 <varlistentry id="fluxbox-prog">
268 <term><command>fluxbox</command></term>
269 <listitem>
270 <para>
271 is a window manager for <application>X11</application> based
272 on <application>Blackbox</application> 0.61.0
273 </para>
274 <indexterm zone="fluxbox fluxbox-prog">
275 <primary sortas="b-fluxbox">fluxbox</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="fbsetbg">
281 <term><command>fbsetbg</command></term>
282 <listitem>
283 <para>
284 is a utility that sets the background image. It requires one
285 of the following at runtime:
286 <command>Esetroot</command>, <command>wmsetbg</command>,
287 <xref linkend="feh-prog"/>, <command>hsetroot</command>,
288 <command>chbg</command>, <xref linkend="display"/>,
289 <command>qiv</command>, <command>xv</command>,
290 <command>xsri</command>, <command>xli</command>, or
291 <command>xsetbg</command>. It also requires
292 <xref linkend="which-prog"/> if <command>Esetroot</command> is
293 found
294 </para>
295 <indexterm zone="fluxbox fbsetbg">
296 <primary sortas="b-fbsetbg">fbsetbg</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 <varlistentry id="fbsetroot">
302 <term><command>fbsetroot</command></term>
303 <listitem>
304 <para>
305 is a utility to change root window appearance based on the
306 <application>Blackbox</application> application bsetroot
307 </para>
308 <indexterm zone="fluxbox fbsetroot">
309 <primary sortas="b-fbsetroot">fbsetroot</primary>
310 </indexterm>
311 </listitem>
312 </varlistentry>
313
314 <varlistentry id="fluxbox-generate_menu">
315 <term><command>fluxbox-generate_menu</command></term>
316 <listitem>
317 <para>
318 is a utility that generates a menu by scanning your
319 <envar>PATH</envar>
320 </para>
321 <indexterm zone="fluxbox fluxbox-generate_menu">
322 <primary sortas="b-fluxbox-generate_menu">fluxbox-generate_menu</primary>
323 </indexterm>
324 </listitem>
325 </varlistentry>
326
327 <varlistentry id="startfluxbox">
328 <term><command>startfluxbox</command></term>
329 <listitem>
330 <para>
331 is a session startup script that allows for command
332 executions prior to <command>fluxbox</command> starting
333 </para>
334 <indexterm zone="fluxbox startfluxbox">
335 <primary sortas="b-startfluxbox">startfluxbox</primary>
336 </indexterm>
337 </listitem>
338 </varlistentry>
339
340 <varlistentry id="fbrun">
341 <term><command>fbrun</command></term>
342 <listitem>
343 <para>
344 displays a run dialog window
345 </para>
346 <indexterm zone="fluxbox fbrun">
347 <primary sortas="b-fbrun">fbrun</primary>
348 </indexterm>
349 </listitem>
350 </varlistentry>
351
352 <varlistentry id="fluxbox-remote">
353 <term><command>fluxbox-remote</command></term>
354 <listitem>
355 <para>
356 provides command line access to key commands for
357 <application>Fluxbox</application>
358 </para>
359 <indexterm zone="fluxbox fluxbox-remote">
360 <primary sortas="b-fluxbox-remote">fluxbox-remote</primary>
361 </indexterm>
362 </listitem>
363 </varlistentry>
364
365 <varlistentry id="fluxbox-update_configs">
366 <term><command>fluxbox-update_configs</command></term>
367 <listitem>
368 <para>
369 use to manage config files (reload, update, test)
370 </para>
371 <indexterm zone="fluxbox fluxbox-update_configs">
372 <primary sortas="b-fluxbox-update_configs">fluxbox-update_configs</primary>
373 </indexterm>
374 </listitem>
375 </varlistentry>
376
377 </variablelist>
378
379 </sect2>
380
381</sect1>
Note: See TracBrowser for help on using the repository browser.