diff options
Diffstat (limited to 'nixos/doc/manual/configuration/x-windows.xml')
-rw-r--r-- | nixos/doc/manual/configuration/x-windows.xml | 46 |
1 files changed, 23 insertions, 23 deletions
diff --git a/nixos/doc/manual/configuration/x-windows.xml b/nixos/doc/manual/configuration/x-windows.xml index 9c2c59006f15..fd0daf6c6e57 100644 --- a/nixos/doc/manual/configuration/x-windows.xml +++ b/nixos/doc/manual/configuration/x-windows.xml @@ -9,14 +9,14 @@ <para>The X Window System (X11) provides the basis of NixOS’ graphical user interface. It can be enabled as follows: <programlisting> -services.xserver.enable = true; +<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. <programlisting> -services.xserver.videoDrivers = [ "r128" ]; +<xref linkend="opt-services.xserver.videoDrivers"/> = [ "r128" ]; </programlisting> to enable X.org’s <literal>xf86-video-r128</literal> driver.</para> @@ -25,13 +25,13 @@ 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> -services.xserver.desktopManager.plasma5.enable = true; -services.xserver.desktopManager.xfce.enable = true; -services.xserver.desktopManager.gnome3.enable = true; -services.xserver.windowManager.xmonad.enable = true; -services.xserver.windowManager.twm.enable = true; -services.xserver.windowManager.icewm.enable = true; -services.xserver.windowManager.i3.enable = true; +<xref linkend="opt-services.xserver.desktopManager.plasma5.enable"/> = true; +<xref linkend="opt-services.xserver.desktopManager.xfce.enable"/> = true; +<xref linkend="opt-services.xserver.desktopManager.gnome3.enable"/> = true; +<xref linkend="opt-services.xserver.windowManager.xmonad.enable"/> = true; +<xref linkend="opt-services.xserver.windowManager.twm.enable"/> = true; +<xref linkend="opt-services.xserver.windowManager.icewm.enable"/> = true; +<xref linkend="opt-services.xserver.windowManager.i3.enable"/> = true; </programlisting> </para> @@ -40,22 +40,22 @@ 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> -services.xserver.displayManager.sddm.enable = true; -services.xserver.displayManager.lightdm.enable = true; +<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): <programlisting> -services.xserver.layout = "de"; -services.xserver.xkbVariant = "neo"; +<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: <programlisting> -services.xserver.autorun = false; +<xref linkend="opt-services.xserver.autorun"/> = false; </programlisting> The X server can then be started manually: <screen> @@ -70,13 +70,13 @@ The X server can then be started manually: 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> -services.xserver.videoDrivers = [ "nvidia" ]; +<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: <programlisting> -services.xserver.videoDrivers = [ "nvidiaLegacy340" ]; -services.xserver.videoDrivers = [ "nvidiaLegacy304" ]; -services.xserver.videoDrivers = [ "nvidiaLegacy173" ]; +<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> @@ -84,7 +84,7 @@ 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> -hardware.opengl.driSupport32Bit = true; +<xref linkend="opt-hardware.opengl.driSupport32Bit"/> = true; </programlisting> </para> @@ -96,7 +96,7 @@ hardware.opengl.driSupport32Bit = true; 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> -services.xserver.videoDrivers = [ "ati_unfree" ]; +<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> @@ -104,7 +104,7 @@ 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> -hardware.opengl.driSupport32Bit = true; +<xref linkend="opt-hardware.opengl.driSupport32Bit"/> = true; </programlisting> </para> @@ -115,12 +115,12 @@ hardware.opengl.driSupport32Bit = true; <para>Support for Synaptics touchpads (found in many laptops such as the Dell Latitude series) can be enabled as follows: <programlisting> -services.xserver.libinput.enable = true; +<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: <programlisting> -services.xserver.libinput.tapping = false; +<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> |