source: x/wm/fluxbox.xml@ 45ab6c7

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 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 years ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$
  • Property mode set to 100644
File size: 12.3 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 Install <application>Fluxbox</application> by running the following
101 commands:
102 </para>
103
104<screen><userinput>./configure --prefix=/usr &amp;&amp;
105make</userinput></screen>
106
107 <para>
108 This package does not have a working testsuite.
109 </para>
110
111 <para>
112 Now, as the <systemitem class="username">root</systemitem> user:
113 </para>
114
115<screen role="root"><userinput>make install</userinput></screen>
116
117 </sect2>
118
119 <sect2 role="configuration">
120 <title>Configuring Fluxbox</title>
121
122 <sect3 id="fluxbox-config">
123 <title>Config Files</title>
124
125 <para>
126 <filename>~/.fluxbox/init</filename>,
127 <filename>~/.fluxbox/keys</filename>, and
128 <filename>~/.fluxbox/menu</filename>
129 </para>
130
131 <indexterm zone="fluxbox fluxbox-config">
132 <primary sortas="e-AA.fluxbox-init">~/.fluxbox/init</primary>
133 </indexterm>
134
135 <indexterm zone="fluxbox fluxbox-config">
136 <primary sortas="e-AA.fluxbox-keys">~/.fluxbox/keys</primary>
137 </indexterm>
138
139 <indexterm zone="fluxbox fluxbox-config">
140 <primary sortas="e-AA.fluxbox-menu">~/.fluxbox/menu</primary>
141 </indexterm>
142
143 </sect3>
144
145 <sect3>
146 <title>Configuration Information</title>
147
148 <para>
149 If <application>Fluxbox</application> is the only Window Manager
150 you want to use, you can start it with an <filename>.xinitrc</filename>
151 file in your home folder. Be sure to backup your
152 current <filename>.xinitrc</filename> before proceeding.
153 </para>
154
155 <indexterm zone="fluxbox fluxbox-config">
156 <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
157 </indexterm>
158
159<screen><userinput>echo startfluxbox &gt; ~/.xinitrc</userinput></screen>
160
161 <para>
162 Or alternatively, if you use a login manager like
163 <xref linkend="gdm"/> or <xref linkend="lightdm"/>,
164 and would like to be able to choose <application>Fluxbox</application>
165 at the login prompt, create a <filename>fluxbox.desktop</filename>
166 file. As <systemitem class="username">root</systemitem>:
167 </para>
168
169<screen role="root"><userinput>mkdir -pv /usr/share/xsessions &amp;&amp;
170cat &gt; /usr/share/xsessions/fluxbox.desktop &lt;&lt; "EOF"
171<literal>[Desktop Entry]
172Encoding=UTF-8
173Name=Fluxbox
174Comment=This session logs you into Fluxbox
175Exec=startfluxbox
176Type=Application</literal>
177EOF</userinput></screen>
178
179 <para>
180 If you didn't install <xref linkend="gdm"/> or <xref
181 linkend="lightdm"/> in <filename class='directory'>/usr</filename>,
182 then change that command to fit the prefix you chose.
183 </para>
184
185 <para>
186 Now create the <application>Fluxbox</application> configuration files:
187 </para>
188
189<screen><userinput>mkdir -v ~/.fluxbox &amp;&amp;
190cp -v /usr/share/fluxbox/init ~/.fluxbox/init &amp;&amp;
191cp -v /usr/share/fluxbox/keys ~/.fluxbox/keys</userinput></screen>
192
193 <para>
194 To generate the application menu, first you may wish to run
195 <command>fluxbox-generate_menu -h</command>, in order to choose any
196 <replaceable>&lt;user_options&gt;</replaceable>, then issue:
197 </para>
198
199<screen role="nodump"><userinput>cd ~/.fluxbox &amp;&amp;
200fluxbox-generate_menu <replaceable>&lt;user_options&gt;</replaceable></userinput></screen>
201
202 <para>
203 Alternately, copy a pregenerated menu:
204 </para>
205
206<screen><userinput>cp -v /usr/share/fluxbox/menu ~/.fluxbox/menu</userinput></screen>
207
208 <para>
209 Menu items are added by editing <filename>~/.fluxbox/menu</filename>.
210 The syntax is explained on the <command>fluxbox</command> man page.
211 </para>
212
213 <para>
214 If you want to use an image as your desktop background, copy the
215 theme you like into <filename class='directory'>~/.fluxbox</filename>.
216 Then add a line to make it use the correct image. In the following
217 command, change <replaceable>&lt;theme&gt;</replaceable> for the name
218 of the theme you want and change
219 <replaceable>&lt;/path/to/nice/image.ext&gt;</replaceable> to point to
220 the actual image you want to use, where <replaceable>ext</replaceable>
221 must be <quote>xpm</quote>, if <xref linkend="imlib2"/> is not installed
222 to allow other image formats.
223 </para>
224
225<screen role="nodump"><userinput>cp -r /usr/share/fluxbox/styles/&lt;theme&gt; ~/.fluxbox/theme &amp;&amp;
226
227sed -i 's,\(session.styleFile:\).*,\1 ~/.fluxbox/theme,' ~/.fluxbox/init &amp;&amp;
228
229[ -f ~/.fluxbox/theme ] &amp;&amp;
230echo "background.pixmap: &lt;/path/to/nice/image.ext&gt;" >> ~/.fluxbox/theme ||
231[ -d ~/.fluxbox/theme ] &amp;&amp;
232echo "background.pixmap: &lt;/path/to/nice/image.ext&gt;" >> ~/.fluxbox/theme/theme.cfg</userinput></screen>
233
234 <para>
235 In some locales the font specified in the theme may not contain the
236 needed characters. This results in menus with blank items. You can fix
237 this by editing <filename>~/.fluxbox/theme</filename> with a text
238 editor and altering it so that it names a suitable font.
239 </para>
240
241 </sect3>
242
243 </sect2>
244
245 <sect2 role="content">
246 <title>Contents</title>
247
248 <segmentedlist>
249 <segtitle>Installed Programs</segtitle>
250 <segtitle>Installed Libraries</segtitle>
251 <segtitle>Installed Directories</segtitle>
252
253 <seglistitem>
254 <seg>fluxbox, fbsetbg, fbsetroot, fluxbox-generate_menu, startfluxbox,
255 fbrun, fluxbox-remote, and fluxbox-update_configs</seg>
256 <seg>None</seg>
257 <seg>/usr/share/fluxbox and ~/.fluxbox</seg>
258 </seglistitem>
259 </segmentedlist>
260
261 <variablelist>
262 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
263 <?dbfo list-presentation="list"?>
264 <?dbhtml list-presentation="table"?>
265
266 <varlistentry id="fluxbox-prog">
267 <term><command>fluxbox</command></term>
268 <listitem>
269 <para>
270 is a window manager for <application>X11</application> based
271 on <application>Blackbox</application> 0.61.0
272 </para>
273 <indexterm zone="fluxbox fluxbox-prog">
274 <primary sortas="b-fluxbox">fluxbox</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 <varlistentry id="fbsetbg">
280 <term><command>fbsetbg</command></term>
281 <listitem>
282 <para>
283 is a utility that sets the background image. It requires one
284 of the following at runtime:
285 <command>Esetroot</command>, <command>wmsetbg</command>,
286 <xref linkend="feh-prog"/>, <command>hsetroot</command>,
287 <command>chbg</command>, <xref linkend="display"/>,
288 <command>qiv</command>, <command>xv</command>,
289 <command>xsri</command>, <command>xli</command>, or
290 <command>xsetbg</command>. It also requires
291 <xref linkend="which-prog"/> if <command>Esetroot</command> is
292 found
293 </para>
294 <indexterm zone="fluxbox fbsetbg">
295 <primary sortas="b-fbsetbg">fbsetbg</primary>
296 </indexterm>
297 </listitem>
298 </varlistentry>
299
300 <varlistentry id="fbsetroot">
301 <term><command>fbsetroot</command></term>
302 <listitem>
303 <para>
304 is a utility to change root window appearance based on the
305 <application>Blackbox</application> application bsetroot
306 </para>
307 <indexterm zone="fluxbox fbsetroot">
308 <primary sortas="b-fbsetroot">fbsetroot</primary>
309 </indexterm>
310 </listitem>
311 </varlistentry>
312
313 <varlistentry id="fluxbox-generate_menu">
314 <term><command>fluxbox-generate_menu</command></term>
315 <listitem>
316 <para>
317 is a utility that generates a menu by scanning your
318 <envar>PATH</envar>
319 </para>
320 <indexterm zone="fluxbox fluxbox-generate_menu">
321 <primary sortas="b-fluxbox-generate_menu">fluxbox-generate_menu</primary>
322 </indexterm>
323 </listitem>
324 </varlistentry>
325
326 <varlistentry id="startfluxbox">
327 <term><command>startfluxbox</command></term>
328 <listitem>
329 <para>
330 is a session startup script that allows for command
331 executions prior to <command>fluxbox</command> starting
332 </para>
333 <indexterm zone="fluxbox startfluxbox">
334 <primary sortas="b-startfluxbox">startfluxbox</primary>
335 </indexterm>
336 </listitem>
337 </varlistentry>
338
339 <varlistentry id="fbrun">
340 <term><command>fbrun</command></term>
341 <listitem>
342 <para>
343 displays a run dialog window
344 </para>
345 <indexterm zone="fluxbox fbrun">
346 <primary sortas="b-fbrun">fbrun</primary>
347 </indexterm>
348 </listitem>
349 </varlistentry>
350
351 <varlistentry id="fluxbox-remote">
352 <term><command>fluxbox-remote</command></term>
353 <listitem>
354 <para>
355 provides command line access to key commands for
356 <application>Fluxbox</application>
357 </para>
358 <indexterm zone="fluxbox fluxbox-remote">
359 <primary sortas="b-fluxbox-remote">fluxbox-remote</primary>
360 </indexterm>
361 </listitem>
362 </varlistentry>
363
364 <varlistentry id="fluxbox-update_configs">
365 <term><command>fluxbox-update_configs</command></term>
366 <listitem>
367 <para>
368 use to manage config files (reload, update, test)
369 </para>
370 <indexterm zone="fluxbox fluxbox-update_configs">
371 <primary sortas="b-fluxbox-update_configs">fluxbox-update_configs</primary>
372 </indexterm>
373 </listitem>
374 </varlistentry>
375
376 </variablelist>
377
378 </sect2>
379
380</sect1>
Note: See TracBrowser for help on using the repository browser.