source: general/genutils/xscreensaver.xml@ a4d8b6f

10.0 10.1 11.0 11.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since a4d8b6f was a4d8b6f, checked in by Wayne Blaszczyk <wblaszcz@…>, 12 years ago

Updated to XScreenSaver-5.11.

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

  • Property mode set to 100644
File size: 10.9 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 "http://www.jwz.org/xscreensaver/xscreensaver-&xscreensaver-version;.tar.gz">
8 <!ENTITY xscreensaver-download-ftp " ">
9 <!ENTITY xscreensaver-md5sum "80f981b86734ccb31c5b3b24af3930ae">
10 <!ENTITY xscreensaver-size "5.3 MB">
11 <!ENTITY xscreensaver-buildsize "135 MB">
12 <!ENTITY xscreensaver-time "1.1 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>The <application>XScreenSaver</application> is a modular screen
33 saver and locker for the X Window System. It is highly customizable and
34 allows the use of any program that can draw on the root window as a
35 display mode. The purpose of <application>XScreenSaver</application> is
36 to display pretty pictures on your screen when it is not in use, in
37 keeping with the philosophy that unattended monitors should always be
38 doing something interesting, just like they do in the movies. However,
39 <application>XScreenSaver</application> can also be used as a screen
40 locker, to prevent others from using your terminal while you are
41 away.</para>
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>Download (HTTP): <ulink url="&xscreensaver-download-http;"/></para>
47 </listitem>
48 <listitem>
49 <para>Download (FTP): <ulink url="&xscreensaver-download-ftp;"/></para>
50 </listitem>
51 <listitem>
52 <para>Download MD5 sum: &xscreensaver-md5sum;</para>
53 </listitem>
54 <listitem>
55 <para>Download size: &xscreensaver-size;</para>
56 </listitem>
57 <listitem>
58 <para>Estimated disk space required: &xscreensaver-buildsize;</para>
59 </listitem>
60 <listitem>
61 <para>Estimated build time: &xscreensaver-time;</para>
62 </listitem>
63 </itemizedlist>
64
65 <bridgehead renderas="sect3">XScreenSaver Dependencies</bridgehead>
66
67 <bridgehead renderas="sect4">Required</bridgehead>
68 <para role="required"><xref linkend="bc"/> and
69 <xref linkend="libglade"/> (alternatively
70 <xref linkend="lesstif"/> but not recommended)</para>
71
72 <bridgehead renderas="sect4">Optional</bridgehead>
73 <para role="optional"><xref linkend="libjpeg"/>,
74 <xref linkend="libgnome"/>,
75 <ulink url="http://linas.org/gle/">GLE</ulink>,
76 <ulink url="http://netpbm.sourceforge.net/">Netpbm</ulink>,
77 <ulink url="http://www.jwz.org/xdaliclock/">XDaliClock</ulink>,
78 <xref linkend="linux-pam"/>,
79 <xref linkend="mitkrb"/> (built with Kerberos V4 backwards compatibility), and
80 <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink> and
81 <xref linkend="heimdal"/> (Kerberos authentication requires having Kerberos
82 V4 and V5 on the system)</para>
83
84 <para condition="html" role="usernotes">User Notes:
85 <ulink url="&blfs-wiki;/xscreensaver"/></para>
86
87 </sect2>
88
89 <sect2 role="installation">
90 <title>Installation of XScreenSaver</title>
91
92 <!-- Apparently, this issue is now fixed
93 <para><application>XScreenSaver</application> makes some poor choices
94 where to put all the files if <application>GNOME</application> is installed.
95 To get around this, run the following command and see an optional configure
96 switch described later below.</para>
97
98<screen><userinput>sed -i -e "s,@GNOME_DATADIR@,$GNOME_PREFIX/share," driver/Makefile.in</userinput></screen>
99 -->
100
101 <para>Install <application>XScreenSaver</application> by running the following
102 commands:</para>
103
104 <!-- sed -i 's,\xc3\xb6,oe,' hacks/flow.man -->
105
106<screen><userinput>./configure --prefix=/usr --libexecdir=/usr/lib &amp;&amp;
107make</userinput></screen>
108
109 <para>This package does not come with a test suite.</para>
110
111 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
112
113<screen role="root"><userinput>make install</userinput></screen>
114
115 </sect2>
116
117 <sect2 role="commands">
118 <title>Command Explanations</title>
119
120 <!-- <para><command>sed -i 's,\xc3\xb6,oe,' hacks/flow.man</command>: This
121 command replaces the UTF-8 encoded character <quote>&ouml;</quote>
122 with its ASCII equivalent <quote>oe</quote> in one of the installed
123 manual pages. Without this, <application>Man-DB</application> would
124 interpret these two bytes as ISO-8859-1, resulting in
125 the wrong <quote>&Atilde;&para;</quote> characters.</para> -->
126
127 <para><option>--with-setuid-hacks</option>: This switch allows some
128 demos to be installed setuid <systemitem class="username">root</systemitem>
129 which is needed in order to ping other hosts.</para>
130
131 <para><option>--enable-locking</option>: This switch provides support for
132 locking the display.</para>
133
134 <!-- Not required any longer
135 <para><option>-with-configdir=/usr/lib/xscreensaver/config</option>:
136 If <application>GNOME</application> is installed, you can use this
137 switch to put the configuration files in a single directory rather than
138 spreading them all over the disk.</para>
139 -->
140
141 </sect2>
142
143 <sect2 role="configuration">
144 <title>Configuring XScreenSaver</title>
145
146 <sect3 id="xscreensaver-config">
147 <title>Config Files</title>
148
149 <para><filename>/etc/X11/app-defaults/XScreenSaver</filename>,
150 <filename>~/.xscreensaver</filename> and
151 <filename>/etc/pam.d/xscreensaver</filename> or
152 <filename>/etc/pam.conf</filename></para>
153
154 <indexterm zone="xscreensaver xscreensaver-config">
155 <primary sortas="e-etc-X11-app-defaults-XScreenSaver">.../app-.../XScreenSaver</primary>
156 </indexterm>
157 <indexterm zone="xscreensaver xscreensaver-config">
158 <primary sortas="e-AA.xscreensaver">~/.xscreensaver</primary>
159 </indexterm>
160 <indexterm zone="xscreensaver xscreensaver-config">
161 <primary sortas="e-etc-pam.d-xscreensaver">/etc/pam.d/xscreensaver</primary>
162 </indexterm>
163 <indexterm zone="xscreensaver xscreensaver-config">
164 <primary sortas="e-etc-pam.conf">/etc/pam.conf</primary>
165 </indexterm>
166
167 </sect3>
168
169 </sect2>
170
171 <sect2 role="content">
172 <title>Contents</title>
173
174 <segmentedlist>
175 <segtitle>Installed Programs</segtitle>
176 <segtitle>Installed Libraries</segtitle>
177 <segtitle>Installed Directories</segtitle>
178
179 <seglistitem>
180 <seg>xscreensaver, xscreensaver-command, xscreensaver-demo, xscreensaver-getimage,
181 xscreensaver-getimage-file, xscreensaver-getimage-video, xscreensaver-gl-helper,
182 and xscreensaver-text</seg>
183 <seg>None</seg>
184 <seg>/usr/{lib/xscreensaver,share/xscreensaver/{config,glade}}</seg>
185 </seglistitem>
186 </segmentedlist>
187
188 <variablelist>
189 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
190 <?dbfo list-presentation="list"?>
191 <?dbhtml list-presentation="table"?>
192
193 <varlistentry id="xscreensaver-prog">
194 <term><command>xscreensaver</command></term>
195 <listitem>
196 <para>is a screen saver and locker daemon.</para>
197 <indexterm zone="xscreensaver xscreensaver-prog">
198 <primary sortas="b-xscreensaver">xscreensaver</primary>
199 </indexterm>
200 </listitem>
201 </varlistentry>
202
203 <varlistentry id="xscreensaver-command">
204 <term><command>xscreensaver-command</command></term>
205 <listitem>
206 <para>controls a running <command>xscreensaver</command>
207 process by sending it client messages.</para>
208 <indexterm zone="xscreensaver xscreensaver-command">
209 <primary sortas="b-xscreensaver-command">xscreensaver-command</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213
214 <varlistentry id="xscreensaver-demo">
215 <term><command>xscreensaver-demo</command></term>
216 <listitem>
217 <para>is a graphical front-end for setting the parameters used
218 by the background <command>xscreensaver</command> daemon.</para>
219 <indexterm zone="xscreensaver xscreensaver-demo">
220 <primary sortas="b-xscreensaver-demo">xscreensaver-demo</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="xscreensaver-getimage">
226 <term><command>xscreensaver-getimage</command></term>
227 <listitem>
228 <para>is a helper program for the <command>xscreensaver</command>
229 modules that manipulate images.</para>
230 <indexterm zone="xscreensaver xscreensaver-getimage">
231 <primary sortas="b-xscreensaver-getimaage">xscreensaver-getimage</primary>
232 </indexterm>
233 </listitem>
234 </varlistentry>
235
236 <varlistentry id="xscreensaver-getimage-file">
237 <term><command>xscreensaver-getimage-file</command></term>
238 <listitem>
239 <para>is a helper program for the <command>xscreensaver</command>
240 modules that manipulate images.</para>
241 <indexterm zone="xscreensaver xscreensaver-getimage-file">
242 <primary sortas="b-xscreensaver-getimaage-file">xscreensaver-getimage-file</primary>
243 </indexterm>
244 </listitem>
245 </varlistentry>
246
247 <varlistentry id="xscreensaver-getimage-video">
248 <term><command>xscreensaver-getimage-video</command></term>
249 <listitem>
250 <para>is a helper program for the <command>xscreensaver</command>
251 modules that manipulate images.</para>
252 <indexterm zone="xscreensaver xscreensaver-getimage-video">
253 <primary sortas="b-xscreensaver-getimaage-video">xscreensaver-getimage-video</primary>
254 </indexterm>
255 </listitem>
256 </varlistentry>
257
258 <varlistentry id="xscreensaver-gl-helper">
259 <term><command>xscreensaver-gl-helper</command></term>
260 <listitem>
261 <para>is a helper program for the <command>xscreensaver</command>
262 OpenGL modules.</para>
263 <indexterm zone="xscreensaver xscreensaver-gl-helper">
264 <primary sortas="b-xscreensaver-gl-helper">xscreensaver-gl-helper</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268
269 <varlistentry id="xscreensaver-text">
270 <term><command>xscreensaver-text</command></term>
271 <listitem>
272 <para>prints some text to stdout, for use by screen savers.</para>
273 <indexterm zone="xscreensaver xscreensaver-text">
274 <primary sortas="b-xscreensaver-text">xscreensaver-text</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278 </variablelist>
279
280 </sect2>
281
282</sect1>
Note: See TracBrowser for help on using the repository browser.