ftp://netsw.org/x11/tools/desktop/xscreensaver-4.07.tar.gz
[xscreensaver] / driver / xscreensaver.man
index ee49dd9fc057ea148d4c4e5ce50aa22ae2fe6e5a..1fd6edbe6540f133f82153f54aa0ee3957bb8603 100644 (file)
@@ -11,7 +11,7 @@
 .if n .sp 1
 .if t .sp .5
 ..
-.TH XScreenSaver 1 "18-Mar-2002 (4.02)" "X Version 11"
+.TH XScreenSaver 1 "03-Feb-2003 (4.07)" "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.)
@@ -854,10 +863,21 @@ Open the ``\fIControl Center\fP'' and
 select the ``\fILook and Feel / Screensaver\fP'' page.
 Turn off the ``\fIEnable Screensaver\fP'' checkbox.
 .TP 3
-\fB2: Add xscreensaver to your startup programs.\fP
-Create a file in your \fI~/.kde2/Autostart/\fP directory
-called \fIlaunch-xscreensaver\fP.  Make that file be executable,
-and contain a single line: \fI``xscreensaver\fP''.
+\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: Make xscreensaver be an Autostart program.\fP
+Create a file in your autostart directory 
+called \fIxscreensaver.desktop\fP that contains the following five lines:
+.EX
+[Desktop Entry]
+Exec=xscreensaver
+Name=XScreensaver
+Type=Application
+X-KDE-StartupNotify=false
+.EE
 .RE
 .PP
 Now use xscreensaver normally, controlling it via the usual
@@ -1162,12 +1182,11 @@ screen locked.  Depending on your setup, you might consider this a problem.
 Unfortunately, there is no way for xscreensaver itself to override the
 interpretation of these keys.  If you want to disable Ctrl+Alt+Backspace
 globally, you need to set the \fIDontZap\fP flag in 
-your \fI/etc/X11/XF86Config\fP file.  See the
+your \fI/etc/X11/XF86Config\fP file.  To globally disable VT switching,
+you can set the \fIDontVTSwitch\fP flag.  See the
 .BR XF86Config (5)
 manual for details.
 
-There is no way (as far as I can tell) to disable the VT-switching keystrokes.
-
 Some Linux systems come with a VT_LOCKSWITCH ioctl, that one could 
 theoretically use to prevent VT-switching while the screen is locked; 
 but unfortunately, this ioctl can only be used by root, which means
@@ -1261,10 +1280,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