diff options
-rw-r--r-- | meson.build | 1 | ||||
-rw-r--r-- | sway/sway-input.5.scd | 2 | ||||
-rw-r--r-- | sway/sway-output.5.scd | 66 | ||||
-rw-r--r-- | sway/sway.1.scd | 2 | ||||
-rw-r--r-- | sway/sway.5.scd | 55 |
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 @@ | |||
1 | sway-output(5) | ||
2 | |||
3 | # NAME | ||
4 | |||
5 | sway-output - output configuration commands for sway | ||
6 | |||
7 | # DESCRIPTION | ||
8 | |||
9 | You may combine output commands into one, like so: | ||
10 | |||
11 | output HDMI-A-1 mode 1920x1080 pos 1920,0 bg ~/wallpaper.png stretch | ||
12 | |||
13 | You can get a list of output names with *swaymsg -t get\_outputs*. You may also | ||
14 | match 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 | |||
549 | You may combine output commands into one, like so: | ||
550 | |||
551 | output HDMI-A-1 mode 1920x1080 pos 1920,0 bg ~/wallpaper.png stretch | ||
552 | |||
553 | You can get a list of output names with *swaymsg -t get\_outputs*. You may also | ||
554 | match 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 |