aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--meson.build1
-rw-r--r--sway/sway-input.5.scd2
-rw-r--r--sway/sway-output.5.scd66
-rw-r--r--sway/sway.1.scd2
-rw-r--r--sway/sway.5.scd55
5 files changed, 69 insertions, 57 deletions
diff --git a/meson.build b/meson.build
index 42386fbc..31c3e53e 100644
--- a/meson.build
+++ b/meson.build
@@ -89,6 +89,7 @@ if scdoc.found()
89 'sway/sway.5.scd', 89 'sway/sway.5.scd',
90 'sway/sway-bar.5.scd', 90 'sway/sway-bar.5.scd',
91 'sway/sway-input.5.scd', 91 'sway/sway-input.5.scd',
92 'sway/sway-output.5.scd',
92 'swaylock/swaylock.1.scd', 93 'swaylock/swaylock.1.scd',
93 'swaymsg/swaymsg.1.scd', 94 'swaymsg/swaymsg.1.scd',
94 'swayidle/swayidle.1.scd', 95 'swayidle/swayidle.1.scd',
diff --git a/sway/sway-input.5.scd b/sway/sway-input.5.scd
index e5673452..82273ef3 100644
--- a/sway/sway-input.5.scd
+++ b/sway/sway-input.5.scd
@@ -143,4 +143,4 @@ in their own "seat").
143 143
144# SEE ALSO 144# SEE ALSO
145 145
146*sway*(5) 146*sway*(5) *sway-output*(5)
diff --git a/sway/sway-output.5.scd b/sway/sway-output.5.scd
new file mode 100644
index 00000000..fe5b33bc
--- /dev/null
+++ b/sway/sway-output.5.scd
@@ -0,0 +1,66 @@
1sway-output(5)
2
3# NAME
4
5sway-output - output configuration commands for sway
6
7# DESCRIPTION
8
9You may combine output commands into one, like so:
10
11 output HDMI-A-1 mode 1920x1080 pos 1920,0 bg ~/wallpaper.png stretch
12
13You can get a list of output names with *swaymsg -t get\_outputs*. You may also
14match any output by using the output name "\*".
15
16# COMMANDS
17
18*output* <name> mode|resolution|res <WIDTHxHEIGHT>[@<RATE>[Hz]]
19 Configures the specified output to use the given mode. Modes are a
20 combination of width and height (in pixels) and a refresh rate that your
21 display can be configured to use. For a list of available modes for each
22 output, use *swaymsg -t get\_outputs*.
23
24 Examples:
25
26 output HDMI-A-1 mode 1920x1080
27
28 output HDMI-A-1 mode 1920x1080@60Hz
29
30*output* <name> position|pos <X> <Y>
31 Places the specified output at the specific position in the global
32 coordinate space.
33
34*output* <name> scale <factor>
35 Scales the specified output by the specified scale _factor_. An integer is
36 recommended, but fractional values are also supported. If a fractional
37 value are specified, be warned that it is not possible to faithfully
38 represent the contents of your windows - they will be rendered at the next
39 highest integral scale factor and downscaled. You may be better served by
40 setting an integral scale factor and adjusting the font size of your
41 applications to taste.
42
43*output* <name> background|bg <file> <mode> [<fallback\_color>]
44 Sets the wallpaper for the given output to the specified file, using the
45 given scaling mode (one of "stretch", "fill", "fit", "center", "tile"). If
46 the specified file cannot be accessed or if the image does fill the entire
47 output, a fallback color may be provided to cover the rest of the output.
48 __fallback\_color__ should be specified as _#RRGGBB_. Alpha is not
49 supported.
50
51*output* <name> background|bg <color> solid\_color
52 Sets the background of the given output to the specified color. _color_
53 should be specified as _#RRGGBB_. Alpha is not supported.
54
55*output* <name> transform <transform>
56 Sets the background transform to the given value. Can be one of "90", "180",
57 "270" for rotation; or "flipped", "flipped-90", "flipped-180", "flipped-270"
58 to apply a rotation and flip, or "normal" to apply no transform.
59
60*output* <name> disable|enable
61 Enables or disables the specified output (all outputs are enabled by
62 default).
63
64# SEE ALSO
65
66*sway*(5) *sway-input*(5)
diff --git a/sway/sway.1.scd b/sway/sway.1.scd
index 0c2ee974..f66c4cdb 100644
--- a/sway/sway.1.scd
+++ b/sway/sway.1.scd
@@ -92,4 +92,4 @@ source contributors. For more information about sway development, see
92 92
93# SEE ALSO 93# SEE ALSO
94 94
95*sway*(5) *swaymsg*(1) *sway-input*(5) *sway-bar*(5) 95*sway*(5) *swaymsg*(1) *sway-input*(5) *sway-output*(5) *sway-bar*(5)
diff --git a/sway/sway.5.scd b/sway/sway.5.scd
index 3a760d01..f6f0e859 100644
--- a/sway/sway.5.scd
+++ b/sway/sway.5.scd
@@ -498,61 +498,6 @@ The default colors are:
498 Prevents windows matching <criteria> from being focused automatically when 498 Prevents windows matching <criteria> from being focused automatically when
499 they're created. This has no effect on the first window in a workspace. 499 they're created. This has no effect on the first window in a workspace.
500 500
501*output* <name> mode|resolution|res <WIDTHxHEIGHT>[@<RATE>[Hz]]
502 Configures the specified output to use the given mode. Modes are a
503 combination of width and height (in pixels) and a refresh rate that your
504 display can be configured to use. For a list of available modes for each
505 output, use *swaymsg -t get\_outputs*.
506
507 Examples:
508
509 output HDMI-A-1 mode 1920x1080
510
511 output HDMI-A-1 mode 1920x1080@60Hz
512
513*output* <name> position|pos <X> <Y>
514 Places the specified output at the specific position in the global
515 coordinate space.
516
517*output* <name> scale <factor>
518 Scales the specified output by the specified scale _factor_. An integer is
519 recommended, but fractional values are also supported. If a fractional
520 value are specified, be warned that it is not possible to faithfully
521 represent the contents of your windows - they will be rendered at the next
522 highest integral scale factor and downscaled. You may be better served by
523 setting an integral scale factor and adjusting the font size of your
524 applications to taste.
525
526*output* <name> background|bg <file> <mode> [<fallback\_color>]
527 Sets the wallpaper for the given output to the specified file, using the
528 given scaling mode (one of "stretch", "fill", "fit", "center", "tile"). If
529 the specified file cannot be accessed or if the image does fill the entire
530 output, a fallback color may be provided to cover the rest of the output.
531 __fallback\_color__ should be specified as _#RRGGBB_. Alpha is not
532 supported.
533
534*output* <name> background|bg <color> solid\_color
535 Sets the background of the given output to the specified color. _color_
536 should be specified as _#RRGGBB_. Alpha is not supported.
537
538*output* <name> transform <transform>
539 Sets the background transform to the given value. Can be one of "90", "180",
540 "270" for rotation; or "flipped", "flipped-90", "flipped-180", "flipped-270"
541 to apply a rotation and flip, or "normal" to apply no transform.
542
543*output* <name> disable|enable
544 Enables or disables the specified output (all outputs are enabled by
545 default).
546
547*NOTES FOR THE OUTPUT COMMANDS*
548
549You may combine output commands into one, like so:
550
551 output HDMI-A-1 mode 1920x1080 pos 1920,0 bg ~/wallpaper.png stretch
552
553You can get a list of output names with *swaymsg -t get\_outputs*. You may also
554match any output by using the output name "\*".
555
556*popup\_during\_fullscreen* smart|ignore|leave\_fullscreen 501*popup\_during\_fullscreen* smart|ignore|leave\_fullscreen
557 Determines what to do when a fullscreen view opens a dialog. 502 Determines what to do when a fullscreen view opens a dialog.
558 If _smart_ (the default), the dialog will be displayed. If _ignore_, the 503 If _smart_ (the default), the dialog will be displayed. If _ignore_, the