diff options
author | Graham Christensen <graham@grahamc.com> | 2018-05-01 19:57:09 -0400 |
---|---|---|
committer | Graham Christensen <graham@grahamc.com> | 2018-05-01 19:57:09 -0400 |
commit | eca5c99bf8a115ffd9513f91decc064a5bb3ff6d (patch) | |
tree | 7b49bc123be12ca5344428c6975e4487e69d55e3 /nixos/doc/manual/configuration/x-windows.xml | |
parent | 77161de4546697f9bf2da6d081eeba4c399b3313 (diff) | |
download | nixpkgs-eca5c99bf8a115ffd9513f91decc064a5bb3ff6d.tar nixpkgs-eca5c99bf8a115ffd9513f91decc064a5bb3ff6d.tar.gz nixpkgs-eca5c99bf8a115ffd9513f91decc064a5bb3ff6d.tar.bz2 nixpkgs-eca5c99bf8a115ffd9513f91decc064a5bb3ff6d.tar.lz nixpkgs-eca5c99bf8a115ffd9513f91decc064a5bb3ff6d.tar.xz nixpkgs-eca5c99bf8a115ffd9513f91decc064a5bb3ff6d.tar.zst nixpkgs-eca5c99bf8a115ffd9513f91decc064a5bb3ff6d.zip |
nixos docs: format =)
Diffstat (limited to 'nixos/doc/manual/configuration/x-windows.xml')
-rw-r--r-- | nixos/doc/manual/configuration/x-windows.xml | 159 |
1 files changed, 77 insertions, 82 deletions
diff --git a/nixos/doc/manual/configuration/x-windows.xml b/nixos/doc/manual/configuration/x-windows.xml index fd0daf6c6e5..9a0969ad635 100644 --- a/nixos/doc/manual/configuration/x-windows.xml +++ b/nixos/doc/manual/configuration/x-windows.xml @@ -3,27 +3,25 @@ xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0" xml:id="sec-x11"> - -<title>X Window System</title> - -<para>The X Window System (X11) provides the basis of NixOS’ graphical -user interface. It can be enabled as follows: + <title>X Window System</title> + <para> + The X Window System (X11) provides the basis of NixOS’ graphical user + interface. It can be enabled as follows: <programlisting> <xref linkend="opt-services.xserver.enable"/> = true; </programlisting> -The X server will automatically detect and use the appropriate video -driver from a set of X.org drivers (such as <literal>vesa</literal> -and <literal>intel</literal>). You can also specify a driver -manually, e.g. + The X server will automatically detect and use the appropriate video driver + from a set of X.org drivers (such as <literal>vesa</literal> and + <literal>intel</literal>). You can also specify a driver manually, e.g. <programlisting> <xref linkend="opt-services.xserver.videoDrivers"/> = [ "r128" ]; </programlisting> -to enable X.org’s <literal>xf86-video-r128</literal> driver.</para> - -<para>You also need to enable at least one desktop or window manager. -Otherwise, you can only log into a plain undecorated -<command>xterm</command> window. Thus you should pick one or more of -the following lines: + to enable X.org’s <literal>xf86-video-r128</literal> driver. + </para> + <para> + You also need to enable at least one desktop or window manager. Otherwise, + you can only log into a plain undecorated <command>xterm</command> window. + Thus you should pick one or more of the following lines: <programlisting> <xref linkend="opt-services.xserver.desktopManager.plasma5.enable"/> = true; <xref linkend="opt-services.xserver.desktopManager.xfce.enable"/> = true; @@ -33,108 +31,105 @@ the following lines: <xref linkend="opt-services.xserver.windowManager.icewm.enable"/> = true; <xref linkend="opt-services.xserver.windowManager.i3.enable"/> = true; </programlisting> -</para> - -<para>NixOS’s default <emphasis>display manager</emphasis> (the -program that provides a graphical login prompt and manages the X -server) is SLiM. You can select an alternative one by picking one -of the following lines: + </para> + <para> + NixOS’s default <emphasis>display manager</emphasis> (the program that + provides a graphical login prompt and manages the X server) is SLiM. You can + select an alternative one by picking one of the following lines: <programlisting> <xref linkend="opt-services.xserver.displayManager.sddm.enable"/> = true; <xref linkend="opt-services.xserver.displayManager.lightdm.enable"/> = true; </programlisting> -</para> - -<para>You can set the keyboard layout (and optionally the layout variant): + </para> + <para> + You can set the keyboard layout (and optionally the layout variant): <programlisting> <xref linkend="opt-services.xserver.layout"/> = "de"; <xref linkend="opt-services.xserver.xkbVariant"/> = "neo"; </programlisting> -</para> - -<para>The X server is started automatically at boot time. If you -don’t want this to happen, you can set: + </para> + <para> + The X server is started automatically at boot time. If you don’t want this + to happen, you can set: <programlisting> <xref linkend="opt-services.xserver.autorun"/> = false; </programlisting> -The X server can then be started manually: + The X server can then be started manually: <screen> # systemctl start display-manager.service </screen> -</para> - - -<simplesect><title>NVIDIA Graphics Cards</title> - -<para>NVIDIA provides a proprietary driver for its graphics cards that -has better 3D performance than the X.org drivers. It is not enabled -by default because it’s not free software. You can enable it as follows: + </para> + <simplesect> + <title>NVIDIA Graphics Cards</title> + <para> + NVIDIA provides a proprietary driver for its graphics cards that has better + 3D performance than the X.org drivers. It is not enabled by default because + it’s not free software. You can enable it as follows: <programlisting> <xref linkend="opt-services.xserver.videoDrivers"/> = [ "nvidia" ]; </programlisting> -Or if you have an older card, you may have to use one of the legacy drivers: + Or if you have an older card, you may have to use one of the legacy drivers: <programlisting> <xref linkend="opt-services.xserver.videoDrivers"/> = [ "nvidiaLegacy340" ]; <xref linkend="opt-services.xserver.videoDrivers"/> = [ "nvidiaLegacy304" ]; <xref linkend="opt-services.xserver.videoDrivers"/> = [ "nvidiaLegacy173" ]; </programlisting> -You may need to reboot after enabling this driver to prevent a clash -with other kernel modules.</para> - -<para>On 64-bit systems, if you want full acceleration for 32-bit -programs such as Wine, you should also set the following: + You may need to reboot after enabling this driver to prevent a clash with + other kernel modules. + </para> + <para> + On 64-bit systems, if you want full acceleration for 32-bit programs such as + Wine, you should also set the following: <programlisting> <xref linkend="opt-hardware.opengl.driSupport32Bit"/> = true; </programlisting> -</para> - -</simplesect> - -<simplesect><title>AMD Graphics Cards</title> - -<para>AMD provides a proprietary driver for its graphics cards that -has better 3D performance than the X.org drivers. It is not enabled -by default because it’s not free software. You can enable it as follows: + </para> + </simplesect> + <simplesect> + <title>AMD Graphics Cards</title> + <para> + AMD provides a proprietary driver for its graphics cards that has better 3D + performance than the X.org drivers. It is not enabled by default because + it’s not free software. You can enable it as follows: <programlisting> <xref linkend="opt-services.xserver.videoDrivers"/> = [ "ati_unfree" ]; </programlisting> -You will need to reboot after enabling this driver to prevent a clash -with other kernel modules.</para> - -<para>On 64-bit systems, if you want full acceleration for 32-bit -programs such as Wine, you should also set the following: + You will need to reboot after enabling this driver to prevent a clash with + other kernel modules. + </para> + <para> + On 64-bit systems, if you want full acceleration for 32-bit programs such as + Wine, you should also set the following: <programlisting> <xref linkend="opt-hardware.opengl.driSupport32Bit"/> = true; </programlisting> -</para> - -</simplesect> - -<simplesect><title>Touchpads</title> - -<para>Support for Synaptics touchpads (found in many laptops such as -the Dell Latitude series) can be enabled as follows: + </para> + </simplesect> + <simplesect> + <title>Touchpads</title> + <para> + Support for Synaptics touchpads (found in many laptops such as the Dell + Latitude series) can be enabled as follows: <programlisting> <xref linkend="opt-services.xserver.libinput.enable"/> = true; </programlisting> -The driver has many options (see <xref linkend="ch-options"/>). For -instance, the following disables tap-to-click behavior: + The driver has many options (see <xref linkend="ch-options"/>). For + instance, the following disables tap-to-click behavior: <programlisting> <xref linkend="opt-services.xserver.libinput.tapping"/> = false; </programlisting> -Note: the use of <literal>services.xserver.synaptics</literal> is deprecated since NixOS 17.09. -</para> - -</simplesect> - -<simplesect><title>GTK/Qt themes</title> - -<para>GTK themes can be installed either to user profile or system-wide (via -<literal>environment.systemPackages</literal>). To make Qt 5 applications look similar -to GTK2 ones, you can install <literal>qt5.qtbase.gtk</literal> package into your -system environment. It should work for all Qt 5 library versions. -</para> - -</simplesect> - + Note: the use of <literal>services.xserver.synaptics</literal> is deprecated + since NixOS 17.09. + </para> + </simplesect> + <simplesect> + <title>GTK/Qt themes</title> + <para> + GTK themes can be installed either to user profile or system-wide (via + <literal>environment.systemPackages</literal>). To make Qt 5 applications + look similar to GTK2 ones, you can install <literal>qt5.qtbase.gtk</literal> + package into your system environment. It should work for all Qt 5 library + versions. + </para> + </simplesect> </chapter> |