X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=driver%2Fxscreensaver.man;h=c08ed63b26b783c2b9e22271973e4200f07e4ba9;hb=3d9140a05b5272fed0883a0af0a71e30ef44d47f;hp=013aff223fc6364fabcaed62610b7e4d12aa0a6c;hpb=72c1f4c1dc6ab07fe121a327ff1c30bf51ef74c1;p=xscreensaver diff --git a/driver/xscreensaver.man b/driver/xscreensaver.man index 013aff22..c08ed63b 100644 --- a/driver/xscreensaver.man +++ b/driver/xscreensaver.man @@ -11,7 +11,7 @@ .if n .sp 1 .if t .sp .5 .. -.TH XScreenSaver 1 "12-Nov-99 (3.20)" "X Version 11" +.TH XScreenSaver 1 "13-Feb-2001 (3.29)" "X Version 11" .SH NAME xscreensaver - graphics hack and screen locker, launched when the user is idle .SH SYNOPSIS @@ -79,7 +79,12 @@ and .BR xscreensaver-command (1) programs. .SH CONFIGURATION -Options to \fIxscreensaver\fP are specified in one of two places: in +The easiest way to configure \fIxscreensaver\fP is to simply run the +.BR xscreensaver-demo (1) +program, and change the settings through the GUI. The rest of this +manual page describes lower level ways of changing settings. + +Options to \fIxscreensaver\fP are stored in one of two places: in a \fI.xscreensaver\fP file in your home directory; or in the X resource database. If the \fI.xscreensaver\fP file exists, it overrides any settings in the resource database. @@ -569,7 +574,7 @@ also how the subprocesses are killed when the screensaver decides that it's time to run a different demo: the old one is killed and a new one is launched. Before launching a subprocess, \fIxscreensaver\fP stores an appropriate value -for \fB$DISPLAY\fP in the environment that the child will recieve. (This is +for \fB$DISPLAY\fP in the environment that the child will receive. (This is so that if you start \fIxscreensaver\fP with a \fI-display\fP argument, the programs which \fIxscreensaver\fP launches will draw on the same display; and so that the child will end up drawing on the appropriate screen of a @@ -590,9 +595,9 @@ program (which see.) .SH POWER MANAGEMENT Modern X servers contain support to power down the monitor after an idle period. If the monitor has powered down, then \fIxscreensaver\fP will -notice this, and will not waste CPU by drawing graphics demos on a black -screen. An attempt will also be made to explicitly power the monitor -back up as soon as user activity is detected. +notice this (after a few minutes), and will not waste CPU by drawing +graphics demos on a black screen. An attempt will also be made to +explicitly power the monitor back up as soon as user activity is detected. If your X server supports power management, then .BR xset (1) @@ -656,6 +661,7 @@ The simplest way to accomplish all of this is as follows: To the file \fI/usr/lib/X11/xdm/Xsetup\fP, add the lines .EX +xhost +localhost xscreensaver-command -exit xscreensaver & .EE @@ -720,6 +726,24 @@ man pages for .BR xauth (1), and .BR xhost (1). +.SH USING GDM(1) +The instructions for using \fIxscreensaver\fP with +.BR gdm (1) +are almost the same as for using +.BR xdm (1), +above. There are only two differences, really: instead +of editing \fI/usr/lib/X11/xdm/Xsetup\fP, edit the +file \fI/etc/X11/gdm/Init/Default\fP; and instead of +editing \fI/usr/lib/X11/xdm/Xsession\fP, edit one or all of the +files in the \fI/etc/X11/gdm/Sessions/\fP directory. (Note that +the default session (\fI/etc/X11/gdm/Sessions/Default\fP) usually +simply executes \fI/usr/lib/X11/xdm/Xsession\fP, so be careful +you aren't initializing xscreensaver twice.) + +All the same caveats apply for +.BR gdm (1) +as for +.BR xdm (1). .SH USING CDE (COMMON DESKTOP ENVIRONMENT) The easiest way to use \fIxscreensaver\fP on a system with CDE is to simply switch off the built-in CDE screensaver, and use \fIxscreensaver\fP instead; @@ -1247,6 +1271,7 @@ http://www.jwz.org/xscreensaver/ .BR X (1), .BR xscreensaver\-demo (1), .BR xscreensaver\-command (1), +.BR xscreensaver\-gl\-helper (1), .BR xdm (1), .BR xset (1), .BR Xsecurity (1), @@ -1350,7 +1375,6 @@ http://www.jwz.org/xscreensaver/ .BR xjack (1), .BR xlyap (1), .BR xmatrix (1), -.BR xroger (1), .BR bongo (1), .BR ico (1), .BR xaos (1), @@ -1365,7 +1389,7 @@ http://www.jwz.org/xscreensaver/ .BR xv (1), .BR xwave (1). .SH COPYRIGHT -Copyright \(co 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999 +Copyright \(co 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001 by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that @@ -1379,6 +1403,8 @@ to comp.sources.x on 13-Aug-1992. Please let me know if you find any bugs or make any improvements. .SH ACKNOWLEDGEMENTS +Thanks to Angela Goodman for the XScreenSaver logo. + Thanks to the many people who have contributed graphics demos to the package. Thanks to David Wojtowicz for implementing \fIlockTimeout\fP.