ftp://ftp.krokus.ru/pub/OpenBSD/distfiles/xscreensaver-4.06.tar.gz
[xscreensaver] / driver / xscreensaver.man
index 93d9adf3f4679c42882ca4526940d5fd7261ec40..dffe163e10774620b4af1c761d33957c60dea14f 100644 (file)
@@ -11,7 +11,7 @@
 .if n .sp 1
 .if t .sp .5
 ..
-.TH XScreenSaver 1 "24-Feb-2002 (4.01)" "X Version 11"
+.TH XScreenSaver 1 "23-Oct-2002 (4.06)" "X Version 11"
 .SH NAME
 xscreensaver - extensible screen saver framework, plus locking
 .SH SYNOPSIS
@@ -303,6 +303,15 @@ runs; this resource will cause the output of all relevant programs to be
 drawn on the screensaver window itself, as well as being written to the
 controlling terminal of the screensaver driver process.  Default true.
 .TP 8
+.B ignoreUninstalledPrograms\fP (class \fBBoolean\fP)
+There may be programs in the list that are not installed on the system,
+yet are marked as "enabled."  If this preference is true, then such 
+programs will simply be ignored.  If false, then a warning will be printed
+if an attempt is made to run the nonexistent program.  Also, the
+.BR xscreensaver-demo (1)
+program will suppress the non-existent programs from the list if this
+is true.  Default: false.
+.TP 8
 .B font\fP (class \fBFont\fP)
 The font used for the stdout/stderr text, if \fBcaptureStderr\fP is true.
 Default \fB*\-medium\-r\-*\-140\-*\-m\-*\fP (a 14 point fixed-width font.)
@@ -845,17 +854,31 @@ lock command.
 I understand that KDE has invented their own wrapper around xscreensaver,
 that is inferior to 
 .BR xscreensaver-demo (1)
-in any number of ways.  I've never actually seen it.  Presumably, there is
-some way to turn off KDE's screensaver framework, and make it so that the
-usual
+in any number of ways.  I've never actually seen it, but I'm told that
+this is the way you disable it:
+.RS 4
+.TP 3
+\fB1: Switch off KDE's screen saver.\fP
+Open the ``\fIControl Center\fP'' and
+select the ``\fILook and Feel / Screensaver\fP'' page.
+Turn off the ``\fIEnable Screensaver\fP'' checkbox.
+.TP 3
+\fB2: Find your Autostart directory.\fP
+Open the ``\fILook and Feel / Desktop / Paths\fP'' page,
+and see what your ``Autostart'' directory is set to: it will
+probably be \fI~/.kde3/Autostart/\fP or something similar.
+.TP 3
+\fB3: Add xscreensaver to your startup programs.\fP
+Create a file in your autostart directory
+called \fIlaunch-xscreensaver\fP.  Make that file be executable,
+and contain a single line: \fI``xscreensaver\fP''.
+.RE
+.PP
+Now use xscreensaver normally, controlling it via the usual
 .BR xscreensaver-demo (1)
 and
 .BR xscreensaver-command (1)
-mechanisms are used, in a similar way to how one can reconfigure CDE and
-VUE environments, above.
-
-But I don't know how.  If you do, please let me know, and I'll document
-it here.
+mechanisms.
 .SH ADDING TO MENUS
 The
 .BR xscreensaver-command (1)
@@ -1252,10 +1275,6 @@ in the X protocol.
 
 In all these years, I've not heard of even a single case of this happening,
 but it is theoretically possible, so I'm mentioning it for completeness...
-.TP 8
-.B Red Hot Lava
-There need to be a lot more graphics hacks.  In particular, there should be
-a simulation of a Lavalite (tm).
 .SH ENVIRONMENT
 .PP
 .TP 8