From 669f91b991b7bcc4108916f208cd4bbe14169460 Mon Sep 17 00:00:00 2001
From: Drew DeVault <sir@cmpwn.com>
Date: Sun, 25 Feb 2018 11:35:31 -0500
Subject: [PATCH] Document updates to the output command

---
 sway/sway.5.txt | 31 ++++++++++++++++++++-----------
 1 file changed, 20 insertions(+), 11 deletions(-)

diff --git a/sway/sway.5.txt b/sway/sway.5.txt
index afd3c9fa..6c9bce7a 100644
--- a/sway/sway.5.txt
+++ b/sway/sway.5.txt
@@ -353,35 +353,44 @@ The default colors are:
 	Prevents windows matching <criteria> from being focused automatically when
 	they're created. This does not apply to the first window in a workspace.
 
-**output** <name> <resolution|res> <WIDTHxHEIGHT>::
-	Configures the specified output to use the given resolution.
+**output** <name> mode|resolution|res <WIDTHxHEIGHT>[@<RATE>[Hz]]::
+	Configures the specified output to use the given mode. Modes are a combination
+	of width and height (in pixels) and a refresh rate that your display can be
+	configured to use. For a list of available modes, use swaymsg -t get_outputs.
 	+
-	_Note_: sway does not currently support setting the output mode. Your output's native
-	resolution will be used and the screen will be scaled from the resolution
-	specified to your native resolution.
+	Examples:
+	+
+	output HDMI-A-1 mode 1920x1080
+	+
+	output HDMI-A-1 mode 1920x1080@60Hz
 
-**output** <name> <position|pos> <X,Y>::
+**output** <name> position|pos <X,Y>::
 	Configures the specified output to be arranged at the given position.
 
-**output** <name> <scale> <I>::
+**output** <name> scale <I>::
 	Configures the specified output to be scaled up by the specified integer
-	scaling factor (usually 2 for HiDPI screens).
+	scaling factor (usually 2 for HiDPI screens). Fractional scaling is supported.
 
-**output** <name> <background|bg> <file> <mode>::
+**output** <name> background|bg <file> <mode>::
 	Sets the wallpaper for the given output to the specified file, using the given
 	scaling mode (one of "stretch", "fill", "fit", "center", "tile").
 
-**output** <name> <background|bg> <color> solid_color::
+**output** <name> background|bg <color> solid_color::
 	Sets the background of the given output to the specified color. _color_ should
 	be specified as an _#rrggbb_ (no alpha) color.
 
+**output** <name> transform <transform>::
+	Sets the background transform to the given value. Can be one of "90", "180",
+	"270" for rotation; or "flipped", "flipped-90", "flipped-180", "flipped-270"
+	to apply a rotation and flip, or "normal" to apply no transform.
+
 **output** <name> disable::
 	Disables the specified output.
 
 **NOTES FOR THE OUTPUT COMMAND**::
 	You may combine output commands into one, like so:
 	+
-	output HDMI-A-1 res 1920x1080 pos 1920,0 bg ~/wallpaper.png stretch
+	output HDMI-A-1 mode 1920x1080 pos 1920,0 bg ~/wallpaper.png stretch
 	+
 	You can get a list of output names like so:
 	+