source: gnome/add/gnome-screensaver.xml@ 6129b81

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 6129b81 was 6129b81, checked in by Wayne Blaszczyk <wblaszcz@…>, 13 years ago

Added new package. xmlto-0.0.23

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

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