diff options
Diffstat (limited to 'documentation/content/en/books/handbook/x11/_index.po')
| -rw-r--r-- | documentation/content/en/books/handbook/x11/_index.po | 1289 |
1 files changed, 827 insertions, 462 deletions
diff --git a/documentation/content/en/books/handbook/x11/_index.po b/documentation/content/en/books/handbook/x11/_index.po index d1dee6450e..9cc544e5d3 100644 --- a/documentation/content/en/books/handbook/x11/_index.po +++ b/documentation/content/en/books/handbook/x11/_index.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2025-06-29 21:20+0100\n" +"POT-Creation-Date: 2025-11-08 16:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -19,7 +19,7 @@ msgstr "" #. type: YAML Front Matter: description #: documentation/content/en/books/handbook/x11/_index.adoc:1 #, no-wrap -msgid "This chapter describes how to install and configure Xorg on FreeBSD, which provides the open source X Window System used to provide a graphical environment" +msgid "This chapter describes how to install and configure the X Window System providing a graphical environment" msgstr "" #. type: YAML Front Matter: part @@ -47,643 +47,846 @@ msgid "Synopsis" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:58 +#: documentation/content/en/books/handbook/x11/_index.adoc:61 msgid "" -"An installation of FreeBSD using bsdinstall does not automatically install a " -"graphical user interface. This chapter describes how to install and " -"configure Xorg, which provides the open source X Window System used to " -"provide a graphical environment. It then describes how to find and install " -"a desktop environment or window manager." +"An crossref:bsdinstall[bsdinstall-synopsis,installation] of FreeBSD using " +"man:bsdinstall[8] does not automatically install a graphical user " +"interface. This chapter describes how to install and configure the " +"man:Xorg[1] server, which provides the open source X Window System " +"(colloquially X11) used to provide a graphical environment." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:60 -msgid "Before reading this chapter, you should:" +#: documentation/content/en/books/handbook/x11/_index.adoc:63 +msgid "Before reading this chapter:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:62 +#: documentation/content/en/books/handbook/x11/_index.adoc:66 msgid "" "Know how to install additional third-party software as described in " "crossref:ports[ports,Installing Applications: Packages and Ports]." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:64 -msgid "After reading this chapter, you will know:" -msgstr "" - -#. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:66 -msgid "" -"The various components of the X Window System, and how they interoperate." +#: documentation/content/en/books/handbook/x11/_index.adoc:68 +msgid "Read this chapter to learn:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:67 -msgid "How to install and configure Xorg." +#: documentation/content/en/books/handbook/x11/_index.adoc:70 +msgid "How to select and install drivers for the graphics processor (GPU)." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:68 -msgid "How to use TrueType(R) fonts in Xorg." +#: documentation/content/en/books/handbook/x11/_index.adoc:72 +msgid "" +"The various components of the X Window System, and how they interoperate." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:69 -msgid "How to set up your system for graphical logins (XDM)." -msgstr "" - -#. type: Title == -#: documentation/content/en/books/handbook/x11/_index.adoc:71 -#, no-wrap -msgid "Installing Xorg" +#: documentation/content/en/books/handbook/x11/_index.adoc:73 +msgid "How to install and configure the X.org server." msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/x11/_index.adoc:74 -msgid "On FreeBSD, Xorg can be installed as a package or port." +msgid "How to install fonts for the X Window System." msgstr "" -#. type: Plain text +#. type: Title == #: documentation/content/en/books/handbook/x11/_index.adoc:76 -msgid "" -"The binary meta package can be installed quickly but with fewer options for " -"customization:" -msgstr "" - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:80 #, no-wrap -msgid "# pkg install xorg\n" +msgid "Graphics Drivers" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:83 +#: documentation/content/en/books/handbook/x11/_index.adoc:80 msgid "" -"Either of these installations results in the complete Xorg system being " -"installed." +"_**abstract**: Identify the GPU, the port providing a driver for it, install " +"it, then enable it to run at subsequent boot with man:sysrc[8]._" msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/x11/_index.adoc:86 msgid "" -"The current user must be a member of the `video` group. To add a user to " -"`video` group, execute the following command:" -msgstr "" - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:90 -#, no-wrap -msgid "# pw groupmod video -m username\n" -msgstr "" - -#. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:97 -msgid "" -"A smaller version of the X system suitable for experienced users is " -"available in package:x11/xorg-minimal[]. Most of the documents, libraries, " -"and applications will not be installed. Some applications require these " -"additional components to function." -msgstr "" - -#. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:103 -msgid "" -"Video cards, monitors, and input devices are automatically detected and do " -"not require any manual configuration. Do not create `xorg.conf` or run a `-" -"configure` step unless automatic configuration fails." -msgstr "" - -#. type: Title == -#: documentation/content/en/books/handbook/x11/_index.adoc:106 -#, no-wrap -msgid "Graphic card drivers" +"Before FreeBSD can render a graphical environment, it needs a kernel module " +"to drive the graphics processor. Graphics drivers are a fast-moving, cross-" +"platform target, which is why this is developed and distributed separately " +"from the FreeBSD base system." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:109 +#: documentation/content/en/books/handbook/x11/_index.adoc:90 msgid "" -"The following table shows the different graphics cards supported by FreeBSD, " -"which package should be installed and its corresponding module." +"The following table shows the different graphics processors supported by " +"FreeBSD, their corresponding module, and which port provides it:" msgstr "" #. type: Block title -#: documentation/content/en/books/handbook/x11/_index.adoc:110 +#: documentation/content/en/books/handbook/x11/_index.adoc:91 #, no-wrap -msgid "Graphic card packages" +msgid "Supported Graphics Devices" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:113 +#: documentation/content/en/books/handbook/x11/_index.adoc:94 #, no-wrap -msgid "Brand" +msgid "Type" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:113 +#: documentation/content/en/books/handbook/x11/_index.adoc:94 #, no-wrap -msgid "Type" +msgid "License" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:113 -#: documentation/content/en/books/handbook/x11/_index.adoc:249 +#: documentation/content/en/books/handbook/x11/_index.adoc:94 +#: documentation/content/en/books/handbook/x11/_index.adoc:269 #, no-wrap -msgid "Package" +msgid "Module" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:115 +#: documentation/content/en/books/handbook/x11/_index.adoc:96 +#: documentation/content/en/books/handbook/x11/_index.adoc:269 #, no-wrap -msgid "Module" +msgid "Port" msgstr "" -#. type: Title === -#: documentation/content/en/books/handbook/x11/_index.adoc:116 -#: documentation/content/en/books/handbook/x11/_index.adoc:191 +#. type: Table +#: documentation/content/en/books/handbook/x11/_index.adoc:97 #, no-wrap msgid "Intel(R)" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:117 -#: documentation/content/en/books/handbook/x11/_index.adoc:122 -#: documentation/content/en/books/handbook/x11/_index.adoc:132 -#: documentation/content/en/books/handbook/x11/_index.adoc:137 -#: documentation/content/en/books/handbook/x11/_index.adoc:142 -#: documentation/content/en/books/handbook/x11/_index.adoc:147 +#: documentation/content/en/books/handbook/x11/_index.adoc:98 +#: documentation/content/en/books/handbook/x11/_index.adoc:103 +#: documentation/content/en/books/handbook/x11/_index.adoc:114 +#: documentation/content/en/books/handbook/x11/_index.adoc:119 +#: documentation/content/en/books/handbook/x11/_index.adoc:124 +#: documentation/content/en/books/handbook/x11/_index.adoc:129 #, no-wrap msgid "Open Source" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:118 -#: documentation/content/en/books/handbook/x11/_index.adoc:123 +#: documentation/content/en/books/handbook/x11/_index.adoc:99 #, no-wrap -msgid "drm-kmod" +msgid "`i915kms`" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:120 +#: documentation/content/en/books/handbook/x11/_index.adoc:101 +#: documentation/content/en/books/handbook/x11/_index.adoc:106 #, no-wrap -msgid "`i915kms`" +msgid "package:graphics/drm-kmod[]" msgstr "" -#. type: Title === -#: documentation/content/en/books/handbook/x11/_index.adoc:121 -#: documentation/content/en/books/handbook/x11/_index.adoc:212 +#. type: Table +#: documentation/content/en/books/handbook/x11/_index.adoc:102 #, no-wrap msgid "AMD(R)" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:125 +#: documentation/content/en/books/handbook/x11/_index.adoc:104 #, no-wrap -msgid "`amdgpu` and `radeonkms`" +msgid "`amdgpu` or `radeonkms`" msgstr "" -#. type: Title === -#: documentation/content/en/books/handbook/x11/_index.adoc:126 -#: documentation/content/en/books/handbook/x11/_index.adoc:240 +#. type: Table +#: documentation/content/en/books/handbook/x11/_index.adoc:107 #, no-wrap msgid "NVIDIA(R)" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:127 +#: documentation/content/en/books/handbook/x11/_index.adoc:108 #, no-wrap msgid "Proprietary" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:128 +#: documentation/content/en/books/handbook/x11/_index.adoc:109 #, no-wrap -msgid "nvidia-driver" +msgid "`nvidia-drm`, `nvidia-modeset`, or `nvidia`" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:130 +#: documentation/content/en/books/handbook/x11/_index.adoc:112 #, no-wrap -msgid "`nvidia` or `nvidia-modeset`" +msgid "" +"package:graphics/nvidia-drm-kmod[] or +\n" +"package:x11/nvidia-driver[]" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:131 +#: documentation/content/en/books/handbook/x11/_index.adoc:113 #, no-wrap -msgid "VESA" +msgid "System Console Framebuffer" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:133 +#: documentation/content/en/books/handbook/x11/_index.adoc:115 #, no-wrap -msgid "xf86-video-vesa" +msgid "`scfb`" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:135 +#: documentation/content/en/books/handbook/x11/_index.adoc:117 #, no-wrap -msgid "vesa" +msgid "package:x11-drivers/xf86-video-scfb[]" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:136 +#: documentation/content/en/books/handbook/x11/_index.adoc:118 #, no-wrap -msgid "SCFB" +msgid "VESA BIOS Extension" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:138 +#: documentation/content/en/books/handbook/x11/_index.adoc:120 #, no-wrap -msgid "xf86-video-scfb" +msgid "`vesa`" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:140 +#: documentation/content/en/books/handbook/x11/_index.adoc:122 #, no-wrap -msgid "scfb" +msgid "package:x11-drivers/xf86-video-vesa[]" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:141 +#: documentation/content/en/books/handbook/x11/_index.adoc:123 #, no-wrap msgid "VirtualBox(R)" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:143 +#: documentation/content/en/books/handbook/x11/_index.adoc:125 #, no-wrap -msgid "virtualbox-ose-additions" +msgid "`vboxvideo`" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:145 +#: documentation/content/en/books/handbook/x11/_index.adoc:127 #, no-wrap -msgid "VirtualBox(R) OSE additions include the `vboxvideo` driver." +msgid "package:emulators/virtualbox-ose-additions[]" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:146 +#: documentation/content/en/books/handbook/x11/_index.adoc:128 #, no-wrap msgid "VMware(R)" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:148 +#: documentation/content/en/books/handbook/x11/_index.adoc:130 #, no-wrap -msgid "xf86-video-vmware" +msgid "`vmwgfx`" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:150 +#: documentation/content/en/books/handbook/x11/_index.adoc:131 #, no-wrap -msgid "vmwgfx" +msgid "package:x11-drivers/xf86-video-vmware[]" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:134 +msgid "There are several generations of driver technologies supported." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:138 +msgid "" +"Direct Rendering drivers allowing PRIME offloading. PRIME allows for " +"multiple providers of graphics processing to coexist. PRIME is described " +"further in <<x-config-gpu>>." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:143 +msgid "" +"Kernel Modesetting (crossref:glossary[kms-glossary,KMS]) This allows the " +"driver to directly specify the display mode. This is required to support " +"suspend and resume when using the man:vt[4] console driver." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:148 +msgid "" +"User Modesetting The oldest class of drivers is still supported, however " +"they may only be used with man:sc[4] console and older versions of the " +"man:Xorg[1] graphical environment." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:153 +#: documentation/content/en/books/handbook/x11/_index.adoc:151 msgid "" -"The following command can be used to identify which graphics card is " +"The following command can be used to identify which graphics processor is " "installed in the system:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:157 +#: documentation/content/en/books/handbook/x11/_index.adoc:155 +#: documentation/content/en/books/handbook/x11/_index.adoc:552 #, no-wrap -msgid "% pciconf -lv|grep -B4 VGA\n" +msgid "% pciconf -lv | grep -B3 display\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:160 -#: documentation/content/en/books/handbook/x11/_index.adoc:183 -#: documentation/content/en/books/handbook/x11/_index.adoc:430 -#: documentation/content/en/books/handbook/x11/_index.adoc:487 +#: documentation/content/en/books/handbook/x11/_index.adoc:158 +#: documentation/content/en/books/handbook/x11/_index.adoc:185 +#: documentation/content/en/books/handbook/x11/_index.adoc:555 +#: documentation/content/en/books/handbook/x11/_index.adoc:618 msgid "The output should be similar to the following:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:168 +#: documentation/content/en/books/handbook/x11/_index.adoc:165 #, no-wrap msgid "" -"vgapci0@pci0:0:2:0: class=0x030000 rev=0x07 hdr=0x00 vendor=0x8086 device=0x2a42 subvendor=0x17aa subdevice=0x20e4\n" +"vgapci1@pci0:0:2:0: class=0x030000 rev=0x0c hdr=0x00 vendor=0x8086 device=0x46a6 subvendor=0x1028 subdevice=0x0b29\n" " vendor = 'Intel Corporation'\n" -" device = 'Mobile 4 Series Chipset Integrated Graphics Controller'\n" +" device = 'Alder Lake-P GT2 [Iris Xe Graphics]'\n" " class = display\n" -" subclass = VGA\n" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:169 +msgid "" +"Detailed instructions on installing and enabling these drivers are in the " +"subsequent subsections." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:174 +#: documentation/content/en/books/handbook/x11/_index.adoc:176 msgid "" -"If the graphics card is not supported by Intel(R), AMD(R) or NVIDIA(R) " -"drivers, then VESA or SCFB modules should be used. VESA module must be used " -"when booting in BIOS mode and SCFB module must be used when booting in UEFI " +"If the graphics processor is not supported by Intel(R), AMD(R), or NVIDIA(R) " +"drivers, then SCFB or VESA modules should be used. SCFB module must be used " +"when booting in UEFI mode. VESA module must be used when booting in BIOS " "mode." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:176 +#: documentation/content/en/books/handbook/x11/_index.adoc:178 msgid "This command can be used to check the booting mode:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:180 +#: documentation/content/en/books/handbook/x11/_index.adoc:182 #, no-wrap msgid "% sysctl machdep.bootmethod\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:187 +#: documentation/content/en/books/handbook/x11/_index.adoc:189 #, no-wrap -msgid "machdep.bootmethod: BIOS\n" +msgid "machdep.bootmethod: UEFI\n" +msgstr "" + +#. type: Title === +#: documentation/content/en/books/handbook/x11/_index.adoc:193 +#, no-wrap +msgid "Intel(R) Graphics" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:195 +#: documentation/content/en/books/handbook/x11/_index.adoc:199 msgid "" -"Intel(R) Graphics refers to the class of graphics chips that are integrated " -"on the same die as an Intel(R) CPU. Wikipedia offers link:https://" -"en.wikipedia.org/wiki/List_of_Intel_graphics_processing_units[a good " -"overview of the variations and names used for generations of Intel HD " -"Graphics]." +"The package:graphics/drm-kmod[] package indirectly provides a range of " +"kernel modules for use with Intel(R) Graphics. Recent versions of these " +"modules can be used in conjunction with other graphics processors in PRIME " +"with no special configuration." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:198 +#: documentation/content/en/books/handbook/x11/_index.adoc:202 msgid "" -"The package:graphics/drm-kmod[] package indirectly provides a range of " -"kernel modules for use with Intel(R) Graphics cards. The Intel(R) driver " -"can be installed by executing the following command:" +"The Intel(R) Graphics driver can be installed by executing the following " +"command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:202 -#: documentation/content/en/books/handbook/x11/_index.adoc:223 +#: documentation/content/en/books/handbook/x11/_index.adoc:206 +#: documentation/content/en/books/handbook/x11/_index.adoc:232 #, no-wrap msgid "# pkg install drm-kmod\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:205 -#: documentation/content/en/books/handbook/x11/_index.adoc:281 +#: documentation/content/en/books/handbook/x11/_index.adoc:210 msgid "" -"Then add the module to `/etc/rc.conf` file, executing the following command:" +"Then add the module to [.filename]#/etc/rc.conf# file, by executing the " +"following command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:209 +#: documentation/content/en/books/handbook/x11/_index.adoc:214 #, no-wrap msgid "# sysrc kld_list+=i915kms\n" msgstr "" -#. type: Plain text +#. type: Title === #: documentation/content/en/books/handbook/x11/_index.adoc:217 +#, no-wrap +msgid "AMD(R) Graphics" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:225 msgid "" -"The package:graphics/drm-kmod[] package indirectly provides a range of " -"kernel modules for use with AMD(R) Graphics cards. The modules `amdgpu` and " +"The package:graphics/drm-kmod[] package indirectly provides kernel modules " +"for a range of AMD(R) Graphics processors. The modules `amdgpu` or " "`radeonkms` can be used depending the generation of the hardware. The " -"FreeBSD project maintains an link:https://wiki.freebsd.org/Graphics/AMD-GPU-" -"Matrix[AMD graphics support matrix to determine which driver must be used]." +"FreeBSD project maintains a link:https://wiki.freebsd.org/Graphics/AMD-GPU-" +"Matrix[AMD graphics support matrix] showing support levels and to determine " +"which driver must be used." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:219 -msgid "AMD(R) driver can be installed by executing the following command:" +#: documentation/content/en/books/handbook/x11/_index.adoc:228 +msgid "" +"The AMD(R) Graphics drivers can be installed by executing the following " +"command:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:226 +#: documentation/content/en/books/handbook/x11/_index.adoc:236 msgid "" -"For post-HD7000 or Tahiti graphic cards add the module to `/etc/rc.conf` " +"Enable the current module by adding it to the [.filename]#/etc/rc.conf# " "file, executing the following command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:230 +#: documentation/content/en/books/handbook/x11/_index.adoc:240 #, no-wrap msgid "# sysrc kld_list+=amdgpu\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:233 +#: documentation/content/en/books/handbook/x11/_index.adoc:245 msgid "" -"For older graphic cards (pre-HD7000 or pre-Tahiti) add the module to `/etc/" -"rc.conf` file, executing the following command:" +"For older graphics (pre-HD7000/Tahiti), instead enable the legacy module by " +"adding it to the [.filename]#/etc/rc.conf# file, executing the following " +"command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:237 +#: documentation/content/en/books/handbook/x11/_index.adoc:249 #, no-wrap msgid "# sysrc kld_list+=radeonkms\n" msgstr "" +#. type: Title === +#: documentation/content/en/books/handbook/x11/_index.adoc:252 +#, no-wrap +msgid "NVIDIA(R) Graphics" +msgstr "" + #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:245 +#: documentation/content/en/books/handbook/x11/_index.adoc:258 msgid "" -"FreeBSD supports different versions of the proprietary NVIDIA(R) driver. " -"Users of newer graphics cards should install the package:x11/nvidia-driver[] " -"package. Those with older cards will have to check below which version " -"supports them." +"NVIDIA(R) produces standalone or discrete graphics processors, and provides " +"a proprietary driver for FreeBSD. The FreeBSD Ports Collection provides " +"over a decade of drivers for supporting generations of NVIDIA graphics." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:261 +msgid "" +"Administrators should install the latest driver supported by their hardware." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:265 +msgid "" +"The following table shows the port containing the driver, the kernel module " +"recommended for loading, and a link to the list of hardware supported by " +"that driver:" msgstr "" #. type: Block title -#: documentation/content/en/books/handbook/x11/_index.adoc:246 +#: documentation/content/en/books/handbook/x11/_index.adoc:266 #, no-wrap -msgid "Supported versions of NVIDIA(R) drivers" +msgid "Supported versions of NVIDIA(R) Graphics drivers" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:251 +#: documentation/content/en/books/handbook/x11/_index.adoc:271 #, no-wrap msgid "Supported hardware" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:252 +#: documentation/content/en/books/handbook/x11/_index.adoc:272 #, no-wrap -msgid "package:x11/nvidia-driver-304[]" +msgid "package:graphics/nvidia-drm-kmod[]" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:254 +#: documentation/content/en/books/handbook/x11/_index.adoc:274 #, no-wrap -msgid "link:https://www.nvidia.com/Download/driverResults.aspx/123712/en-us/[supported hardware]" +msgid "" +"`nvidia-drm` or +\n" +"`nvidia-modeset`" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:255 +#: documentation/content/en/books/handbook/x11/_index.adoc:276 #, no-wrap -msgid "package:x11/nvidia-driver-340[]" +msgid "link:https://www.nvidia.com/Download/driverResults.aspx/210651/en-us/[supported hardware]" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:257 +#: documentation/content/en/books/handbook/x11/_index.adoc:277 #, no-wrap -msgid "link:https://www.nvidia.com/Download/driverResults.aspx/156167/en-us/[supported hardware]" +msgid "package:x11/nvidia-driver-470[]" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:258 +#: documentation/content/en/books/handbook/x11/_index.adoc:278 +#: documentation/content/en/books/handbook/x11/_index.adoc:283 +#, no-wrap +msgid "`nvidia-modeset`" +msgstr "" + +#. type: Table +#: documentation/content/en/books/handbook/x11/_index.adoc:280 +#, no-wrap +msgid "link:https://www.nvidia.com/Download/driverResults.aspx/194639/en-us/[supported hardware]" +msgstr "" + +#. type: Table +#: documentation/content/en/books/handbook/x11/_index.adoc:282 #, no-wrap -msgid "package:x11/nvidia-driver-390[]" +msgid "" +"package:x11/nvidia-driver-390[] or +\n" +"package:x11/nvidia-secondary-driver-390[]" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:260 +#: documentation/content/en/books/handbook/x11/_index.adoc:285 #, no-wrap msgid "link:https://www.nvidia.com/Download/driverResults.aspx/191122/en-us/[supported hardware]" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:261 +#: documentation/content/en/books/handbook/x11/_index.adoc:286 #, no-wrap -msgid "package:x11/nvidia-driver-470[]" +msgid "package:x11/nvidia-driver-340[]" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:263 +#: documentation/content/en/books/handbook/x11/_index.adoc:287 +#: documentation/content/en/books/handbook/x11/_index.adoc:291 #, no-wrap -msgid "link:https://www.nvidia.com/Download/driverResults.aspx/194639/en-us/[supported hardware]" +msgid "`nvidia`" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:264 +#: documentation/content/en/books/handbook/x11/_index.adoc:289 #, no-wrap -msgid "package:x11/nvidia-driver[]" +msgid "link:https://www.nvidia.com/Download/driverResults.aspx/156167/en-us/[supported hardware]" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/x11/_index.adoc:266 +#: documentation/content/en/books/handbook/x11/_index.adoc:290 #, no-wrap -msgid "link:https://www.nvidia.com/Download/driverResults.aspx/210651/en-us/[supported hardware]" +msgid "package:x11/nvidia-driver-304[]" msgstr "" -#. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:271 +#. type: Table +#: documentation/content/en/books/handbook/x11/_index.adoc:293 +#, no-wrap +msgid "link:https://www.nvidia.com/Download/driverResults.aspx/123712/en-us/[supported hardware]" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:297 msgid "" -"Version 304 of the NVIDIA(R) graphics driver (package:x11/nvidia-" -"driver-304[]) does not support xorg-server 1.20 or later." +"The latest NVIDIA(R) Graphics driver can be installed by running the " +"following command:" +msgstr "" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:301 +#, no-wrap +msgid "# pkg install nvidia-drm-kmod\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:274 +#: documentation/content/en/books/handbook/x11/_index.adoc:305 msgid "" -"The latest NVIDIA(R) driver can be installed by running the following " -"command:" +"To enable the driver, add the module to [.filename]#/etc/rc.conf# file, by " +"executing the following command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:278 +#: documentation/content/en/books/handbook/x11/_index.adoc:309 #, no-wrap -msgid "# pkg install nvidia-driver\n" +msgid "# sysrc kld_list+=nvidia-drm\n" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:312 +msgid "" +"This is the direct rendering crossref:glossary[kms-glossary,KMS] driver." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:316 +msgid "" +"Kernel modesetting is the option to set the graphics mode in the kernel. " +"Enable it for subsequent boots with the following man:loader.conf[5] tunable:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:285 +#: documentation/content/en/books/handbook/x11/_index.adoc:320 +#, no-wrap +msgid "hw.nvidiadrm.modeset=\"1\"\n" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:324 +msgid "" +"Both PRIME and crossref:wayland[wayland-synopsis,Wayland] require kernel " +"modesetting." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:328 +msgid "" +"Prior versions of the driver do not support Direct Rendering. Instead use " +"the modesetting module, by executing the following command:" +msgstr "" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:331 #, no-wrap msgid "# sysrc kld_list+=nvidia-modeset\n" msgstr "" -#. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:290 +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:337 msgid "" -"The `nvidia` driver must be used if the packages package:x11/nvidia-" -"driver-304[] or package:x11/nvidia-driver-340[] have been installed." +"If requiring Nvidia drivers prior to 390, note that they do not support " +"kernel modesetting, and thus they must be used with the legacy man:sc[4] " +"console driver, and a package:x11/xorg-server[] version prior to 1.20." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:339 +msgid "Enable them in [.filename]#/etc/rc.conf# with the following command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:294 +#: documentation/content/en/books/handbook/x11/_index.adoc:343 #, no-wrap msgid "# sysrc kld_list+=nvidia\n" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/x11/_index.adoc:298 +#: documentation/content/en/books/handbook/x11/_index.adoc:346 #, no-wrap -msgid "Xorg Configuration" +msgid "X Window System Overview" msgstr "" -#. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:301 -msgid "Xorg supports most common video cards, keyboards, and pointing devices." +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:356 +msgid "" +"The X Window System is the heritage graphical stack for UNIX(R) platforms, " +"supporting the latest technologies while maintaining support for generations " +"of applications. Applications, including the components of the desktop, are " +"hosted by the man:Xorg[1] server. This system is network aware and its " +"various components can interoperate across networks." +msgstr "" + +#. type: Title == +#: documentation/content/en/books/handbook/x11/_index.adoc:358 +#, no-wrap +msgid "Installing The X.org Server" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:306 +#: documentation/content/en/books/handbook/x11/_index.adoc:363 msgid "" -"Video cards, monitors, and input devices are automatically detected and do " -"not require any manual configuration. Do not create [.filename]#xorg.conf# " -"or run a `Xorg -configure` step unless automatic configuration fails." +"_**abstract**: The package:x11/xorg[X.org] server must be installed to host " +"the crossref:desktop[desktop-synopsis,desktop]. Users must be added to the " +"`video` group to use it._" msgstr "" -#. type: Title === -#: documentation/content/en/books/handbook/x11/_index.adoc:309 +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:367 +msgid "" +"Once a graphics driver is installed and enabled, the X.org server can be " +"installed as a meta-package, or compiled locally with the ports tree." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:370 +msgid "" +"The full meta-package can be installed quickly but with fewer options for " +"customization:" +msgstr "" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:374 #, no-wrap -msgid "Configuration Files" +msgid "# pkg install xorg\n" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:381 +msgid "" +"This installation results in the complete X Window System being installed, " +"including a traditional window manager, man:twm[1], and surrounding " +"traditional desktop suite. Most users will want to install and configure a " +"contemporary crossref:desktop[desktop-synopsis,desktop] of their choice." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:385 +msgid "" +"The current user must be a member of the `video` group to run a graphical " +"environment. To add a user to the `video` group, execute the following " +"command:" +msgstr "" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:389 +#, no-wrap +msgid "# pw groupmod video -m username\n" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:394 +msgid "" +"To run the X Window System, use man:startx[1] from package:x11/xinit[], or " +"install and configure a display manager to start a graphical login on boot." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:314 +#: documentation/content/en/books/handbook/x11/_index.adoc:401 +msgid "" +"A smaller version of the X Window System suitable for experienced users is " +"available in package:x11/xorg-minimal[]. Most of the documents, libraries, " +"and applications will not be installed. Some applications require these " +"additional components to function." +msgstr "" + +#. type: Title == +#: documentation/content/en/books/handbook/x11/_index.adoc:404 +#, no-wrap +msgid "X.org Configuration" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:410 msgid "" -"Xorg looks in several directories for configuration files. [.filename]#/usr/" -"local/etc/X11/# is the *recommended* directory for these files on FreeBSD. " -"Using this directory helps keep application files separate from operating " -"system files." +"_**abstract**: If the defaults for the monitor or input devices, are not " +"satisfactory, crossref:desktop[desktop-synopsis,desktops] include GUIs for " +"configuring them, or they can be configured manually._" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:415 +msgid "" +"The X.org server supports most common graphics processors, monitors, and " +"input devices. First, try the defaults. This subsection provides an " +"overview of their configuration." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/x11/_index.adoc:316 +#: documentation/content/en/books/handbook/x11/_index.adoc:417 #, no-wrap -msgid "Single or Multiple Files" +msgid "X.org Configuration Files" msgstr "" -#. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:320 +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:423 +msgid "" +"Historically, the X.org server was configured with files in [.filename]#/usr/" +"local/etc/X11/#. This is still supported for edge cases, but conflicts with " +"dynamic autoconfiguration." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:427 +msgid "" +"Do not create configuration for the X.org server in [.filename]#xorg.conf# " +"or run `Xorg -configure` unless automatic configuration fails." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:433 +msgid "" +"X.org server looks in several directories for configuration files. " +"[.filename]#/usr/local/etc/X11/# is the *recommended* directory for these " +"files on FreeBSD. Using this directory helps keep application files " +"separate from operating system files." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:438 msgid "" "It is easier to use multiple files that each configure a specific setting " "than the traditional single [.filename]#xorg.conf#. These files are stored " "in the [.filename]#/usr/local/etc/X11/xorg.conf.d/# subdirectory." msgstr "" +#. type: Title === +#: documentation/content/en/books/handbook/x11/_index.adoc:440 +#, no-wrap +msgid "Graphics Configuration" +msgstr "" + #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:324 +#: documentation/content/en/books/handbook/x11/_index.adoc:447 msgid "" -"The traditional single [.filename]#xorg.conf# still works, but is neither as " -"clear nor as flexible as multiple files in the [.filename]#/usr/local/etc/" -"X11/xorg.conf.d/# subdirectory." +"Direct rendering provides the ability to seamlessly use a discrete graphics " +"processor (dGPU) alongside an integrated graphics processor (iGPU), called " +"PRIME. The drivers will automatically offload intensive tasks to the dGPU " +"when required, and power it down when able." msgstr "" -#. type: Title === -#: documentation/content/en/books/handbook/x11/_index.adoc:327 -#, no-wrap -msgid "Video Cards" +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:450 +msgid "" +"To launch applications on the more powerful GPU in PRIME, use the " +"`DRI_PRIME=1` environment variable." msgstr "" -#. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:330 +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:454 msgid "" -"The driver for the graphics card can be specified in the [.filename]#/usr/" -"local/etc/X11/xorg.conf.d/# directory." +"If multiple graphics drivers are conflicting, the driver for the graphics " +"processor can be specified in the [.filename]#/usr/local/etc/X11/xorg.conf.d/" +"# directory." msgstr "" -#. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:332 +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:456 msgid "To configure the Intel(R) driver in a configuration file:" msgstr "" #. type: Block title -#: documentation/content/en/books/handbook/x11/_index.adoc:334 +#: documentation/content/en/books/handbook/x11/_index.adoc:458 #, no-wrap -msgid "Select Intel(R) Video Driver in a File" +msgid "Select Intel(R) Graphics Driver in a File" msgstr "" -#. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:338 +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:462 msgid "[.filename]#/usr/local/etc/X11/xorg.conf.d/20-intel.conf#" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:345 +#: documentation/content/en/books/handbook/x11/_index.adoc:469 #, no-wrap msgid "" "Section \"Device\"\n" @@ -693,23 +896,23 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:349 +#: documentation/content/en/books/handbook/x11/_index.adoc:473 msgid "To configure the AMD(R) driver in a configuration file:" msgstr "" #. type: Block title -#: documentation/content/en/books/handbook/x11/_index.adoc:351 +#: documentation/content/en/books/handbook/x11/_index.adoc:475 #, no-wrap -msgid "Select AMD(R) Video Driver in a File" +msgid "Select AMD(R) Graphics Driver in a File" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:355 +#: documentation/content/en/books/handbook/x11/_index.adoc:479 msgid "[.filename]#/usr/local/etc/X11/xorg.conf.d/20-radeon.conf#" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:362 +#: documentation/content/en/books/handbook/x11/_index.adoc:486 #, no-wrap msgid "" "Section \"Device\"\n" @@ -719,137 +922,131 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:366 +#: documentation/content/en/books/handbook/x11/_index.adoc:490 msgid "To configure the NVIDIA(R) driver in a configuration file:" msgstr "" #. type: Block title -#: documentation/content/en/books/handbook/x11/_index.adoc:368 +#: documentation/content/en/books/handbook/x11/_index.adoc:492 #, no-wrap -msgid "Select NVIDIA(R) Video Driver in a File" +msgid "Select NVIDIA(R) Graphics Driver in a File" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:372 +#: documentation/content/en/books/handbook/x11/_index.adoc:496 msgid "[.filename]#/usr/local/etc/X11/xorg.conf.d/20-nvidia.conf#" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:379 +#: documentation/content/en/books/handbook/x11/_index.adoc:503 #, no-wrap msgid "" "Section \"Device\"\n" "\tIdentifier \"Card0\"\n" -"\tDriver \"nvidia\"\n" +"\tDriver \"nvidia-modeset\"\n" "EndSection\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:385 +#: documentation/content/en/books/handbook/x11/_index.adoc:510 msgid "" "package:x11/nvidia-xconfig[] can also be used to perform basic control over " "configuration options available in the NVIDIA driver." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:388 -msgid "To configure the VESA driver in a configuration file:" +#: documentation/content/en/books/handbook/x11/_index.adoc:513 +msgid "To configure the SCFB driver in a configuration file:" msgstr "" #. type: Block title -#: documentation/content/en/books/handbook/x11/_index.adoc:390 +#: documentation/content/en/books/handbook/x11/_index.adoc:515 #, no-wrap -msgid "Select VESA Video Driver in a File" +msgid "Select SCFB Graphics Driver in a File" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:394 -msgid "[.filename]#/usr/local/etc/X11/xorg.conf.d/20-vesa.conf#" +#: documentation/content/en/books/handbook/x11/_index.adoc:519 +msgid "[.filename]#/usr/local/etc/X11/xorg.conf.d/20-scfb.conf#" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:401 +#: documentation/content/en/books/handbook/x11/_index.adoc:526 #, no-wrap msgid "" "Section \"Device\"\n" "\tIdentifier \"Card0\"\n" -"\tDriver \"vesa\"\n" +"\tDriver \"scfb\"\n" "EndSection\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:405 -msgid "To configure the SCFB driver in a configuration file:" +#: documentation/content/en/books/handbook/x11/_index.adoc:530 +msgid "To configure the VESA driver in a configuration file:" msgstr "" #. type: Block title -#: documentation/content/en/books/handbook/x11/_index.adoc:407 +#: documentation/content/en/books/handbook/x11/_index.adoc:532 #, no-wrap -msgid "Select SCFB Video Driver in a File" +msgid "Select VESA Graphics Driver in a File" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:411 -msgid "[.filename]#/usr/local/etc/X11/xorg.conf.d/20-scfb.conf#" +#: documentation/content/en/books/handbook/x11/_index.adoc:536 +msgid "[.filename]#/usr/local/etc/X11/xorg.conf.d/20-vesa.conf#" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:418 +#: documentation/content/en/books/handbook/x11/_index.adoc:543 #, no-wrap msgid "" "Section \"Device\"\n" "\tIdentifier \"Card0\"\n" -"\tDriver \"scfb\"\n" +"\tDriver \"vesa\"\n" "EndSection\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:423 +#: documentation/content/en/books/handbook/x11/_index.adoc:548 msgid "" -"To configure multiple video cards, the `BusID` can be added. A list of " -"video card bus ``ID``s can be displayed by executing:" -msgstr "" - -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:427 -#, no-wrap -msgid "% pciconf -lv | grep -B3 display\n" +"To configure multiple graphics processors, the `BusID` can be added. A list " +"of graphics processor bus ``ID``s can be displayed by executing:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:437 +#: documentation/content/en/books/handbook/x11/_index.adoc:562 #, no-wrap msgid "" -"vgapci0@pci0:0:2:0: class=0x030000 rev=0x07 hdr=0x00 vendor=0x8086 device=0x2a42 subvendor=0x17aa subdevice=0x20e4\n" +"vgapci0@pci0:0:2:0: class=0x030000 rev=0x0c hdr=0x00 vendor=0x8086 device=0x46a6 subvendor=0x1028 subdevice=0x0b29\n" " vendor = 'Intel Corporation'\n" -" device = 'Mobile 4 Series Chipset Integrated Graphics Controller'\n" +" device = 'Alder Lake-P GT2 [Iris Xe Graphics]'\n" " class = display\n" "--\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:442 +#: documentation/content/en/books/handbook/x11/_index.adoc:567 #, no-wrap msgid "" -"vgapci1@pci0:0:2:1: class=0x038000 rev=0x07 hdr=0x00 vendor=0x8086 device=0x2a43 subvendor=0x17aa subdevice=0x20e4\n" -" vendor = 'Intel Corporation'\n" -" device = 'Mobile 4 Series Chipset Integrated Graphics Controller'\n" +"vgapci0@pci0:1:0:0: class=0x030200 rev=0xa1 hdr=0x00 vendor=0x10de device=0x25b9 subvendor=0x1028 subdevice=0x0b29\n" +" vendor = 'NVIDIA Corporation'\n" +" device = 'GA107GLM [RTX A1000 Laptop GPU]'\n" " class = display\n" msgstr "" #. type: Block title -#: documentation/content/en/books/handbook/x11/_index.adoc:445 +#: documentation/content/en/books/handbook/x11/_index.adoc:570 #, no-wrap -msgid "Select Intel(R) Video Driver and NVIDIA(R) Video Driver in a File" +msgid "Select Intel(R) Graphics Driver and NVIDIA(R) Graphics Driver in a File" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:450 +#: documentation/content/en/books/handbook/x11/_index.adoc:575 msgid "[.filename]#/usr/local/etc/X11/xorg.conf.d/20-drivers.conf#" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:458 +#: documentation/content/en/books/handbook/x11/_index.adoc:583 #, no-wrap msgid "" "Section \"Device\"\n" @@ -860,60 +1057,60 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:464 +#: documentation/content/en/books/handbook/x11/_index.adoc:589 #, no-wrap msgid "" "Section \"Device\"\n" -"\tIdentifier \"Card0\"\n" -"\tDriver \"nvidia\"\n" +"\tIdentifier \"Card1\"\n" +"\tDriver \"nvidia-modeset\"\n" "\tBusID \"pci0:0:2:1\"\n" "EndSection\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/x11/_index.adoc:468 +#: documentation/content/en/books/handbook/x11/_index.adoc:593 #, no-wrap -msgid "Monitors" +msgid "Monitor Configuration" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:473 +#: documentation/content/en/books/handbook/x11/_index.adoc:601 msgid "" "Almost all monitors support the Extended Display Identification Data " -"standard (`EDID`). Xorg uses `EDID` to communicate with the monitor and " +"standard (`EDID`). X.org uses `EDID` to communicate with the monitor and " "detect the supported resolutions and refresh rates. Then it selects the " "most appropriate combination of settings to use with that monitor." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:475 +#: documentation/content/en/books/handbook/x11/_index.adoc:605 msgid "" -"Other resolutions supported by the monitor can be chosen by setting the " -"desired resolution in configuration files, or after the X server has been " -"started with man:xrandr[1]." +"Other resolutions supported by the monitor can be selected atomically after " +"the X server has been started with man:xrandr[1], or in the X.org server " +"configuration files." msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/x11/_index.adoc:477 +#: documentation/content/en/books/handbook/x11/_index.adoc:607 #, no-wrap msgid "Using RandR (Resize and Rotate)" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:480 +#: documentation/content/en/books/handbook/x11/_index.adoc:611 msgid "" -"Run man:xrandr[1] without any parameters to see a list of video outputs and " -"detected monitor modes:" +"Run man:xrandr[1] in an X session without any parameters to see a list of " +"video outputs and detected monitor modes:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:484 +#: documentation/content/en/books/handbook/x11/_index.adoc:615 #, no-wrap msgid "% xrandr\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:518 +#: documentation/content/en/books/handbook/x11/_index.adoc:649 #, no-wrap msgid "" "Screen 0: minimum 320 x 200, current 2560 x 960, maximum 8192 x 8192\n" @@ -947,57 +1144,64 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:523 +#: documentation/content/en/books/handbook/x11/_index.adoc:657 msgid "" "This shows that the `VGA-1` output is being used to display a screen " "resolution of 1280x960 pixels at a refresh rate of about 60 Hz. The " "`LVDS-1` is being used as a secondary monitor to display a screen resolution " "of 1280x800 pixels at a refresh rate of about 60 Hz. Monitors are not " -"attached to the `HDMI-1`, `HDMI-2`, `DP-1`, `DP-2` and `DP-3` connectors." +"attached to the `HDMI-1`, `HDMI-2`, `DP-1`, `DP-2`, and `DP-3` connectors." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:526 +#: documentation/content/en/books/handbook/x11/_index.adoc:660 msgid "" "Any of the other display modes can be selected with man:xrandr[1]. For " "example, to switch to 1280x1024 at 60 Hz:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:530 +#: documentation/content/en/books/handbook/x11/_index.adoc:664 #, no-wrap msgid "% xrandr --output LVDS-1 --mode 1280x720 --rate 60\n" msgstr "" +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:670 +msgid "" +"Oftentimes, a black screen upon starting X can be fixed by adding an `xrandr " +"--auto` step to the initialization process." +msgstr "" + #. type: Title ==== -#: documentation/content/en/books/handbook/x11/_index.adoc:533 +#: documentation/content/en/books/handbook/x11/_index.adoc:673 #, no-wrap -msgid "Using the Xorg configuration file" +msgid "Using the X.org Configuration Files" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:536 +#: documentation/content/en/books/handbook/x11/_index.adoc:676 msgid "The monitor configuration can also be set in a configuration file." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:538 +#: documentation/content/en/books/handbook/x11/_index.adoc:678 msgid "To set a screen resolution of 1024x768 in a configuration file:" msgstr "" #. type: Block title -#: documentation/content/en/books/handbook/x11/_index.adoc:539 +#: documentation/content/en/books/handbook/x11/_index.adoc:679 #, no-wrap msgid "Set Screen Resolution in a File" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:543 +#: documentation/content/en/books/handbook/x11/_index.adoc:683 msgid "[.filename]#/usr/local/etc/X11/xorg.conf.d/10-monitor.conf#" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:553 +#: documentation/content/en/books/handbook/x11/_index.adoc:693 #, no-wrap msgid "" "Section \"Screen\"\n" @@ -1010,43 +1214,141 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/x11/_index.adoc:557 +#: documentation/content/en/books/handbook/x11/_index.adoc:697 +#, no-wrap +msgid "Input Configuration" +msgstr "" + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:703 +msgid "" +"The package:Xorg[X.org] server provides the package:x11/libinput[] library, " +"a cross-platform effort to support all touch, pointing, and keyboard devices " +"under a unified library. Unless specified otherwise, this is loaded " +"automatically." +msgstr "" + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:708 +msgid "" +"Individual device settings for man:libinput[4] can be tuned in the " +"crossref:desktop[desktop-synopsis,desktop's] GUI, or manually with " +"package:x11/xinput[xinput] and package:x11/setxkbmap[setxkbmap]." +msgstr "" + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:714 +msgid "" +"Alternatively, there are older, lightweight, individual drivers for specific " +"input devices available in the package:x11-drivers[] category named x11/xf86-" +"input-[foo]. This approach requires manual configuration of the X.org " +"server. Both are described in this subsection." +msgstr "" + +#. type: Title ==== +#: documentation/content/en/books/handbook/x11/_index.adoc:716 #, no-wrap -msgid "Input Devices" +msgid "Using Atomic Input Configuration" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:560 +#: documentation/content/en/books/handbook/x11/_index.adoc:723 +msgid "" +"Devices supported by man:libinput[4] can be configured with graphical " +"utilities included with the crossref:desktop[desktop-synopsis,desktop] of " +"choice, or manually and atomically at runtime with package:x11/xinput[] and " +"package:x11/setxkbmap[]." +msgstr "" + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:726 +msgid "" +"To ask man:libinput[4] what devices it's currently attached to, run " +"man:xinput[1] with no arguments:" +msgstr "" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:730 +#, no-wrap +msgid "$ xinput\n" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:733 +msgid "Its output should be similar to the following:" +msgstr "" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:748 +#, no-wrap +msgid "" +"⎡ Virtual core pointer \tid=2\t[master pointer (3)]\n" +"⎜ ↳ Virtual core XTEST pointer \tid=4\t[slave pointer (2)]\n" +"⎜ ↳ System mouse \tid=7\t[slave pointer (2)]\n" +"⎜ ↳ VEN_0488:00 0488:1031 Mouse \tid=11\t[slave pointer (2)]\n" +"⎜ ↳ VEN_0488:00 0488:1031 TouchPad \tid=12\t[slave pointer (2)]\n" +"⎣ Virtual core keyboard \tid=3\t[master keyboard (2)]\n" +" ↳ Virtual core XTEST keyboard \tid=5\t[slave keyboard (3)]\n" +" ↳ System keyboard multiplexer \tid=6\t[slave keyboard (3)]\n" +" ↳ Power Button \tid=8\t[slave keyboard (3)]\n" +" ↳ Sleep Button \tid=9\t[slave keyboard (3)]\n" +" ↳ AT keyboard \tid=10\t[slave keyboard (3)]\n" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:753 msgid "" -"Xorg supports the vast majority of input devices via package:x11/libinput[]." +"All settings supported by these devices are provided as properties, which " +"can be listed and set atomically. Pointing devices have many configurable " +"properties, keyboards usually need none." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:565 +#: documentation/content/en/books/handbook/x11/_index.adoc:755 +msgid "To customize the keyboard, take a look at man:setxkbmap[1]." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:758 msgid "" -"Some desktop environments (such as KDE Plasma) provide a graphical UI for " -"setting these parameters. Check if this is the case before resorting to " -"manual configuration editing." +"Once satisfied with the configuration, simply add the lines to the X " +"initialization script such as [.filename]#~/.Xsession# or " +"[.filename]#~/.xinitrc#." +msgstr "" + +#. type: Title ==== +#: documentation/content/en/books/handbook/x11/_index.adoc:760 +#, no-wrap +msgid "Using X.org Configuration Files" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:569 -msgid "For example, to configure the keyboard layout:" +#: documentation/content/en/books/handbook/x11/_index.adoc:767 +msgid "" +"Some desktop environments (such as crossref:desktop[kde-environment,KDE " +"Plasma]) provide a graphical UI for setting these parameters. Check if this " +"is the case before resorting to manual configuration editing." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:771 +msgid "" +"For example, to manually configure the X.org server for the keyboard layout:" msgstr "" #. type: Block title -#: documentation/content/en/books/handbook/x11/_index.adoc:570 +#: documentation/content/en/books/handbook/x11/_index.adoc:772 #, no-wrap msgid "Setting a Keyboard Layout" msgstr "" -#. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:574 +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:776 msgid "[.filename]#/usr/local/etc/X11/xorg.conf.d/00-keyboard.conf#" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:585 +#: documentation/content/en/books/handbook/x11/_index.adoc:787 #, no-wrap msgid "" "Section \"InputClass\"\n" @@ -1060,105 +1362,104 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/x11/_index.adoc:589 +#: documentation/content/en/books/handbook/x11/_index.adoc:791 #, no-wrap -msgid "Using Fonts in Xorg" +msgid "Using Fonts in the X Window System" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:594 +#: documentation/content/en/books/handbook/x11/_index.adoc:797 msgid "" -"The default fonts that ship with Xorg are less than ideal for typical " -"desktop publishing applications. Large presentation fonts show up jagged " -"and unprofessional looking, and small fonts are almost completely " -"unintelligible. However, there are several free, high quality Type1 " -"(PostScript(R)) fonts available which can be readily used with Xorg." +"_**abstract**: Additional fonts can be installed from the package:x11-" +"fonts[] category or placed in [.filename]#~/.fonts#. They are available " +"immediately to modern applications. Configuration for older applications is " +"available and described as well._" msgstr "" -#. type: Title === -#: documentation/content/en/books/handbook/x11/_index.adoc:596 -#, no-wrap -msgid "Type1 Fonts" +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:802 +msgid "" +"The X Window System provides the X FreeType interface library (man:Xft[3]) " +"to render vector or outline fonts, as well as the traditional X Logical Font " +"Description system maintaining compatibility with generations of " +"applications and fonts." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:602 -msgid "" -"The URW font collection (package:x11-fonts/urwfonts[]) includes high quality " -"versions of standard type1 fonts (Times Roman(TM), Helvetica(TM), " -"Palatino(TM) and others). The Freefonts collection (package:x11-fonts/" -"freefonts[]) includes many more fonts, but most of them are intended for use " -"in graphics software such as the Gimp, and are not complete enough to serve " -"as screen fonts. In addition, Xorg can be configured to use TrueType(R) " -"fonts with a minimum of effort. For more details on this, see the man:X[7] " -"manual page or crossref:x11[truetype, TrueType(R) Fonts]." +#: documentation/content/en/books/handbook/x11/_index.adoc:804 +msgid "There are primarily two types of fonts users will be interested in:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:604 -msgid "" -"To install the above Type1 font collections from binary packages, run the " -"following commands:" +#: documentation/content/en/books/handbook/x11/_index.adoc:806 +msgid "OpenType fonts or TrueType(R) fonts are for displaying on a screen." msgstr "" -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:608 -#, no-wrap -msgid "# pkg install urwfonts\n" +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:807 +msgid "Adobe(R) PostScript(R) Type 1 fonts are for printing to paper." msgstr "" -#. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:612 +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:809 +msgid "These are both vector or outline fonts, there are also bitmap fonts." +msgstr "" + +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:813 msgid "" -"And likewise with the freefont or other collections. To have the X server " -"detect these fonts, add an appropriate line to the X server configuration " -"file ([.filename]#/usr/local/etc/X11/xorg.conf.d/90-fonts.conf#), which " -"reads:" +"The FreeBSD Ports Collection includes a wide and growing catalog of free, " +"high quality fonts available for installation in the package:x11-fonts[] " +"category." msgstr "" -#. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:618 -#, no-wrap +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:818 msgid "" -"Section \"Files\"\n" -" FontPath \"/usr/local/share/fonts/urwfonts/\"\n" -"EndSection\n" +"System-wide font packages installed from the ports collection live in " +"`[.filename]#/usr/local/share/fonts/#`. Fonts for a single user can be " +"placed in `[.filename]#~/.fonts/#`, or `[.filename]#~/.local/share/fonts/#`." msgstr "" -#. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:621 -msgid "Alternatively, at the command line in the X session run:" +#. type: delimited block = 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:822 +msgid "" +"Fonts in either directory or subdirectories will be available for immediate " +"use when the font information cache is rebuilt. To trigger this manually, " +"issue:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:626 +#: documentation/content/en/books/handbook/x11/_index.adoc:826 #, no-wrap +msgid "% fc-cache\n" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:832 msgid "" -"% xset fp+ /usr/local/share/fonts/urwfonts\n" -"% xset fp rehash\n" +"Plenty of free, high quality fonts of both types are available in the ports " +"tree which can be readily used with X Window System. This chapter provides " +"a brief overview of both, as well as configuring the X FreeType interface." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:631 +#: documentation/content/en/books/handbook/x11/_index.adoc:835 msgid "" -"This will work but will be lost when the X session is closed, unless it is " -"added to the startup file ([.filename]#~/.xinitrc# for a normal `startx` " -"session, or [.filename]#~/.xsession# when logging in through a graphical " -"login manager like XDM). A third way is to use the new [.filename]#/usr/" -"local/etc/fonts/local.conf# as demonstrated in crossref:x11[antialias, Anti-" -"Aliased Fonts]." +"For more information about how to install and configure fonts on FreeBSD, " +"please read the article link:{fonts}[Fonts and FreeBSD]." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/x11/_index.adoc:633 +#: documentation/content/en/books/handbook/x11/_index.adoc:837 #, no-wrap msgid "TrueType(R) Fonts" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:639 +#: documentation/content/en/books/handbook/x11/_index.adoc:843 msgid "" -"Xorg has built in support for rendering TrueType(R) fonts. There are two " +"X.org has built in support for rendering TrueType(R) fonts. There are two " "different modules that can enable this functionality. The freetype module " "is used in this example because it is more consistent with the other font " "rendering back-ends. To enable the freetype module just add the following " @@ -1167,37 +1468,37 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:643 +#: documentation/content/en/books/handbook/x11/_index.adoc:847 #, no-wrap msgid "Load \"freetype\"\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:649 +#: documentation/content/en/books/handbook/x11/_index.adoc:853 msgid "" "Now make a directory for the TrueType(R) fonts (for example, [.filename]#/" "usr/local/share/fonts/TrueType#) and copy all of the TrueType(R) fonts into " "this directory. Keep in mind that TrueType(R) fonts cannot be directly " "taken from an Apple(R) Mac(R); they must be in UNIX(R)/MS-DOS(R)/Windows(R) " -"format for use by Xorg. Once the files have been copied into this " +"format for use by X.org. Once the files have been copied into this " "directory, use mkfontscale to create a [.filename]#fonts.dir#, so that the X " "font renderer knows that these new files have been installed. `mkfontscale` " "can be installed as a package:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:653 +#: documentation/content/en/books/handbook/x11/_index.adoc:857 #, no-wrap msgid "# pkg install mkfontscale\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:656 +#: documentation/content/en/books/handbook/x11/_index.adoc:860 msgid "Then create an index of X font files in a directory:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:661 +#: documentation/content/en/books/handbook/x11/_index.adoc:865 #, no-wrap msgid "" "# cd /usr/local/share/fonts/TrueType\n" @@ -1205,14 +1506,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:665 +#: documentation/content/en/books/handbook/x11/_index.adoc:869 msgid "" "Now add the TrueType(R) directory to the font path. This is just the same " -"as described in crossref:x11[type1, Type1 Fonts]:" +"as described in <<type1>>:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:670 +#: documentation/content/en/books/handbook/x11/_index.adoc:874 #, no-wrap msgid "" "% xset fp+ /usr/local/share/fonts/TrueType\n" @@ -1220,12 +1521,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:673 +#: documentation/content/en/books/handbook/x11/_index.adoc:877 msgid "or add a `FontPath` line to [.filename]#xorg.conf#." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:676 +#: documentation/content/en/books/handbook/x11/_index.adoc:880 msgid "" "Now Gimp, LibreOffice, and all of the other X applications should now " "recognize the installed TrueType(R) fonts. Extremely small fonts (as with " @@ -1234,22 +1535,93 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/x11/_index.adoc:678 +#: documentation/content/en/books/handbook/x11/_index.adoc:882 +#, no-wrap +msgid "Type1 Fonts" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:886 +msgid "" +"The URW font collection (package:x11-fonts/urwfonts[]) includes high quality " +"versions of standard type1 fonts (Times Roman(TM), Helvetica(TM), " +"Palatino(TM) and others). The Freefonts collection (package:x11-fonts/" +"freefonts[]) includes many more fonts, but most of them are intended for use " +"in graphics software such as the Gimp, and are not complete enough to serve " +"as screen fonts." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:888 +msgid "" +"To install the above Type1 font collections from binary packages, run the " +"following commands:" +msgstr "" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:892 +#, no-wrap +msgid "# pkg install urwfonts\n" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:896 +msgid "" +"And likewise with the freefont or other collections. To have a manually " +"configured X server detect these fonts, add an appropriate line to the X " +"server configuration file ([.filename]#/usr/local/etc/X11/xorg.conf.d/90-" +"fonts.conf#), which reads:" +msgstr "" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:902 +#, no-wrap +msgid "" +"Section \"Files\"\n" +" FontPath \"/usr/local/share/fonts/urwfonts/\"\n" +"EndSection\n" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:905 +msgid "Alternatively, at the command line in the X session run:" +msgstr "" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/x11/_index.adoc:910 +#, no-wrap +msgid "" +"% xset fp+ /usr/local/share/fonts/urwfonts\n" +"% xset fp rehash\n" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/x11/_index.adoc:914 +msgid "" +"This will work but will be lost when the X session is closed, unless it is " +"added to the startup file ([.filename]#~/.xinitrc# for a normal `startx` " +"session, or [.filename]#~/.xsession# when logging in through a graphical " +"login manager like XDM). A third way is to use the new [.filename]#/usr/" +"local/etc/fonts/local.conf# as demonstrated in <<antialias>>." +msgstr "" + +#. type: Title === +#: documentation/content/en/books/handbook/x11/_index.adoc:916 #, no-wrap msgid "Anti-Aliased Fonts" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:681 +#: documentation/content/en/books/handbook/x11/_index.adoc:920 msgid "" -"All fonts in Xorg that are found in [.filename]#/usr/local/share/fonts/# and " -"[.filename]#~/.fonts/# are automatically made available for anti-aliasing to " -"Xft-aware applications. Most recent applications are Xft-aware, including " -"KDE, GNOME, and Firefox." +"All fonts in X.org that are found in [.filename]#/usr/local/share/fonts/# " +"and [.filename]#~/.fonts/# are automatically made available for anti-" +"aliasing to Xft-aware applications. Most recent applications are Xft-aware, " +"including KDE, GNOME, and Firefox." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:685 +#: documentation/content/en/books/handbook/x11/_index.adoc:924 msgid "" "To control which fonts are anti-aliased, or to configure anti-aliasing " "properties, create (or edit, if it already exists) the file [.filename]#/usr/" @@ -1259,7 +1631,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:689 +#: documentation/content/en/books/handbook/x11/_index.adoc:928 msgid "" "This file must be in XML format. Pay careful attention to case, and make " "sure all tags are properly closed. The file begins with the usual XML " @@ -1267,7 +1639,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:695 +#: documentation/content/en/books/handbook/x11/_index.adoc:934 #, no-wrap msgid "" "<?xml version=\"1.0\"?>\n" @@ -1276,7 +1648,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:699 +#: documentation/content/en/books/handbook/x11/_index.adoc:938 msgid "" "As previously stated, all fonts in [.filename]#/usr/local/share/fonts/# as " "well as [.filename]#~/.fonts/# are already made available to Xft-aware " @@ -1285,26 +1657,26 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:703 +#: documentation/content/en/books/handbook/x11/_index.adoc:942 #, no-wrap msgid "<dir>/path/to/my/fonts</dir>\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:706 +#: documentation/content/en/books/handbook/x11/_index.adoc:945 msgid "" "After adding new fonts, and especially new font directories, rebuild the " "font caches:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:710 +#: documentation/content/en/books/handbook/x11/_index.adoc:949 #, no-wrap msgid "# fc-cache -f\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:714 +#: documentation/content/en/books/handbook/x11/_index.adoc:953 msgid "" "Anti-aliasing makes borders slightly fuzzy, which makes very small text more " "readable and removes \"staircases\" from large text, but can cause eyestrain " @@ -1313,7 +1685,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:733 +#: documentation/content/en/books/handbook/x11/_index.adoc:972 #, no-wrap msgid "" "\t<match target=\"font\">\n" @@ -1335,7 +1707,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:739 +#: documentation/content/en/books/handbook/x11/_index.adoc:978 msgid "" "Spacing for some monospaced fonts might also be inappropriate with anti-" "aliasing. This seems to be an issue with KDE, in particular. One possible " @@ -1343,7 +1715,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:758 +#: documentation/content/en/books/handbook/x11/_index.adoc:997 #, no-wrap msgid "" "\t<match target=\"pattern\" name=\"family\">\n" @@ -1365,14 +1737,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:761 +#: documentation/content/en/books/handbook/x11/_index.adoc:1000 msgid "" "(this aliases the other common names for fixed fonts as `\"mono\"`), and " "then add:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:772 +#: documentation/content/en/books/handbook/x11/_index.adoc:1011 #, no-wrap msgid "" "\t<match target=\"pattern\" name=\"family\">\n" @@ -1386,7 +1758,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:778 +#: documentation/content/en/books/handbook/x11/_index.adoc:1017 msgid "" "Certain fonts, such as Helvetica, may have a problem when anti-aliased. " "Usually this manifests itself as a font that seems cut in half vertically. " @@ -1395,7 +1767,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:789 +#: documentation/content/en/books/handbook/x11/_index.adoc:1028 #, no-wrap msgid "" "\t<match target=\"pattern\" name=\"family\">\n" @@ -1409,14 +1781,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:793 +#: documentation/content/en/books/handbook/x11/_index.adoc:1032 msgid "" "After editing [.filename]#local.conf#, make certain to end the file with the " "`</fontconfig>` tag. Not doing this will cause changes to be ignored." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:796 +#: documentation/content/en/books/handbook/x11/_index.adoc:1035 msgid "" "Users can add personalized settings by creating their own " "[.filename]#~/.config/fontconfig/fonts.conf#. This file uses the same `XML` " @@ -1424,7 +1796,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:800 +#: documentation/content/en/books/handbook/x11/_index.adoc:1039 msgid "" "One last point: with an LCD screen, sub-pixel sampling may be desired. This " "basically treats the (horizontally separated) red, green and blue components " @@ -1433,7 +1805,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:811 +#: documentation/content/en/books/handbook/x11/_index.adoc:1050 #, no-wrap msgid "" "\t <match target=\"font\">\n" @@ -1447,15 +1819,8 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/x11/_index.adoc:816 +#: documentation/content/en/books/handbook/x11/_index.adoc:1055 msgid "" "Depending on the sort of display, `rgb` may need to be changed to `bgr`, " "`vrgb` or `vbgr`: experiment and see which works best." msgstr "" - -#. type: Plain text -#: documentation/content/en/books/handbook/x11/_index.adoc:818 -msgid "" -"For more information about how to install and configure fonts on FreeBSD, " -"please read the article link:{fonts}[Fonts and FreeBSD]." -msgstr "" |