source: gnome/add/gnome-screensaver.xml@ 0498a0c6

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 0498a0c6 was 0498a0c6, checked in by Wayne Blaszczyk <wblaszcz@…>, 12 years ago

Updated to gnome-screensaver-2.28.0.

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

  • Property mode set to 100644
File size: 11.2 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 gnome-screensaver-download-http "&gnome-download-http;/gnome-screensaver/&gnome-version;/gnome-screensaver-&gnome-screensaver-version;.tar.bz2">
8 <!ENTITY gnome-screensaver-download-ftp "&gnome-download-ftp;/gnome-screensaver/&gnome-version;/gnome-screensaver-&gnome-screensaver-version;.tar.bz2">
9 <!ENTITY gnome-screensaver-md5sum "b37d4a210cac22a7312f9736f0c4356f">
10 <!ENTITY gnome-screensaver-size "4.6 MB">
11 <!ENTITY gnome-screensaver-buildsize "25 MB">
12 <!ENTITY gnome-screensaver-time "0.3 SBU">
13]>
14
15<sect1 id="gnome-screensaver" xreflabel="gnome-screensaver-&gnome-screensaver-version;">
16 <?dbhtml filename="gnome-screensaver.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>gnome-screensaver-&gnome-screensaver-version;</title>
24
25 <indexterm zone="gnome-screensaver">
26 <primary sortas="a-gnome-screensaver">gnome-screensaver</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to gnome-screensaver</title>
31
32 <para>The <application>gnome-screensaver</application> package contains a
33 screen saver and locker designed to have simple, sane, secure defaults
34 and be well integrated with the desktop. It supports locking down of
35 configuration settings, has translations into many languages and
36 convenient user switching.</para>
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>Download (HTTP): <ulink url="&gnome-screensaver-download-http;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download (FTP): <ulink url="&gnome-screensaver-download-ftp;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download MD5 sum: &gnome-screensaver-md5sum;</para>
48 </listitem>
49 <listitem>
50 <para>Download size: &gnome-screensaver-size;</para>
51 </listitem>
52 <listitem>
53 <para>Estimated disk space required: &gnome-screensaver-buildsize;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated build time: &gnome-screensaver-time;</para>
57 </listitem>
58 </itemizedlist>
59
60 <bridgehead renderas="sect3">gnome-screensaver Dependencies</bridgehead>
61
62 <bridgehead renderas="sect4">Required</bridgehead>
63 <para role="required"><xref linkend="gnome-desktop"/> and
64 <xref linkend="gnome-menus"/></para>
65
66 <bridgehead renderas="sect4">Optional</bridgehead>
67 <para role="optional"><xref linkend="libgnomekbd"/>,
68 <xref linkend="libnotify"/>,
69 <xref linkend="xscreensaver"/>
70 (and <xref linkend="libxslt"/>),
71 <ulink url="http://www.mono-project.com/Main_Page">Mono</ulink>, and
72 <xref linkend="xmlto"/></para>
73
74 <para condition="html" role="usernotes">User Notes:
75 <ulink url="&blfs-wiki;/gnome-screensaver"/></para>
76
77 </sect2>
78
79 <sect2 role="installation">
80 <title>Installation of gnome-screensaver</title>
81
82 <note>
83 <para><emphasis>Optional Features</emphasis></para>
84
85 <para>If you have <application>XScreenSaver</application> installed and
86 wish to import any or all of the <quote>hacks</quote> into
87 <application>gnome-screensaver</application> themes, set the following
88 environment variable (modify it if <application>XScreenSaver</application>
89 is installed in a non-standard location):</para>
90
91<screen><userinput>XSAVERDIR=/usr/share/xscreensaver/config</userinput></screen>
92
93 <para>Also add the following parameter to the <command>configure</command>
94 script below:</para>
95
96<screen><userinput> --with-xscreensaverdir=$XSAVERDIR</userinput></screen>
97 </note>
98
99 <para>Install <application>gnome-screensaver</application> by running the
100 following commands:</para>
101
102<screen><userinput>sed -i 's|etc/pam\.d"|etc"|' data/Makefile.in &amp;&amp;
103./configure --prefix=$(pkg-config --variable=prefix ORBit-2.0) \
104 --sysconfdir=&gnome-etc-dir; \
105 --libexecdir=$(pkg-config \
106 --variable=prefix ORBit-2.0)/lib/gnome-screensaver \
107 --with-pam-prefix=/etc &amp;&amp;
108make</userinput></screen>
109
110 <para>If you have <application>XScreenSaver</application> installed and
111 wish to import any or all of the <quote>hacks</quote> into
112 <application>gnome-screensaver</application> themes, you'll need to
113 identify which <quote>hacks</quote> you wish to import. The commands
114 below will import all of them. If you want to import less than all of
115 them, modify the setting of the <envar>XSAVERLIST</envar> environment
116 variable below (listing the desired hacks by filename without the
117 extension, space delimited) and issue the following commands:</para>
118
119<screen><userinput>mkdir xscreensavers &amp;&amp;
120cd xscreensavers &amp;&amp;
121
122XSAVERLIST="*" &amp;&amp;
123
124for SAVERLIST in $(ls ${XSAVERDIR}/${XSAVERLIST}.xml); do
125 ../data/migrate-xscreensaver-config.sh $SAVERLIST
126done &amp;&amp;
127
128unset XSAVERDIR
129unset XSAVERLIST
130unset SAVERLIST
131
132cd ..</userinput></screen>
133
134 <para>This package does not come with a test suite.</para>
135
136 <para>Now, as the <systemitem class='username'>root</systemitem> user:</para>
137
138<screen role='root'><userinput>make install</userinput></screen>
139
140 <para>If you have <application>xmlto</application> installed, still as the
141 <systemitem class='username'>root</systemitem> user issuing the following
142 commands:</para>
143
144<screen role='root'><userinput>GNOMEDOCDIR="$(pkg-config \
145 --variable=prefix ORBit-2.0)/share/doc/gnome-screensaver-&gnome-screensaver-version;" &amp;&amp;
146
147install -v -m644 -D doc/gnome-screensaver.html \
148 ${GNOMEDOCDIR}/gnome-screensaver.html &amp;&amp;
149unset GNOMEDOCDIR</userinput></screen>
150
151 <para>If you identified some, or all,
152 <application>XScreenSaver</application> hacks to be imported into
153 <application>gnome-screensaver</application>, install them by issuing the
154 following commands as the <systemitem class='username'>root</systemitem>
155 user:</para>
156
157<screen role='root'><userinput>install -v -m755 -d $(pkg-config --variable=prefix \
158 ORBit-2.0)/share/gnome-screensaver/themes/xscreensaver &amp;&amp;
159install -v -m644 xscreensavers/*.desktop \
160 $(pkg-config --variable=prefix \
161 ORBit-2.0)/share/gnome-screensaver/themes/xscreensaver</userinput></screen>
162
163 </sect2>
164
165 <sect2 role="commands">
166 <title>Command Explanations</title>
167
168 <para><command>sed -i 's|etc/pam\.d"|etc|' data/Makefile.in</command>:
169 This command is used so that an erroneous message to copy the PAM
170 configuration file is not displayed.</para>
171
172 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
173 href="../../xincludes/gnome-prefix.xml"/>
174
175 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
176 href="../../xincludes/gnome-sysconfdir.xml"/>
177
178 <para><parameter>--libexecdir=$(pkg-config --variable=prefix
179 ORBit-2.0)/lib/gnome-screensaver</parameter>: This parameter causes the
180 libexec files to be installed in the preferred location of
181 <filename class="directory">$GNOME_PREFIX/lib/gnome-screensaver</filename>
182 instead of
183 <filename class="directory">$GNOME_PREFIX/libexec</filename>.</para>
184
185 <para><parameter>--with-pam-prefix=/etc</parameter>: This parameter is
186 used so that the <application>Linux-PAM</application> configuration file
187 for the <application>gnome-screensaver</application> application is
188 installed in the correct location. You may omit this parameter if you
189 don't have <application>Linux-PAM</application> installed, though it
190 won't affect the build if you don't.</para>
191
192 <para><option>--with-xscreensaverdir=$XSAVERDIR</option>: This parameter
193 will use the xscreensaver hack configs found in
194 <envar>$XSAVERDIR</envar>.</para>
195
196 </sect2>
197
198 <sect2 role="configuration">
199 <title>Configuring gnome-screensaver</title>
200
201 <sect3 id="gnome-screensaver-config">
202 <title>Config Files</title>
203
204 <para><filename>/etc/pam.d/gnome-screensaver</filename>,
205 <filename>&gnome-etc-dir;/gdm/custom.conf</filename></para>
206
207 <indexterm zone="gnome-screensaver gnome-screensaver-config">
208 <primary sortas="e-etc-pam.d-gnome-screensaver">
209 /etc/pam.d/gnome-screensaver</primary>
210 </indexterm>
211 <indexterm zone="gnome-screensaver gnome-screensaver-config">
212 <primary sortas="etc-gnome-&gnome-old-version;&gnome-minor-version;gdm-custom.conf">
213 &gnome-etc-dir;/gdm/custom.conf</primary>
214 </indexterm>
215
216 </sect3>
217
218 <sect3>
219 <title>Configuration Information</title>
220
221 <sect4>
222 <title>General Configuration</title>
223
224 <para>Most of the <application>gnome-screensaver</application>
225 configuration parameters can be modified using the
226 <guimenuitem>Screensaver</guimenuitem> menu item from the
227 <guimenu>Desktop</guimenu>&mdash;<guisubmenu>Preferences</guisubmenu>
228 drop-down menu. Some of the fine-tuning parameters are only available
229 using <xref linkend="gconf-editor"/>.</para>
230
231 </sect4>
232
233 <sect4>
234 <title>Linux-PAM Configuration</title>
235
236 <para>If you have <application>Linux-PAM</application> installed, the
237 just-installed <filename>gnome-screensaver</filename> configuration
238 file does not work with a BLFS system. Replace the existing file with
239 one that can be used on a BLFS system by issuing the following command
240 as the <systemitem class='username'>root</systemitem> user:</para>
241
242<screen role="root"><userinput>cat &gt; /etc/pam.d/gnome-screensaver &lt;&lt; "EOF"
243<literal># File: /etc/pam.d/gnome-screensaver
244
245auth required pam_unix.so
246account required pam_unix.so
247session required pam_unix.so
248password required pam_unix.so</literal>
249
250EOF
251chmod -v 644 /etc/pam.d/gnome-screensaver</userinput></screen>
252
253 </sect4>
254
255 </sect3>
256
257 </sect2>
258
259 <sect2 role="content">
260 <title>Contents</title>
261
262 <segmentedlist>
263 <segtitle>Installed Programs</segtitle>
264 <segtitle>Installed Libraries</segtitle>
265 <segtitle>Installed Directories</segtitle>
266
267 <seglistitem>
268 <seg>gnome-screensaver, gnome-screensaver-command and
269 gnome-screensaver-preferences</seg>
270 <seg>None</seg>
271 <seg><envar>$GNOME_PREFIX</envar>/{lib/gnome-screensaver/gnome-screensaver,
272 share/{applications/screensavers,backgrounds/cosmos,gnome-screensaver,
273 doc/gnome-screensaver-&gnome-screensaver-version;}}</seg>
274 </seglistitem>
275 </segmentedlist>
276
277 <variablelist>
278 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
279 <?dbfo list-presentation="list"?>
280 <?dbhtml list-presentation="table"?>
281
282 <varlistentry id="gnome-screensaver-prog">
283 <term><command>gnome-screensaver</command></term>
284 <listitem>
285 <para>is a screensaver and screen-locking program designed to
286 work seamlessly with the GNOME desktop.</para>
287 <indexterm zone="gnome-screensaver gnome-screensaver-prog">
288 <primary sortas="b-gnome-screensaver">gnome-screensaver</primary>
289 </indexterm>
290 </listitem>
291 </varlistentry>
292
293 </variablelist>
294
295 </sect2>
296
297</sect1>
Note: See TracBrowser for help on using the repository browser.