X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=driver%2Fxscreensaver.man;h=1928429aa58655336f1c4f513b02501733b1b153;hb=4361b69d3178d7fc98d0388f9a223af6c2651aba;hp=251a64c147dfdf598756bb5cfa27373efa518ae4;hpb=6afd6db0ae9396cd7ff897ade597cd5483f49b0e;p=xscreensaver

diff --git a/driver/xscreensaver.man b/driver/xscreensaver.man
index 251a64c1..1928429a 100644
--- a/driver/xscreensaver.man
+++ b/driver/xscreensaver.man
@@ -180,7 +180,7 @@ If DPMS seems not to be working with XFree86, make sure the "DPMS"
 option is set in your \fI/etc/X11/XF86Config\fP file.  See the
 .BR XF86Config (5)
 manual for details.
-.SH USING GNOME
+.SH USING GNOME OR UNITY
 For the better part of a decade, GNOME shipped xscreensaver as-is,
 and everything just worked out of the box.  In 2005, however, they
 decided to re-invent the wheel and ship their own replacement for
@@ -197,16 +197,36 @@ To replace gnome-screensaver with xscreensaver:
 .EX
 sudo apt-get remove gnome-screensaver
 .EE
+or possibly
+.EX
+sudo dpkg -P gnome-screensaver
+.EE
 .TP 3
 \fB2: Launch xscreensaver at login.\fP
 Select "\fIStartup Applications\fP" from the menu (or manually
 launch "\fIgnome-session-properties\fP") and add "\fIxscreensaver\fP".
+
+Do this as your normal user account, not as root.
+(This should go without saying, because you should never, ever, ever
+be logged in to the graphical desktop as user "root".)
 .TP 3
-\fB3: Make "Lock Screen" use xscreensaver.\fP
+\fB3: Make GNOME's "Lock Screen" use xscreensaver.\fP
 .EX
 sudo ln -sf /usr/bin/xscreensaver-command \\
             /usr/bin/gnome-screensaver-command
 .EE
+That doesn't work under Unity, though.  Apparently it has its own
+built-in screen locker which is not gnome-screensaver, and cannot be
+removed, and yet still manages to be bug-addled and insecure. 
+Keep reinventing that wheel, guys!  (If you have figured out how to
+replace Unity's locking "feature" with xscreensaver, let me know.)
+.TP 3
+\fB4: Turn off Unity's built-in blanking.\fP
+Open "\fISystem Settings / Brightness & Lock\fP";
+.br
+Un-check "\fIStart Automatically\fP";
+.br
+Set \fI"Turn screen off when inactive for"\fP to \fI"Never."\fP
 .SH USING KDE
 Like GNOME, KDE also decided to invent their own screen saver framework
 from scratch instead of simply using xscreensaver.  To replace the KDE
@@ -258,12 +278,39 @@ Now use xscreensaver normally, controlling it via the usual
 and
 .BR xscreensaver-command (1)
 mechanisms.
-.SH USING UNITY
-Guess what, they did it again!  Ubuntu Unity's screen-locking
-framework is \fIyet another\fP rewrite, and it is completely broken,
-bug-ridden and insecure. At this time I don't have any information on
-how to turn it off and use xscreensaver instead.  If you do, let me
-know.
+.SH USING SYSTEMD
+If the above didn't do it, and your system has
+.BR systemd (1),
+then give this a try:
+
+.TP 3
+\fB1: Create a service.\fP
+Create the file \fI~/.config/systemd/user/xscreensaver.service\fP
+containing:
+.EX
+[Unit]
+Description=XScreenSaver
+[Service]
+ExecStart=/usr/bin/xscreensaver
+[Install]
+WantedBy=default.target
+.EE
+\fB2. Enable it.\fP
+.EX
+systemctl --user enable xscreensaver
+.EE
+Then restart X11.
+.SH USING UPSTART
+Still not working, but on your distro, that newfangled
+.BR systemd (1)
+nonsense has already fallen out of favor?  Then maybe this will work:
+launch the \fIStartup Applications\fP applet, click \fI"Add"\fP, and
+enter these lines, then restart X11:
+.EX
+Name: XScreenSaver
+Command: xscreensaver
+Comment: xscreensaver
+.EE
 .SH USING GDM
 You can run \fIxscreensaver\fP from your 
 .BR gdm (1)
@@ -310,7 +357,7 @@ and
 .BR xhost (1).
 .SH BUGS
 Bugs?  There are no bugs.  Ok, well, maybe.  If you find one, please let
-me know.  http://www.jwz.org/xscreensaver/bugs.html explains how to
+me know.  https://www.jwz.org/xscreensaver/bugs.html explains how to
 construct the most useful bug reports.
 .PP
 .TP 4
@@ -443,6 +490,10 @@ running graphics-hack sub-process will be killed (with \fBSIGTERM\fP), and a
 new one started.  If this is 0, then the graphics hack will never be changed:
 only one demo will run until the screensaver is deactivated by user activity.
 Default 10 minutes.
+
+The running saver will be restarted every \fIcycle\fP minutes even when
+\fImode\fP is \fIone\fP, since some savers tend to converge on a steady
+state.
 .TP 8
 .B lock\fP (class \fBBoolean\fP)
 Enable locking: before the screensaver will turn off, it will require you 
@@ -885,7 +936,7 @@ to get the name of a resource file that overrides the global resources
 stored in the RESOURCE_MANAGER property.
 .SH UPGRADES
 The latest version of xscreensaver, an online version of this manual,
-and a FAQ can always be found at http://www.jwz.org/xscreensaver/
+and a FAQ can always be found at https://www.jwz.org/xscreensaver/
 .SH SEE ALSO
 .BR X (1),
 .BR Xsecurity (1),
@@ -899,7 +950,7 @@ and a FAQ can always be found at http://www.jwz.org/xscreensaver/
 .BR xscreensaver\-getimage (1),
 .BR xscreensaver\-text (1).
 .SH COPYRIGHT
-Copyright \(co 1991-2014 by Jamie Zawinski.
+Copyright \(co 1991-2017 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