1 files changed, 16 insertions, 10 deletions

diff --git a/sway/sway-output.5.scd b/sway/sway-output.5.scd
index 4159a851..7d088d5d 100644
--- a/sway/sway-output.5.scd
+++ b/sway/sway-output.5.scd
@@ -24,7 +24,7 @@ must be separated by one space. For example:
 
 # COMMANDS
 
-*output* <name> mode|resolution|res [--custom] <WIDTHxHEIGHT>[@<RATE>Hz]
+*output* <name> mode|resolution|res [--custom] <width>x<height>[@<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 for each
@@ -72,13 +72,11 @@ must be separated by one space. For example:
 
 *output* <name> scale <factor>
         Scales the specified output by the specified scale _factor_. An integer is
-        recommended, but fractional values are also supported. If a fractional
-        value are specified, be warned that it is not possible to faithfully
-        represent the contents of your windows - they will be rendered at the next
-        highest integer scale factor and downscaled. You may be better served by
-        setting an integer scale factor and adjusting the font size of your
-        applications to taste. HiDPI isn't supported with Xwayland clients (windows
-        will blur).
+        recommended, but fractional values are also supported. You may be better
+        served by setting an integer scale factor and adjusting the font size of
+        your applications to taste. HiDPI isn't supported with Xwayland clients
+        (windows will blur). A fractional scale may be slightly adjusted to match
+        requirements of the protocol.
 
 *output* <name> scale_filter linear|nearest|smart
         Indicates how to scale application buffers that are rendered at a scale
@@ -119,12 +117,20 @@ must be separated by one space. For example:
         Enables or disables the specified output (all outputs are enabled by
         default).
 
+        As opposed to the _power_ command, the output will lose its current
+        workspace and windows.
+
 *output* <name> toggle
         Toggle the specified output.
 
+*output* <name> power on|off|toggle
+        Turns on or off the specified output.
+
+        As opposed to the _enable_ and _disable_ commands, the output keeps its
+        current workspaces and windows.
+
 *output* <name> dpms on|off|toggle
-        Enables or disables the specified output via DPMS. To turn an output off
-        (ie. blank the screen but keep workspaces as-is), one can set DPMS to off.
+        Deprecated. Alias for _power_.
 
 *output* <name> max_render_time off|<msec>
         Controls when sway composites the output, as a positive number of