source: gnome/add/gnome-screensaver.xml@ b0db915

10.0 10.1 11.0 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 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 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b0db915 was b0db915, checked in by Randy McMurchy <randy@…>, 15 years ago

Updated the md5sums and build data for the GNOME add-on utilities to be compatible with GNOME-2.14.3

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

  • Property mode set to 100644
File size: 11.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/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 "2ed0b9322d284bb1739e037165ca94f2">
10 <!ENTITY gnome-screensaver-size "1.9 MB">
11 <!ENTITY gnome-screensaver-buildsize "18.5 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="dbus"/>,
64 <xref linkend="libgnomeui"/>, and
65 <xref linkend="gnome-menus"/></para>
66
67 <bridgehead renderas="sect4">Optional</bridgehead>
68 <para role="optional"><xref linkend="intltool"/>,
69 <xref linkend="libexif"/>,
70 <xref linkend="linux-pam"/>,
71 <xref linkend="xscreensaver"/>
72 (and <xref linkend="libxslt"/>), and
73 <xref linkend="gdm"/></para>
74
75 <para condition="html" role="usernotes">User Notes:
76 <ulink url="&blfs-wiki;/gnome-screensaver"/></para>
77
78 </sect2>
79
80 <sect2 role="installation">
81 <title>Installation of gnome-screensaver</title>
82
83 <note>
84 <para><emphasis>Optional Features</emphasis></para>
85
86 <para><emphasis role='strong'>1.</emphasis> If you have
87 <application>XScreenSaver</application> installed and wish to import any
88 or all of the <quote>hacks</quote> into
89 <application>gnome-screensaver</application> themes, set the following
90 environment variable (modify it if <application>XScreenSaver</application>
91 is installed in a non-standard location):</para>
92
93<screen><userinput>XSAVERDIR=/usr/share/xscreensaver/config</userinput></screen>
94
95 <para>Also add the following parameter to the <command>configure</command>
96 script below:</para>
97
98<screen><userinput> --with-xscreensaverdir=$XSAVERDIR</userinput></screen>
99
100 <para><emphasis role='strong'>2.</emphasis> If you have
101 <application>GDM</application> installed and wish to provide user-switching
102 from the <application>gnome-screensaver</application> unlock-screen dialog
103 box, add the following parameter to the <command>configure</command> script
104 below:</para>
105
106<screen><userinput> --with-gdm-config=&gnome-etc-dir;/gdm/custom.conf</userinput></screen>
107 </note>
108
109 <para>Install <application>gnome-screensaver</application> by running the
110 following commands:</para>
111
112<screen><userinput>sed -i 's|etc/pam\.d"|etc"|' data/Makefile.in &amp;&amp;
113./configure --prefix=$(pkg-config --variable=prefix ORBit-2.0) \
114 --sysconfdir=&gnome-etc-dir; \
115 --libexecdir=$(pkg-config \
116 --variable=prefix ORBit-2.0)/lib/gnome-screensaver \
117 --with-pam-prefix=/etc &amp;&amp;
118make</userinput></screen>
119
120 <para>If you have <application>XScreenSaver</application> installed and
121 wish to import any or all of the <quote>hacks</quote> into
122 <application>gnome-screensaver</application> themes, you'll need to
123 identify which <quote>hacks</quote> you wish to import. The commands
124 below will import all of them. If you want to import less than all of
125 them, modify the setting of the <envar>XSAVERLIST</envar> environment
126 variable below (listing the desired hacks by filename without the
127 extension, space delimited) and issue the following commands:</para>
128
129<screen><userinput>mkdir xscreensavers &amp;&amp;
130cd xscreensavers &amp;&amp;
131
132XSAVERLIST="*" &amp;&amp;
133
134for SAVERLIST in $(ls ${XSAVERDIR}/${XSAVERLIST}.xml); do
135 ../data/migrate-xscreensaver-config.sh $SAVERLIST
136done &amp;&amp;
137
138unset XSAVERDIR
139unset XSAVERLIST
140unset SAVERLIST
141
142cd ..</userinput></screen>
143
144 <para>This package does not come with a test suite.</para>
145
146 <para>Now, as the <systemitem class='username'>root</systemitem> user:</para>
147
148<screen role='root'><userinput>make install &amp;&amp;
149install -v -m644 -D doc/DBUS-API.txt \
150 $(pkg-config --variable=prefix \
151 ORBit-2.0)/share/doc/gnome-screensaver-&gnome-screensaver-version;/DBUS-API.txt</userinput></screen>
152
153 <para>If you identified some, or all,
154 <application>XScreenSaver</application> hacks to be imported into
155 <application>gnome-screensaver</application>, install them by issuing the
156 following commands as the <systemitem class='username'>root</systemitem>
157 user:</para>
158
159<screen role='root'><userinput>install -v -m755 -d $(pkg-config --variable=prefix \
160 ORBit-2.0)/share/gnome-screensaver/themes/xscreensaver &amp;&amp;
161install -v -m644 xscreensavers/*.desktop \
162 $(pkg-config --variable=prefix \
163 ORBit-2.0)/share/gnome-screensaver/themes/xscreensaver</userinput></screen>
164
165 </sect2>
166
167 <sect2 role="commands">
168 <title>Command Explanations</title>
169
170 <para><command>sed -i 's|etc/pam\.d"|etc|' data/Makefile.in</command>:
171 This command is used so that an erroneous message to copy the PAM
172 configuration file is not displayed.</para>
173
174 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
175 href="../../xincludes/gnome-prefix.xml"/>
176
177 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
178 href="../../xincludes/gnome-sysconfdir.xml"/>
179
180 <para><parameter>--libexecdir=$(pkg-config --variable=prefix
181 ORBit-2.0)/lib/gnome-screensaver</parameter>: This parameter causes the
182 libexec files to be installed in the preferred location of
183 <filename class="directory">$GNOME_PREFIX/lib/gnome-screensaver</filename>
184 instead of
185 <filename class="directory">$GNOME_PREFIX/libexec</filename>.</para>
186
187 <para><parameter>--with-pam-prefix=/etc</parameter>: This parameter is
188 used so that the <application>Linux-PAM</application> configuration file
189 for the <application>gnome-screensaver</application> application is
190 installed in the correct location. You may omit this parameter if you
191 don't have <application>Linux-PAM</application> installed, though it
192 won't affect the build if you don't.</para>
193
194 </sect2>
195
196 <sect2 role="configuration">
197 <title>Configuring gnome-screensaver</title>
198
199 <sect3 id="gnome-screensaver-config">
200 <title>Config Files</title>
201
202 <para><filename>/etc/pam.d/gnome-screensaver</filename>,
203 <filename>&gnome-etc-dir;/gdm/custom.conf</filename></para>
204
205 <indexterm zone="gnome-screensaver gnome-screensaver-config">
206 <primary sortas="e-etc-pam.d-gnome-screensaver">\
207 /etc/pam.d/gnome-screensaver</primary>
208 </indexterm>
209 <indexterm zone="gnome-screensaver gnome-screensaver-config">
210 <primary sortas="etc-gnome-&gnome-version;&gnome-minor-version;gdm-custom.conf">
211 &gnome-etc-dir;/gdm/custom.conf</primary>
212 </indexterm>
213
214 </sect3>
215
216 <sect3>
217 <title>Configuration Information</title>
218
219 <sect4>
220 <title>General Configuration</title>
221
222 <para>Most of the <application>gnome-screensaver</application>
223 configuration parameters can be modified using the
224 <guimenuitem>Screensaver</guimenuitem> menu item from the
225 <guimenu>Desktop</guimenu>&mdash;<guisubmenu>Preferences</guisubmenu>
226 drop-down menu. Some of the fine-tuning parameters are only available
227 using <xref linkend="gconf-editor"/>.</para>
228
229 </sect4>
230
231 <sect4>
232 <title>Linux-PAM Configuration</title>
233
234 <para>If you have <application>Linux-PAM</application> installed, the
235 just-installed <filename>gnome-screensaver</filename> configuration
236 file does not work with a BLFS system. Replace the existing file with
237 one that can be used on a BLFS system by issuing the following command
238 as the <systemitem class='username'>root</systemitem> user:</para>
239
240<screen role="root"><userinput>cat &gt; /etc/pam.d/gnome-screensaver &lt;&lt; "EOF"
241<literal># File: /etc/pam.d/gnome-screensaver
242
243auth required pam_unix.so
244account required pam_unix.so
245session required pam_unix.so
246password required pam_unix.so</literal>
247
248EOF
249chmod -v 644 /etc/pam.d/gnome-screensaver</userinput></screen>
250
251 </sect4>
252
253 <sect4>
254 <title>User-Switching Configuration</title>
255
256 <para>If you have <application>GDM</application> installed and you
257 passed the <option>--with-gdm-config=</option> option to the
258 <command>configure</command> script, the screen-unlocking dialog box
259 will contain an option to <quote>Switch Users</quote>. This user
260 switching option uses the same configuration as
261 <application>GDM</application> to determine what users are displayed
262 in this dialog. You can use the <application>GDM</application>
263 configuration option from the GDM login screen, or you can directly
264 edit the <filename>&gnome-etc-dir;/gdm/custom.conf</filename> file to
265 modify the settings. </para>
266
267 </sect4>
268
269 </sect3>
270
271 </sect2>
272
273 <sect2 role="content">
274 <title>Contents</title>
275
276 <segmentedlist>
277 <segtitle>Installed Programs</segtitle>
278 <segtitle>Installed Libraries</segtitle>
279 <segtitle>Installed Directories</segtitle>
280
281 <seglistitem>
282 <seg>gnome-screensaver, gnome-screensaver-command and
283 gnome-screensaver-preferences</seg>
284 <seg>None</seg>
285 <seg><envar>$GNOME_PREFIX</envar>/share/{doc/gnome-screensaver-2.14.2,
286 gnome-screensaver, pixmaps/backgrounds/cosmos}</seg>
287 </seglistitem>
288 </segmentedlist>
289
290 <variablelist>
291 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
292 <?dbfo list-presentation="list"?>
293 <?dbhtml list-presentation="table"?>
294
295 <varlistentry id="gnome-screensaver-prog">
296 <term><command>gnome-screensaver</command></term>
297 <listitem>
298 <para>is a screensaver and screen-locking program designed to
299 work seamlessly with the GNOME desktop.</para>
300 <indexterm zone="gnome-screensaver gnome-screensaver-prog">
301 <primary sortas="b-gnome-screensaver">gnome-screensaver</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 </variablelist>
307
308 </sect2>
309
310</sect1>
Note: See TracBrowser for help on using the repository browser.