Document updates to the output command

1 files 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:
         +