X-Git-Url: https://git.sur5r.net/?p=i3%2Fi3lock;a=blobdiff_plain;f=i3lock.1;h=aff08f307016302d68fe6665b31ab1dc9e9c38b2;hp=14ff580a3238cec61ce8f8b3cf2e3807d7c20e96;hb=929e541fb78aa167fc52eb684d4fdff8b305b246;hpb=c5bb1d55e00df320033469eceb81ec03d8a52d80

diff --git a/i3lock.1 b/i3lock.1
index 14ff580..aff08f3 100644
--- a/i3lock.1
+++ b/i3lock.1
@@ -18,7 +18,6 @@ i3lock \- improved screen locker
 .RB [\|\-v\|]
 .RB [\|\-n\|]
 .RB [\|\-b\|]
-.RB [\|\-d\|]
 .RB [\|\-i
 .IR image.png \|]
 .RB [\|\-c
@@ -65,12 +64,6 @@ Don't fork after starting.
 Enable beeping. Be sure to not do this when you are about to annoy other people,
 like when opening your laptop in a boring lecture.
 
-.TP
-.B \-d, \-\-dpms
-Enable turning off your screen using DPMS. Note that, when you do not specify this
-option, DPMS will turn off your screen after 15 minutes of inactivity anyways (if
-you did not disable this in your X server).
-
 .TP
 .BI \-I\  seconds \fR,\ \fB\-\-inactivity-timeout= seconds
 Specifies the number of seconds i3lock will wait for another password before
@@ -126,6 +119,27 @@ Show the number of failed attempts, if any.
 Enables debug logging.
 Note, that this will log the password used for authentication to stdout.
 
+.SH DPMS
+
+The \-d (\-\-dpms) option was removed from i3lock in version 2.8. There were
+plenty of use-cases that were not properly addressed, and plenty of bugs
+surrounding that feature. While features are not normally removed from i3 and
+its tools, we felt the need to make an exception in this case.
+
+Users who wish to explicitly enable DPMS only when their screen is locked can
+use a wrapper script around i3lock like the following:
+
+.Vb 6
+\&	#!/bin/sh
+\&	revert() {
+\&	  xset dpms 0 0 0
+\&	}
+\&	trap revert SIGHUP SIGINT SIGTERM
+\&	xset +dpms dpms 5 5 5
+\&	i3lock -n
+\&	revert
+.Ve
+
 .SH SEE ALSO
 .IR xautolock(1)
 \- use i3lock as your screen saver