source: x/wm/fluxbox.xml@ 17aa21c

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 17aa21c was 48771ae, checked in by David Bryant <davidbryant@…>, 17 months ago

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