update CHANGELOG

[i3/i3lock] / i3lock.1

diff --git a/i3lock.1 b/i3lock.1
index 14ff580a3238cec61ce8f8b3cf2e3807d7c20e96..aff08f307016302d68fe6665b31ab1dc9e9c38b2 100644 (file)
--- a/i3lock.1
+++ b/i3lock.1
@@ -18,7 +18,6 @@ i3lock \- improved screen locker
 .RB [\|\-v\|]
 .RB [\|\-n\|]
 .RB [\|\-b\|]
 .RB [\|\-v\|]
 .RB [\|\-n\|]
 .RB [\|\-b\|]

-.RB [\|\-d\|]

 .RB [\|\-i
 .IR image.png \|]
 .RB [\|\-c
 .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.
 
 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
 .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.
 
 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
 .SH SEE ALSO
 .IR xautolock(1)
 \- use i3lock as your screen saver