source: x/wm/fluxbox.xml@ 29efe05c

10.0 10.1 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 29efe05c was 29efe05c, checked in by Douglas R. Reno <renodr@…>, 4 years ago

Update to xf86-video-intel-20200817
Misc tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23557 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 &lfs10_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 <xref
292 linkend="which-prog"/> if <command>Esetroot</command> is 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.