Merge pull request #123149 from primeos/nixos-sway-doc

nixos/sway: Update the module documentation
This commit is contained in:
Michael Weiss 2021-05-15 21:29:12 +02:00 committed by GitHub
commit cc7fe8ff0c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -39,9 +39,8 @@ in {
Sway, the i3-compatible tiling Wayland compositor. You can manually launch Sway, the i3-compatible tiling Wayland compositor. You can manually launch
Sway by executing "exec sway" on a TTY. Copy /etc/sway/config to Sway by executing "exec sway" on a TTY. Copy /etc/sway/config to
~/.config/sway/config to modify the default configuration. See ~/.config/sway/config to modify the default configuration. See
https://github.com/swaywm/sway/wiki and "man 5 sway" for more information. <link xlink:href="https://github.com/swaywm/sway/wiki" /> and
Please have a look at the "extraSessionCommands" example for running "man 5 sway" for more information'';
programs natively under Wayland'';
wrapperFeatures = mkOption { wrapperFeatures = mkOption {
type = wrapperOptions; type = wrapperOptions;
@ -56,16 +55,20 @@ in {
type = types.lines; type = types.lines;
default = ""; default = "";
example = '' example = ''
# SDL:
export SDL_VIDEODRIVER=wayland export SDL_VIDEODRIVER=wayland
# needs qt5.qtwayland in systemPackages # QT (needs qt5.qtwayland in systemPackages):
export QT_QPA_PLATFORM=wayland export QT_QPA_PLATFORM=wayland-egl
export QT_WAYLAND_DISABLE_WINDOWDECORATION="1" export QT_WAYLAND_DISABLE_WINDOWDECORATION="1"
# Fix for some Java AWT applications (e.g. Android Studio), # Fix for some Java AWT applications (e.g. Android Studio),
# use this if they aren't displayed properly: # use this if they aren't displayed properly:
export _JAVA_AWT_WM_NONREPARENTING=1 export _JAVA_AWT_WM_NONREPARENTING=1
''; '';
description = '' description = ''
Shell commands executed just before Sway is started. Shell commands executed just before Sway is started. See
<link xlink:href="https://github.com/swaywm/sway/wiki/Running-programs-natively-under-wayland" />
and <link xlink:href="https://github.com/swaywm/wlroots/blob/master/docs/env_vars.md" />
for some useful environment variables.
''; '';
}; };
@ -95,13 +98,15 @@ in {
''; '';
example = literalExample '' example = literalExample ''
with pkgs; [ with pkgs; [
xwayland
i3status i3status-rust i3status i3status-rust
termite rofi light termite rofi light
] ]
''; '';
description = '' description = ''
Extra packages to be installed system wide. Extra packages to be installed system wide. See
<link xlink:href="https://github.com/swaywm/sway/wiki/Useful-add-ons-for-sway" /> and
<link xlink:href="https://github.com/swaywm/sway/wiki/i3-Migration-Guide#common-x11-apps-used-on-i3-with-wayland-alternatives" />
for a list of useful software.
''; '';
}; };