source: x/wm/sawfish.xml@ 074c49b

11.3 12.0 12.1 gimp3 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/spidermonkey128 xry111/xf86-video-removal
Last change on this file since 074c49b was 12fe806, checked in by Bruce Dubbs <bdubbs@…>, 18 months ago

Remove unneeded .desktop files.

Several packages add unneeded .desktop files in /usr/share/xsessions/.
These then show up in display managers and can confuse users.
This change moves them out of the way.

Also document that lxdm does not support wayland based desktop sessions.
  • Property mode set to 100644
File size: 10.7 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 sawfish-download-http "https://download.tuxfamily.org/sawfish/sawfish_&sawfish-version;.tar.xz">
8 <!ENTITY sawfish-download-ftp " ">
9 <!ENTITY sawfish-md5sum "fd6ca5be0acbee8ea150945d3fb3ec60">
10 <!ENTITY sawfish-size "2.7 MB">
11 <!ENTITY sawfish-buildsize "52 MB">
12 <!ENTITY sawfish-time "0.3 SBU">
13]>
14
15<sect1 id="sawfish" xreflabel="sawfish-&sawfish-version;">
16 <?dbhtml filename="sawfish.html" ?>
17
18
19 <title>sawfish-&sawfish-version;</title>
20
21 <indexterm zone="sawfish">
22 <primary sortas="a-Sawfish">Sawfish</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to sawfish</title>
27
28 <para>
29 The <application>sawfish</application> package contains a window
30 manager. This is useful for organizing and displaying windows where all
31 window decorations are configurable and all user-interface policy is
32 controlled through the extension language.
33 </para>
34
35 &lfs113_checked;
36
37 <bridgehead renderas="sect3">Package Information</bridgehead>
38 <itemizedlist spacing="compact">
39 <listitem>
40 <para>
41 Download (HTTP): <ulink url="&sawfish-download-http;"/>
42 </para>
43 </listitem>
44 <listitem>
45 <para>
46 Download (FTP): <ulink url="&sawfish-download-ftp;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download MD5 sum: &sawfish-md5sum;
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download size: &sawfish-size;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Estimated disk space required: &sawfish-buildsize;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated build time: &sawfish-time;
67 </para>
68 </listitem>
69 </itemizedlist>
70
71<!--
72 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
73 <itemizedlist spacing="compact">
74 <listitem>
75 <para>
76 Required patch:
77 <ulink url="&patch-root;/sawfish-&sawfish-version;-gcc10_fixes-1.patch"/>
78 </para>
79 </listitem>
80 </itemizedlist>
81-->
82
83 <bridgehead renderas="sect3">sawfish Dependencies</bridgehead>
84
85 <bridgehead renderas="sect4">Required</bridgehead>
86 <para role="required">
87 <xref linkend="gdk-pixbuf-xlib"/>,
88 <xref linkend="rep-gtk"/>, and
89 <xref linkend="which"/>
90 </para>
91
92 <bridgehead renderas="sect4">Optional</bridgehead>
93 <para role="optional">
94 <xref linkend="libnsl"/>
95 </para>
96
97 <para condition="html" role="usernotes">User Notes:
98 <ulink url="&blfs-wiki;/sawfish"/></para>
99
100 </sect2>
101
102 <sect2 role="installation">
103 <title>Installation of sawfish</title>
104
105<!--
106 <para>
107 First, adapt <application>sawfish</application> to build with GCC-10:
108 </para>
109
110<screen><userinput remap="pre">patch -Np1 -i ../sawfish-&sawfish-version;-gcc10_fixes-1.patch</userinput></screen>
111-->
112
113 <para>
114 Install <application>sawfish</application> by running the following
115 commands:
116 </para>
117
118<screen><userinput>./configure --prefix=/usr --with-pango &amp;&amp;
119make</userinput></screen>
120
121 <para>
122 This package does not come with a test suite.
123 </para>
124
125 <para>
126 Now, as the <systemitem class="username">root</systemitem> user:
127 </para>
128
129<screen role="root"><userinput>make install</userinput></screen>
130
131 <para>This package creates six .desktop files in the
132 /usr/share/xsessions/ directory. All but one are needed in a
133 BLFS system, so prevent the extra files showing up as options
134 in a window manager. As the &root; user:</para>
135
136<screen role="root"><userinput>mkdir -p /usr/share/xsessions/deprecated &amp;&amp;
137mv -v /usr/share/xsessions/sawfish-*.desktop /usr/share/xsessions/deprecated</userinput></screen>
138
139 </sect2>
140<!--
141 <sect2 role="commands">
142 <title>Command Explanations</title>
143
144 <para>
145 <parameter>- -disable-themer</parameter>: This
146 option prevents building the <application>sawfish</application> themer.
147 This program was not migrated to <application>GTK-2</application>.
148 </para>
149
150 <para>
151 <option>- -with-audiofile</option>: This command directs
152 <application>sawfish</application> to use
153 <filename class="libraryfile">libaudiofile</filename>
154 for sound manipulation.
155 </para>
156
157 <para>
158 <option>- -with-esd</option>: This command directs
159 <application>sawfish</application> to use the Enlightened Sound
160 Daemon.
161 </para>
162
163 </sect2>
164-->
165 <sect2 role="configuration">
166 <title>Configuring sawfish</title>
167
168 <sect3 id="sawfish-config">
169 <title>Configuration Information</title>
170
171 <indexterm zone="sawfish sawfish-config">
172 <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
173 </indexterm>
174
175 <para>
176 Be sure to backup your current <filename>.xinitrc</filename>
177 before proceeding.
178 </para>
179
180<screen><userinput>cat &gt;&gt; ~/.xinitrc &lt;&lt; "EOF"
181<literal>exec sawfish</literal>
182EOF</userinput></screen>
183
184 <para>
185 Optionally, you can use a Display Manager, such as <xref
186 linkend="lxdm"/>.
187 </para>
188
189 <para>
190 From the developers: <quote>The default menu binding is somewhat
191 obscure; you must middle-click on the background to bring up the menus.
192 (If you have a two-button mouse, try clicking both buttons
193 simultaneously)</quote>. You can find this at <ulink
194 url="https://download.tuxfamily.org/sawfish/themes/FAQ.html/">sawfish's
195 FAQ</ulink>.
196 </para>
197
198 </sect3>
199
200 </sect2>
201
202 <sect2 role="content">
203 <title>Contents</title>
204
205 <segmentedlist>
206 <segtitle>Installed Programs</segtitle>
207 <segtitle>Installed Libraries</segtitle>
208 <segtitle>Installed Directory</segtitle>
209
210 <seglistitem>
211 <seg>
212 sawfish, sawfish-about, sawfish-client, sawfish-config,
213 sawfish-kde4-session, sawfish-kde5-session, sawfish-lumina-session,
214 sawfish-mate-session, and sawfish-xfce-session
215 </seg>
216 <seg>
217 Several internal modules under /usr/lib/sawfish tree
218 </seg>
219 <seg>
220 /usr/include/sawfish,
221 /usr/lib/sawfish,
222 /usr/lib/rep/sawfish, and
223 /usr/share/sawfish
224 </seg>
225 </seglistitem>
226 </segmentedlist>
227
228 <variablelist>
229 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
230 <?dbfo list-presentation="list"?>
231 <?dbhtml list-presentation="table"?>
232
233 <varlistentry id="sawfish-prog">
234 <term><command>sawfish</command></term>
235 <listitem>
236 <para>
237 is the extensible window manager using a
238 <application>Lisp</application>-based scripting language
239 </para>
240 <indexterm zone="sawfish sawfish-prog">
241 <primary sortas="b-sawfish">sawfish</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry id="sawfish-about">
247 <term><command>sawfish-about</command></term>
248 <listitem>
249 <para>
250 is the <application>sawfish</application> about window
251 </para>
252 <indexterm zone="sawfish sawfish-about">
253 <primary sortas="b-sawfish-about">sawfish-about</primary>
254 </indexterm>
255 </listitem>
256 </varlistentry>
257
258 <varlistentry id="sawfish-client">
259 <term><command>sawfish-client</command></term>
260 <listitem>
261 <para>
262 allows you to connect to a window manager process and
263 evaluate arbitrary <application>Lisp</application> forms
264 </para>
265 <indexterm zone="sawfish sawfish-client">
266 <primary sortas="b-sawfish-client">sawfish-client</primary>
267 </indexterm>
268 </listitem>
269 </varlistentry>
270
271 <varlistentry id="sawfish-config-prog">
272 <term><command>sawfish-config</command></term>
273 <listitem>
274 <para>
275 is the <application>sawfish</application> configuration manager
276 </para>
277 <indexterm zone="sawfish sawfish-config-prog">
278 <primary sortas="b-sawfish-config-prog">sawfish-config</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 <varlistentry id="sawfish-kde4-session">
284 <term><command>sawfish-kde4-session</command></term>
285 <listitem>
286 <para>
287 is a script to run <application>KDE4</application> using
288 <application>sawfish</application>
289 </para>
290 <indexterm zone="sawfish sawfish-kde4-session">
291 <primary sortas="b-sawfish-kde4-session">sawfish-kde4-session</primary>
292 </indexterm>
293 </listitem>
294 </varlistentry>
295
296 <varlistentry id="sawfish-kde5-session">
297 <term><command>sawfish-kde5-session</command></term>
298 <listitem>
299 <para>
300 is a script to run <application>Plasma 5</application> using
301 <application>sawfish</application>
302 </para>
303 <indexterm zone="sawfish sawfish-kde5-session">
304 <primary sortas="b-sawfish-kde5-session">sawfish-kde5-session</primary>
305 </indexterm>
306 </listitem>
307 </varlistentry>
308
309 <varlistentry id="sawfish-mate-session">
310 <term><command>sawfish-mate-session</command></term>
311 <listitem>
312 <para>
313 is a script to run <application>mate</application> using
314 <application>sawfish</application>
315 </para>
316 <indexterm zone="sawfish sawfish-mate-session">
317 <primary sortas="b-sawfish-mate-session">sawfish-mate-session</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="sawfish-lumina-session">
323 <term><command>sawfish-lumina-session</command></term>
324 <listitem>
325 <para>
326 is a script to run <application>Lumina</application> using
327 <application>sawfish</application>
328 </para>
329 <indexterm zone="sawfish sawfish-lumina-session">
330 <primary sortas="b-sawfish-lumina-session">sawfish-lumina-session</primary>
331 </indexterm>
332 </listitem>
333 </varlistentry>
334
335 <varlistentry id="sawfish-xfce-session">
336 <term><command>sawfish-xfce-session</command></term>
337 <listitem>
338 <para>
339 is a script to run <application>xfce</application> using
340 <application>sawfish</application>
341 </para>
342 <indexterm zone="sawfish sawfish-xfce-session">
343 <primary sortas="b-sawfish-xfce-session">sawfish-xfce-session</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347
348 </variablelist>
349
350 </sect2>
351
352</sect1>
Note: See TracBrowser for help on using the repository browser.