Ignore:
Timestamp:
05/02/2005 07:11:46 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 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, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
2939bea
Parents:
c18d3b25
Message:

Tagged xscreensaver.xml

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • general/genutils/xscreensaver.xml

    rc18d3b25 r6247293  
    1414
    1515<sect1 id="xscreensaver" xreflabel="XScreenSaver-&xscreensaver-version;">
    16 <sect1info>
    17   <othername>$LastChangedBy$</othername>
    18   <date>$Date$</date>
    19 </sect1info>
    20 
    21 <?dbhtml filename="xscreensaver.html"?>
    22 <title>XScreenSaver-&xscreensaver-version;</title>
    23 
    24 <indexterm zone="xscreensaver">
    25   <primary sortas="a-xscreensaver">Xscreensaver</primary>
    26 </indexterm>
    27 
    28 <sect2>
    29 <title>Introduction to <application>XScreenSaver</application></title>
    30 
    31 <para>The <application>XScreenSaver</application> is a modular screen
    32 saver and locker for the X Window System. It is highly customizable and
    33 allows the use of any program that can draw on the root window as a
    34 display mode. The purpose of <application>XScreenSaver</application> is
    35 to display pretty pictures on your screen when it is not in use, in
    36 keeping with the philosophy that unattended monitors should always be
    37 doing something interesting, just like they do in the movies. However,
    38 <application>XScreenSaver</application> can also be used as a screen
    39 locker, to prevent others from using your terminal while you are
    40 away.</para>
    41 
    42 
    43 <sect3>
    44 <title>Package information</title>
    45 <itemizedlist spacing="compact">
    46   <listitem><para>Download (HTTP): <ulink url="&xscreensaver-download-http;"/></para></listitem>
    47   <listitem><para>Download (FTP): <ulink url="&xscreensaver-download-ftp;"/></para></listitem>
    48   <listitem><para>Download MD5 sum: &xscreensaver-md5sum;</para></listitem>
    49   <listitem><para>Download size: &xscreensaver-size;</para></listitem>
    50   <listitem><para>Estimated disk space required: &xscreensaver-buildsize;</para></listitem>
    51   <listitem><para>Estimated build time: &xscreensaver-time;</para></listitem>
    52 </itemizedlist>
    53 </sect3>
    54 
    55 <sect3>
    56 <title><application>XScreenSaver</application> dependencies</title>
    57 
    58 <sect4>
    59 <title>Required</title>
    60 
    61 <para> <xref linkend="bc"/> and
    62        <xref linkend="libglade"/> (alternatively
    63        <xref linkend="lesstif"/> but not recommended)
    64 </para>
    65 </sect4>
    66 
    67 <sect4>
    68 <title>Optional</title>
    69 <para> <xref linkend="libjpeg"/>,
    70        <ulink url="http://linas.org/gle/">GLE</ulink>,
    71        <ulink url="http://netpbm.sourceforge.net/">Netpbm</ulink>,
    72        <ulink url="http://www.ibiblio.org/pub/Linux/games/amusements/fortune/fortune-mod-9708.tar.gz">fortune-mod</ulink>,
    73        <ulink url="http://www.jwz.org/xdaliclock/">XDaliClock</ulink>,
    74        <xref linkend="yelp"/>,
    75        <xref linkend="Linux_PAM"/> and
    76        <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink> or
    77        <xref linkend="heimdal"/> or
    78        <xref linkend="mitkrb"/>
    79 </para>
    80 </sect4>
    81 </sect3>
    82 </sect2>
    83 
    84 <sect2>
    85 <title>Installation of <application>XScreenSaver</application></title>
    86 
    87 <para><application>XScreenSaver</application> makes some poor choices
    88 where to put all the files if GNOME is installed. To get around this,
    89 run the following command and see an optional configure switch
    90 described later below.</para>
    91 
    92 <screen><userinput><command>sed -i -e "s,@GNOME_DATADIR@,$GNOME_PREFIX/share," driver/Makefile.in</command></userinput></screen>
    93 
    94 <para>Install <application>XScreenSaver</application> by running the following
    95 commands:</para>
    96 
    97 <screen><userinput><command>./configure --prefix=/usr &amp;&amp;
    98 make</command></userinput></screen>
    99 
    100 <para>Now, as the root user:</para>
    101 
    102 <screen><userinput role='root'><command>make install</command></userinput></screen>
    103 
    104 </sect2>
    105 
    106 <sect2>
    107 <title>Command explanations</title>
    108 
    109 <para><option>--with-setuid-hacks</option>:
    110 This switch allows some demos to be installed setuid root which is
    111 needed in order to ping other hosts.   
    112 </para>
    113 
    114 <para><option>--with-configdir=/usr/lib/xscreensaver/config</option>:
    115 If GNOME is installed, you can use this switch to put the
    116 configuration files in a single directory rather than spreading them
    117 all over the disk.</para>
    118    
    119 </sect2>
    120 
    121 <sect2>
    122 <title>Configuring <application>XScreenSaver</application></title>
    123 
    124 <sect3 id="xscreensaver-config">
    125 <title>Config files</title>
    126 
    127 <para><filename>~/.xscreensaver</filename></para>
    128 
    129 <indexterm zone="xscreensaver xscreensaver-config">
    130   <primary sortas="e-AA.xscreensaver">~/.xscreensaver</primary>
    131 </indexterm>
    132 
    133 </sect3>
    134 </sect2>
    135 
    136 <sect2>
    137 <title>Contents</title>
    138 
    139 <segmentedlist>
    140   <segtitle>Installed Programs</segtitle>
    141   <segtitle>Installed Libraries</segtitle>
    142   <segtitle>Installed Directories</segtitle>
    143 
    144   <seglistitem>
    145     <seg>xscreensaver, xscreensaver-command, xscreensaver-demo, xscreensaver-getimage,
    146          xscreensaver-getimage-file, xscreensaver-getimage-video, xscreensaver-gl-helper,
    147          and screensaver-properties-capplet</seg>
    148     <seg>None</seg>
    149     <seg>/usr/libexec/xscreensaver, /usr/share/xscreensaver, and /usr/share/pixmaps</seg>
    150   </seglistitem>
    151 </segmentedlist>
    152 
    153 <variablelist>
    154   <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    155   <?dbfo list-presentation="list"?>
    156 
    157 <varlistentry id="xscreensaver-prog">
    158   <term><command>xscreensaver</command></term>
    159   <listitem>
    160     <para>is a screen saver and locker daemon.</para>
    161     <indexterm zone="xscreensaver xscreensaver-prog">
    162       <primary sortas="b-xscreensaver">xscreensaver</primary>
    163     </indexterm>
    164   </listitem>
    165 </varlistentry>
    166 
    167 <varlistentry id="xscreensaver-command">
    168   <term><command>xscreensaver-command</command></term>
    169   <listitem>
    170     <para>controls a running <command>xscreensaver</command>
     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 away.</para>
     41   
     42    <bridgehead renderas="sect3">Package Information</bridgehead>
     43    <itemizedlist spacing="compact">
     44      <listitem>
     45        <para>Download (HTTP): <ulink url="&xscreensaver-download-http;"/></para>
     46      </listitem>
     47      <listitem>
     48        <para>Download (FTP): <ulink url="&xscreensaver-download-ftp;"/></para>
     49      </listitem>
     50      <listitem>
     51        <para>Download MD5 sum: &xscreensaver-md5sum;</para>
     52      </listitem>
     53      <listitem>
     54        <para>Download size: &xscreensaver-size;</para>
     55      </listitem>
     56      <listitem>
     57        <para>Estimated disk space required: &xscreensaver-buildsize;</para>
     58      </listitem>
     59      <listitem>
     60        <para>Estimated build time: &xscreensaver-time;</para>
     61      </listitem>
     62    </itemizedlist>
     63   
     64    <bridgehead renderas="sect3">XScreenSaver Dependencies</bridgehead>
     65   
     66    <bridgehead renderas="sect4">Required</bridgehead>
     67    <para><xref linkend="bc"/> and
     68    <xref linkend="libglade"/> (alternatively
     69    <xref linkend="lesstif"/> but not recommended)</para>
     70   
     71    <bridgehead renderas="sect4">Optional</bridgehead>
     72    <para> <xref linkend="libjpeg"/>,
     73    <ulink url="http://linas.org/gle/">GLE</ulink>,
     74    <ulink url="http://netpbm.sourceforge.net/">Netpbm</ulink>,
     75    <ulink
     76    url="http://www.ibiblio.org/pub/Linux/games/amusements/fortune/fortune-mod-9708.tar.gz">fortune-mod</ulink>,
     77    <ulink url="http://www.jwz.org/xdaliclock/">XDaliClock</ulink>,
     78    <xref linkend="yelp"/>,
     79    <xref linkend="Linux_PAM"/> and
     80    <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink> or
     81    <xref linkend="heimdal"/> or
     82    <xref linkend="mitkrb"/></para>
     83   
     84  </sect2>
     85 
     86  <sect2 role="installation">
     87    <title>Installation of XScreenSaver</title>
     88
     89    <para><application>XScreenSaver</application> makes some poor choices
     90    where to put all the files if <application>GNOME</application> is installed.
     91    To get around this, run the following command and see an optional configure
     92    switch described later below.</para>
     93
     94<screen><userinput>sed -i -e "s,@GNOME_DATADIR@,$GNOME_PREFIX/share," driver/Makefile.in</userinput></screen>
     95
     96    <para>Install <application>XScreenSaver</application> by running the following
     97    commands:</para>
     98
     99<screen><userinput>./configure --prefix=/usr &amp;&amp;
     100make</userinput></screen>
     101   
     102    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     103   
     104<screen role="root"><userinput>make install</userinput></screen>
     105   
     106  </sect2>
     107 
     108  <sect2 role="commands">
     109    <title>Command Explanations</title>
     110
     111    <para><option>--with-setuid-hacks</option>: This switch allows some
     112    demos to be installed setuid <systemitem class="username">root</systemitem>
     113    which is needed in order to ping other hosts.</para>
     114   
     115    <para><option>--with-configdir=/usr/lib/xscreensaver/config</option>:
     116    If <application>GNOME</application> is installed, you can use this
     117    switch to put the configuration files in a single directory rather than
     118    spreading them all over the disk.</para>
     119   
     120  </sect2>
     121 
     122  <sect2 role="configuration">
     123    <title>Configuring XScreenSaver</title>
     124
     125    <sect3 id="xscreensaver-config">
     126      <title>Config Files</title>
     127     
     128      <para><filename>~/.xscreensaver</filename></para>
     129     
     130      <indexterm zone="xscreensaver xscreensaver-config">
     131        <primary sortas="e-AA.xscreensaver">~/.xscreensaver</primary>
     132      </indexterm>
     133   
     134    </sect3>
     135   
     136  </sect2>
     137 
     138  <sect2 role="content">
     139    <title>Contents</title>
     140
     141    <segmentedlist>
     142      <segtitle>Installed Programs</segtitle>
     143      <segtitle>Installed Libraries</segtitle>
     144      <segtitle>Installed Directories</segtitle>
     145   
     146      <seglistitem>
     147        <seg>xscreensaver, xscreensaver-command, xscreensaver-demo, xscreensaver-getimage,
     148        xscreensaver-getimage-file, xscreensaver-getimage-video, xscreensaver-gl-helper,
     149        and screensaver-properties-capplet</seg>
     150        <seg>None</seg>
     151        <seg>/usr/libexec/xscreensaver, /usr/share/xscreensaver, and /usr/share/pixmaps</seg>
     152      </seglistitem>
     153    </segmentedlist>
     154   
     155    <variablelist>
     156      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     157      <?dbfo list-presentation="list"?>
     158      <?dbhtml list-presentation="table"?>
     159   
     160      <varlistentry id="xscreensaver-prog">
     161        <term><command>xscreensaver</command></term>
     162        <listitem>
     163          <para>is a screen saver and locker daemon.</para>
     164          <indexterm zone="xscreensaver xscreensaver-prog">
     165            <primary sortas="b-xscreensaver">xscreensaver</primary>
     166          </indexterm>
     167        </listitem>
     168      </varlistentry>
     169     
     170      <varlistentry id="xscreensaver-command">
     171        <term><command>xscreensaver-command</command></term>
     172        <listitem>
     173          <para>controls a running <command>xscreensaver</command>
    171174          process by sending it client messages.</para>
    172     <indexterm zone="xscreensaver xscreensaver-command">
    173       <primary sortas="b-xscreensaver-command">xscreensaver-command</primary>
    174     </indexterm>
    175   </listitem>
    176 </varlistentry>
    177 
    178 <varlistentry id="xscreensaver-demo">
    179   <term><command>xscreensaver-demo</command></term>
    180   <listitem>
    181     <para>is a graphical front-end for setting the parameters used
    182     by the background <command>xscreensaver</command> daemon.</para>
    183     <indexterm zone="xscreensaver xscreensaver-demo">
    184       <primary sortas="b-xscreensaver-demo">xscreensaver-demo</primary>
    185     </indexterm>
    186   </listitem>
    187 </varlistentry>
    188 
    189 <varlistentry id="xscreensaver-getimage">
    190   <term><command>xscreensaver-getimage</command></term>
    191   <listitem>
    192     <para>is a helper program for the <command>xscreensaver</command>
     175          <indexterm zone="xscreensaver xscreensaver-command">
     176            <primary sortas="b-xscreensaver-command">xscreensaver-command</primary>
     177          </indexterm>
     178        </listitem>
     179      </varlistentry>
     180     
     181      <varlistentry id="xscreensaver-demo">
     182        <term><command>xscreensaver-demo</command></term>
     183        <listitem>
     184          <para>is a graphical front-end for setting the parameters used
     185          by the background <command>xscreensaver</command> daemon.</para>
     186          <indexterm zone="xscreensaver xscreensaver-demo">
     187            <primary sortas="b-xscreensaver-demo">xscreensaver-demo</primary>
     188          </indexterm>
     189        </listitem>
     190      </varlistentry>
     191     
     192      <varlistentry id="xscreensaver-getimage">
     193        <term><command>xscreensaver-getimage</command></term>
     194        <listitem>
     195          <para>is a helper program for the <command>xscreensaver</command>
    193196          modules that manipulate images.</para>
    194     <indexterm zone="xscreensaver xscreensaver-getimage">
    195       <primary sortas="b-xscreensaver-getimaage">xscreensaver-getimage</primary>
    196     </indexterm>
    197   </listitem>
    198 </varlistentry>
    199 
    200 <varlistentry id="xscreensaver-getimage-file">
    201   <term><command>xscreensaver-getimage-file</command></term>
    202   <listitem>
    203     <para>is a helper program for the <command>xscreensaver</command>
     197          <indexterm zone="xscreensaver xscreensaver-getimage">
     198            <primary sortas="b-xscreensaver-getimaage">xscreensaver-getimage</primary>
     199          </indexterm>
     200        </listitem>
     201      </varlistentry>
     202     
     203      <varlistentry id="xscreensaver-getimage-file">
     204        <term><command>xscreensaver-getimage-file</command></term>
     205        <listitem>
     206          <para>is a helper program for the <command>xscreensaver</command>
    204207          modules that manipulate images.</para>
    205     <indexterm zone="xscreensaver xscreensaver-getimage-file">
    206       <primary sortas="b-xscreensaver-getimaage-file">xscreensaver-getimage-file</primary>
    207     </indexterm>
    208   </listitem>
    209 </varlistentry>
    210 
    211 <varlistentry id="xscreensaver-getimage-video">
    212   <term><command>xscreensaver-getimage-video</command></term>
    213   <listitem>
    214     <para>is a helper program for the <command>xscreensaver</command>
     208          <indexterm zone="xscreensaver xscreensaver-getimage-file">
     209            <primary sortas="b-xscreensaver-getimaage-file">xscreensaver-getimage-file</primary>
     210          </indexterm>
     211        </listitem>
     212      </varlistentry>
     213     
     214      <varlistentry id="xscreensaver-getimage-video">
     215        <term><command>xscreensaver-getimage-video</command></term>
     216        <listitem>
     217          <para>is a helper program for the <command>xscreensaver</command>
    215218          modules that manipulate images.</para>
    216     <indexterm zone="xscreensaver xscreensaver-getimage-video">
    217       <primary sortas="b-xscreensaver-getimaage-video">xscreensaver-getimage-video</primary>
    218     </indexterm>
    219   </listitem>
    220 </varlistentry>
    221 
    222 <varlistentry id="xscreensaver-gl-helper">
    223   <term><command>xscreensaver-gl-helper</command></term>
    224   <listitem>
    225     <para>is a helper program for the <command>xscreensaver</command>
    226        OpenGL modules.</para>
    227     <indexterm zone="xscreensaver xscreensaver-gl-helper">
    228       <primary sortas="b-xscreensaver-gl-helper">xscreensaver-gl-helper</primary>
    229     </indexterm>
    230   </listitem>
    231 </varlistentry>
    232 
    233 </variablelist>
    234 
    235 </sect2>
     219          <indexterm zone="xscreensaver xscreensaver-getimage-video">
     220            <primary sortas="b-xscreensaver-getimaage-video">xscreensaver-getimage-video</primary>
     221          </indexterm>
     222        </listitem>
     223      </varlistentry>
     224     
     225      <varlistentry id="xscreensaver-gl-helper">
     226        <term><command>xscreensaver-gl-helper</command></term>
     227        <listitem>
     228          <para>is a helper program for the <command>xscreensaver</command>
     229          OpenGL modules.</para>
     230          <indexterm zone="xscreensaver xscreensaver-gl-helper">
     231            <primary sortas="b-xscreensaver-gl-helper">xscreensaver-gl-helper</primary>
     232          </indexterm>
     233        </listitem>
     234      </varlistentry>
     235   
     236    </variablelist>
     237
     238  </sect2>
     239
    236240</sect1>
Note: See TracChangeset for help on using the changeset viewer.