source: x/wm/fluxbox.xml@ 1a46c6e

11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 1a46c6e was 1a46c6e, checked in by Douglas R. Reno <renodr@…>, 3 years ago

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