]> git.sur5r.net Git - i3/i3/commitdiff
docs/userguide: Document that i3 can accept RandR output names 2920/head
authorVladimir Panteleev <git@thecybershadow.net>
Tue, 12 Sep 2017 09:27:49 +0000 (09:27 +0000)
committerVladimir Panteleev <git@thecybershadow.net>
Wed, 13 Sep 2017 08:23:27 +0000 (08:23 +0000)
docs/userguide

index 0d5de3b9056c86eff0e483124825d27192588e6e..200aabb873e51f3f8163aab58a96a512c20c276c 100644 (file)
@@ -869,6 +869,18 @@ The 'output' is the name of the RandR output you attach your screen to. On a
 laptop, you might have VGA1 and LVDS1 as output names. You can see the
 available outputs by running +xrandr --current+.
 
+If your X server supports RandR 1.5 or newer, i3 will use RandR monitor objects
+instead of output objects. Run +xrandr --listmonitors+ to see a list. Usually,
+a monitor object contains exactly one output, and has the same name as the
+output; but should that not be the case, you may specify the name of either the
+monitor or the output in i3's configuration. For example, the Dell UP2414Q uses
+two scalers internally, so its output names might be “DP1” and “DP2”, but the
+monitor name is “Dell UP2414Q”.
+
+(Note that even if you specify the name of an output which doesn't span the
+entire monitor, i3 will still use the entire area of the containing monitor
+rather than that of just the output's.)
+
 If you use named workspaces, they must be quoted:
 
 *Examples*: