source: xsoft/other/xscreensaver.xml@ 689de0e

11.0 qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 689de0e was 689de0e, checked in by Ken Moffat <ken@…>, 6 months ago

Minor tweaks to xscreensaver contents.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24434 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 11.6 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 xscreensaver-download-http "https://www.jwz.org/xscreensaver/xscreensaver-&xscreensaver-version;.tar.gz">
8 <!ENTITY xscreensaver-download-ftp " ">
9 <!ENTITY xscreensaver-md5sum "0c77c3d46a4b4d11fdef1d368349ed7a">
10 <!ENTITY xscreensaver-size "27 MB">
11 <!ENTITY xscreensaver-buildsize "265 MB">
12 <!ENTITY xscreensaver-time "1.0 SBU">
13]>
14
15<sect1 id="xscreensaver" xreflabel="XScreenSaver-&xscreensaver-version;">
16 <?dbhtml filename="xscreensaver.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>XScreenSaver-&xscreensaver-version;</title>
24
25 <indexterm zone="xscreensaver">
26 <primary sortas="a-XScreenSaver">XScreenSaver</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to XScreenSaver</title>
31
32 <para>
33 The <application>XScreenSaver</application> package is a modular screen
34 saver and locker for the X Window System. It is highly customizable and
35 allows the use of any program that can draw on the root window as a
36 display mode. The purpose of <application>XScreenSaver</application> is
37 to display pretty pictures on your screen when it is not in use, in
38 keeping with the philosophy that unattended monitors should always be
39 doing something interesting, just like they do in the movies. However,
40 <application>XScreenSaver</application> can also be used as a screen
41 locker, to prevent others from using your terminal while you are away.
42 </para>
43
44 &lfs101_checked;
45
46 <bridgehead renderas="sect3">Package Information</bridgehead>
47 <itemizedlist spacing="compact">
48 <listitem>
49 <para>
50 Download (HTTP): <ulink url="&xscreensaver-download-http;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download (FTP): <ulink url="&xscreensaver-download-ftp;"/>
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download MD5 sum: &xscreensaver-md5sum;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download size: &xscreensaver-size;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated disk space required: &xscreensaver-buildsize;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Estimated build time: &xscreensaver-time;
76 </para>
77 </listitem>
78 </itemizedlist>
79
80 <bridgehead renderas="sect3">XScreenSaver Dependencies</bridgehead>
81
82 <bridgehead renderas="sect4">Required</bridgehead>
83 <para role="required">
84 <xref linkend="gdk-pixbuf-xlib"/>,
85 <xref linkend="libglade"/>, and
86 <xref linkend="xorg7-app"/>
87 <xref linkend="fontconfig"/>
88 <xref linkend="freetype2"/>
89 </para>
90
91 <bridgehead renderas="sect4">Recommended</bridgehead>
92 <para role="recommended">
93 <xref linkend="glu"/>
94 </para>
95
96 <bridgehead renderas="sect4">Optional</bridgehead>
97 <para role="optional">
98 <xref linkend="gdm"/>,
99 <xref linkend="mitkrb"/>,
100 <ulink url="http://linas.org/gle/">GLE</ulink> and
101 <xref linkend="linux-pam"/>
102 </para>
103
104
105 <para condition="html" role="usernotes">User Notes:
106 <ulink url="&blfs-wiki;/xscreensaver"/>
107 </para>
108 </sect2>
109
110 <sect2 role="installation">
111 <title>Installation of XScreenSaver</title>
112
113 <para revision="sysv">
114 Change a harcoded library name, which prevents using the settings found
115 by <command>configure</command>:
116 </para>
117
118<screen revision="sysv"><userinput>sed -i 's/-lsystemd/-lelogind/' driver/Makefile.in</userinput></screen>
119
120 <para>
121 Install <application>XScreenSaver</application> by running the following
122 commands:
123 </para>
124
125<screen><userinput>./configure --prefix=/usr &amp;&amp;
126make</userinput></screen>
127
128 <para>
129 This package does not come with a test suite.
130 </para>
131
132 <!-- EDITORS NOTE: Use install_prefix instead of DESTDIR -->
133 <para>
134 Now, as the <systemitem class="username">root</systemitem> user:
135 </para>
136
137<screen role="root"><userinput>make install</userinput></screen>
138
139 </sect2>
140
141 <sect2 role="commands">
142 <title>Command Explanations</title>
143
144 <para>
145 <option>--with-setuid-hacks</option>: This switch allows some demos
146 to be installed setuid <systemitem class="username">root</systemitem>
147 which is needed in order to ping other hosts.
148 </para>
149
150 </sect2>
151
152 <sect2 role="configuration">
153 <title>Configuring XScreenSaver</title>
154
155 <sect3 id="xscreensaver-config">
156 <title>Config Files</title>
157
158 <para>
159 <filename>/etc/X11/app-defaults/XScreenSaver</filename> and
160 <filename>~/.xscreensaver</filename>
161 </para>
162
163 <indexterm zone="xscreensaver xscreensaver-config">
164 <primary sortas="e-etc-X11-app-defaults-XScreenSaver">/etc/X11/app-defaults/XScreenSaver</primary>
165 </indexterm>
166 <indexterm zone="xscreensaver xscreensaver-config">
167 <primary sortas="e-AA.xscreensaver">~/.xscreensaver</primary>
168 </indexterm>
169
170 </sect3>
171
172 <sect3>
173 <title>Linux PAM Configuration</title>
174
175 <para>
176 If <application>XScreenSaver</application> has been built with
177 <application>Linux PAM</application> support, you need to create a
178 <application>PAM</application> configuration file, to get it working
179 correctly with BLFS.
180 </para>
181
182 <para>
183 Issue the following commands as the <systemitem
184 class="username">root</systemitem> user to create the configuration
185 file for <application>Linux PAM</application>:
186 </para>
187
188<screen role="root"><userinput>cat &gt; /etc/pam.d/xscreensaver &lt;&lt; "EOF"
189<literal># Begin /etc/pam.d/xscreensaver
190
191auth include system-auth
192account include system-account
193
194# End /etc/pam.d/xscreensaver</literal>
195EOF</userinput></screen>
196
197 </sect3>
198
199 </sect2>
200
201 <sect2 role="content">
202 <title>Contents</title>
203
204 <segmentedlist>
205 <segtitle>Installed Programs</segtitle>
206 <segtitle>Installed Libraries</segtitle>
207 <segtitle>Installed Directories</segtitle>
208
209 <seglistitem>
210 <seg>
211 xscreensaver, xscreensaver-command, xscreensaver-demo, xscreensaver-getimage,
212 xscreensaver-getimage-file, xscreensaver-getimage-video,
213 xscreensaver-gl-helper, xscreensaver-settings and xscreensaver-text
214 </seg>
215 <seg>
216 None
217 </seg>
218 <seg>
219 /usr/libexec/xscreensaver and
220 /usr/share/xscreensaver
221 </seg>
222 </seglistitem>
223 </segmentedlist>
224
225 <variablelist>
226 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
227 <?dbfo list-presentation="list"?>
228 <?dbhtml list-presentation="table"?>
229
230 <varlistentry id="xscreensaver-prog">
231 <term><command>xscreensaver</command></term>
232 <listitem>
233 <para>
234 is a screen saver and locker daemon
235 </para>
236 <indexterm zone="xscreensaver xscreensaver-prog">
237 <primary sortas="b-xscreensaver">xscreensaver</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="xscreensaver-command">
243 <term><command>xscreensaver-command</command></term>
244 <listitem>
245 <para>
246 controls a running <command>xscreensaver</command>
247 process by sending it client messages
248 </para>
249 <indexterm zone="xscreensaver xscreensaver-command">
250 <primary sortas="b-xscreensaver-command">xscreensaver-command</primary>
251 </indexterm>
252 </listitem>
253 </varlistentry>
254
255 <varlistentry id="xscreensaver-demo">
256 <term><command>xscreensaver-demo</command></term>
257 <listitem>
258 <para>
259 is a symlink to <command>xscreensaver-settings</command>
260 </para>
261 <indexterm zone="xscreensaver xscreensaver-demo">
262 <primary sortas="b-xscreensaver-demo">xscreensaver-demo</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 <varlistentry id="xscreensaver-getimage">
268 <term><command>xscreensaver-getimage</command></term>
269 <listitem>
270 <para>
271 is a helper program for the <command>xscreensaver</command>
272 modules that manipulate images
273 </para>
274 <indexterm zone="xscreensaver xscreensaver-getimage">
275 <primary sortas="b-xscreensaver-getimaage">xscreensaver-getimage</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="xscreensaver-getimage-file">
281 <term><command>xscreensaver-getimage-file</command></term>
282 <listitem>
283 <para>
284 is a helper program for the <command>xscreensaver</command>
285 modules that manipulate images
286 </para>
287 <indexterm zone="xscreensaver xscreensaver-getimage-file">
288 <primary sortas="b-xscreensaver-getimaage-file">xscreensaver-getimage-file</primary>
289 </indexterm>
290 </listitem>
291 </varlistentry>
292
293 <varlistentry id="xscreensaver-getimage-video">
294 <term><command>xscreensaver-getimage-video</command></term>
295 <listitem>
296 <para>
297 is a helper program for the <command>xscreensaver</command>
298 modules that manipulate images
299 </para>
300 <indexterm zone="xscreensaver xscreensaver-getimage-video">
301 <primary sortas="b-xscreensaver-getimaage-video">xscreensaver-getimage-video</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 <varlistentry id="xscreensaver-gl-helper">
307 <term><command>xscreensaver-gl-helper</command></term>
308 <listitem>
309 <para>
310 is a helper program for the <command>xscreensaver</command>
311 OpenGL modules
312 </para>
313 <indexterm zone="xscreensaver xscreensaver-gl-helper">
314 <primary sortas="b-xscreensaver-gl-helper">xscreensaver-gl-helper</primary>
315 </indexterm>
316 </listitem>
317 </varlistentry>
318
319 <varlistentry id="xscreensaver-gl-visual">
320 <term><command>xscreensaver-gl-visual</command></term>
321 <listitem>
322 <para>
323 is a helper program for the <command>xscreensaver</command>
324 OpenGL modules to figure out which X visual to use
325 </para>
326 <indexterm zone="xscreensaver xscreensaver-gl-visual">
327 <primary sortas="b-xscreensaver-gl-visual">xscreensaver-gl-visual</primary>
328 </indexterm>
329 </listitem>
330 </varlistentry>
331
332 <varlistentry id="xscreensaver-settings">
333 <term><command>xscreensaver-settings</command></term>
334 <listitem>
335 <para>
336 is a graphical front-end for setting the parameters used
337 by the background <command>xscreensaver</command> daemon
338 </para>
339 <indexterm zone="xscreensaver xscreensaver-settings">
340 <primary sortas="b-xscreensaver-settings">xscreensaver-settings</primary>
341 </indexterm>
342 </listitem>
343 </varlistentry>
344
345 <varlistentry id="xscreensaver-text">
346 <term><command>xscreensaver-text</command></term>
347 <listitem>
348 <para>
349 prints some text to stdout, for use by screen savers
350 </para>
351 <indexterm zone="xscreensaver xscreensaver-text">
352 <primary sortas="b-xscreensaver-text">xscreensaver-text</primary>
353 </indexterm>
354 </listitem>
355 </varlistentry>
356
357 </variablelist>
358
359 </sect2>
360
361</sect1>
Note: See TracBrowser for help on using the repository browser.