source: x/wm/sawfish.xml

trunk
Last change on this file was 94c92ff, checked in by Douglas R. Reno <renodr@…>, 4 months ago

Tag LXDE, Sawfish, and XScreenSaver.

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