Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 13 Feb 2023 22:40:02 GMT
From:      Ceri Davies <ceri@FreeBSD.org>
To:        doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org
Subject:   git: 2ddb6c9f38 - main - handbook: general linting on new X content
Message-ID:  <202302132240.31DMe2nH088187@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
The branch main has been updated by ceri:

URL: https://cgit.FreeBSD.org/doc/commit/?id=2ddb6c9f38dfb4d6935792d9a0161c2ea5a77334

commit 2ddb6c9f38dfb4d6935792d9a0161c2ea5a77334
Author:     Ceri Davies <ceri@FreeBSD.org>
AuthorDate: 2023-02-13 22:39:43 +0000
Commit:     Ceri Davies <ceri@FreeBSD.org>
CommitDate: 2023-02-13 22:39:43 +0000

    handbook: general linting on new X content
---
 .../content/en/books/handbook/desktop/_index.adoc  | 138 ++++++++++-----------
 .../content/en/books/handbook/x11/_index.adoc      |  34 ++---
 2 files changed, 86 insertions(+), 86 deletions(-)

diff --git a/documentation/content/en/books/handbook/desktop/_index.adoc b/documentation/content/en/books/handbook/desktop/_index.adoc
index 9f44263803..f2b114d4c6 100644
--- a/documentation/content/en/books/handbook/desktop/_index.adoc
+++ b/documentation/content/en/books/handbook/desktop/_index.adoc
@@ -54,11 +54,11 @@ endif::[]
 
 While FreeBSD is popular as a server for its performance and stability, it is also well suited for day-to-day use as a desktop.
 With over {numports} applications available in the FreeBSD ports tree, it is straightforward to build a customized desktop that can run a wide variety of desktop applications.
-This chapter demonstrates how to install popular desktop environments as well as desktop application such as web browsers, productivity software, document viewers, and financial software.
+This chapter demonstrates how to install popular desktop environments as well as desktop applications such as web browsers, productivity software, document viewers, and financial software.
 
 Prerequisites:
 
-* Readers of this chapter should already understand how to either install either the crossref:x11[x11,X Window System] or crossref:wayland[wayland,Wayland] on FreeBSD.
+* Readers of this chapter should already understand how to install either the crossref:x11[x11,X Window System] or crossref:wayland[wayland,Wayland] on FreeBSD.
 * Readers are instructed throughout this chapter to install official packages. Refer to the section on crossref:ports[ports-using,using the ports collection] to build customized packages from ports.
 
 [[desktop-environments]]
@@ -128,7 +128,7 @@ To install a minimal KDE Plasma execute:
 
 [TIP]
 ====
-This is installation is *really* minimal.
+This installation is *really* minimal.
 Konsole must be installed separately executing:
 
 [source,shell]
@@ -150,7 +150,7 @@ proc                    /proc           procfs  rw              0       0
 ....
 
 KDE Plasma uses man:dbus-daemon[1] for a message bus and hardware abstraction.
-This application is automatically installed as dependencies of KDE Plasma.
+This application is automatically installed as a dependency of KDE Plasma.
 
 Enable D-BUS service in `/etc/rc.conf` to start at system boot:
 
@@ -170,8 +170,8 @@ sysctl net.local.stream.sendspace=65536
 [[kde-start]]
 ==== Start KDE Plasma
 
-Preferred KDE Plasma display manager is package:x11/sddm[].
-To install package:x11/sddm[] execute:
+The preferred KDE Plasma display manager is package:x11/sddm[].
+To install package:x11/sddm[], execute:
 
 [source,shell]
 ....
@@ -185,7 +185,7 @@ Enable SDDM service in `/etc/rc.conf` to start at system boot:
 # sysrc sddm_enable="YES"
 ....
 
-The keyboard language can be set in SDDM by running the following command:
+The keyboard language can be set in SDDM by running the following command (for Spanish, for example):
 
 [source,shell]
 ....
@@ -208,7 +208,7 @@ GNOME is a user-friendly desktop environment. It includes a panel for starting a
 [[gnome-meta-install]]
 ==== Install GNOME meta pacakge
 
-To install the GNOME meta pacakge with GNOME Desktop and Applications execute:
+To install the GNOME meta package with GNOME Desktop and Applications, execute:
 
 [source,shell]
 ....
@@ -218,7 +218,7 @@ To install the GNOME meta pacakge with GNOME Desktop and Applications execute:
 [[gnome-minimal-install]]
 ==== Minimal GNOME installation
 
-To install the GNOME lite meta package with GNOME desktop slimmed down for only the basics execute:
+To install the GNOME-lite meta package with a GNOME desktop slimmed down for only the basics, execute:
 
 [source,shell]
 ....
@@ -238,7 +238,7 @@ proc                    /proc           procfs  rw              0       0
 ....
 
 GNOME uses man:dbus-daemon[1] for a message bus and hardware abstraction.
-This application is automatically installed as dependencies of GNOME.
+This application is automatically installed as a dependency of GNOME.
 
 Enable D-BUS service in `/etc/rc.conf` to start at system boot:
 
@@ -270,7 +270,7 @@ Enable GDM in `/etc/rc.conf` to start at system boot:
 ....
 
 A second method to start GNOME is by manually invoking man:startx[1].
-For this to work, the following line is needed in ~/.xinitrc:
+For this to work, the following line is needed in `~/.xinitrc`:
 
 [source,shell]
 ....
@@ -287,7 +287,7 @@ Since it is fast, light, and efficient, it is ideal for older or slower machines
 [[xfce-install]]
 ==== Install XFCE
 
-To install the XFCE meta package execute:
+To install the XFCE meta package, execute:
 
 [source,shell]
 ....
@@ -307,7 +307,7 @@ proc                    /proc           procfs  rw              0       0
 ....
 
 XFCE uses man:dbus-daemon[1] for a message bus and hardware abstraction.
-This application is automatically installed as dependencies of XFCE.
+This application is automatically installed as a dependency of XFCE.
 
 Enable D-BUS in `/etc/rc.conf` to start at system boot:
 
@@ -321,7 +321,7 @@ Enable D-BUS in `/etc/rc.conf` to start at system boot:
 
 package:x11/lightdm[] is a display manager that supports different display technologies and is a good choice as it is very lightweight, requires little memory usage, and has fast performance.
 
-To install it execute:
+To install it, execute:
 
 [source,shell]
 ....
@@ -336,7 +336,7 @@ Enable lightdm in `/etc/rc.conf` to start at system boot:
 ....
 
 A second method to start XFCE is by manually invoking man:startx[1].
-For this to work, the following line is needed in ~/.xinitrc:
+For this to work, the following line is needed in `~/.xinitrc`:
 
 [source,shell]
 ....
@@ -347,12 +347,13 @@ For this to work, the following line is needed in ~/.xinitrc:
 === MATE
 
 The MATE Desktop Environment is the continuation of GNOME 2.
+// What does "traditional metaphors" mean?
 It provides an intuitive and attractive desktop environment using traditional metaphors.
 
 [[mate-meta-install]]
 ==== Install MATE meta package
 
-To install the MATE meta package with MATE Desktop with some extra applications such as text editor, archiver manager, etc. execute: 
+To install the MATE meta package that includes the MATE Desktop with some extra applications such as text editor, archiver manager, etc., execute: 
 
 [source,shell]
 ....
@@ -362,7 +363,7 @@ To install the MATE meta package with MATE Desktop with some extra applications
 [[mate-minimal-install]]
 ==== Minimal MATE installation
 
-To install the MATE lite meta package with MATE desktop slimmed down for only the basics execute:
+To install the MATE lite meta package with MATE desktop slimmed down for only the basics, execute:
 
 [source,shell]
 ....
@@ -382,7 +383,7 @@ proc                    /proc           procfs  rw              0       0
 ....
 
 MATE uses man:dbus-daemon[1] for a message bus and hardware abstraction.
-This application is automatically installed as dependencies of MATE.
+This application is automatically installed as a dependency of MATE.
 Enable D-BUS in `/etc/rc.conf` to start at system boot:
 
 [source,shell]
@@ -395,7 +396,7 @@ Enable D-BUS in `/etc/rc.conf` to start at system boot:
 
 package:x11/lightdm[] is a display manager that supports different display technologies and is a good choice as it is very lightweight, requires little memory usage, and has fast performance.
 
-To install it execute:
+To install it, execute:
 
 [source,shell]
 ....
@@ -410,7 +411,7 @@ Enable lightdm in `/etc/rc.conf` to start at system boot:
 ....
 
 A second method to start MATE is by manually invoking man:startx[1].
-For this to work, the following line is needed in ~/.xinitrc:
+For this to work, the following line is needed in `~/.xinitrc`:
 
 [source,shell]
 ....
@@ -428,7 +429,7 @@ The emphasis is put on making users feel at home and providing them with an easy
 [[cinnamon-install]]
 === Install Cinnamon
 
-To install the Cinnamon package execute:
+To install the Cinnamon package, execute:
 
 [source,shell]
 ....
@@ -448,7 +449,7 @@ proc                    /proc           procfs  rw              0       0
 ....
 
 Cinnamon uses man:dbus-daemon[1] for a message bus and hardware abstraction.
-This application is automatically installed as dependencies of Cinnamon.
+This application is automatically installed as a dependency of Cinnamon.
 Enable D-BUS in `/etc/rc.conf` to start at system boot:
 
 [source,shell]
@@ -476,7 +477,7 @@ Enable lightdm in `/etc/rc.conf` to start at system boot:
 ....
 
 A second method to start Cinnamon is by manually invoking man:startx[1].
-For this to work, the following line is needed in ~/.xinitrc:
+For this to work, the following line is needed in `~/.xinitrc`:
 
 [source,shell]
 ....
@@ -493,7 +494,7 @@ Unlike most desktop environments, LXQt also works fine with less powerful machin
 [[lxqt-install]]
 ==== Install LXQT
 
-To install the LXQT meta package execute:
+To install the LXQT meta package, execute:
 
 [source,shell]
 ....
@@ -513,7 +514,7 @@ proc                    /proc           procfs  rw              0       0
 ....
 
 LXQT uses man:dbus-daemon[1] for a message bus and hardware abstraction.
-This application is automatically installed as dependencies of LXQT.
+This application is automatically installed as a dependency of LXQT.
 
 Enable D-BUS in `/etc/rc.conf` to start at system boot:
 
@@ -525,8 +526,8 @@ Enable D-BUS in `/etc/rc.conf` to start at system boot:
 [[lxqt-start]]
 ==== Start LXQT
 
-Preferred LXQT display manager is package:x11/sddm[].
-To install package:x11/sddm[] execute:
+The preferred LXQT display manager is package:x11/sddm[].
+To install package:x11/sddm[], execute:
 
 [source,shell]
 ....
@@ -540,7 +541,7 @@ Enable SDDM service in `/etc/rc.conf` to start at system boot:
 # sysrc sddm_enable="YES"
 ....
 
-The keyboard language can be set in SDDM by running the following command:
+The keyboard language can be set in SDDM by running the following command (for example, for Spanish):
 
 [source,shell]
 ....
@@ -548,7 +549,7 @@ The keyboard language can be set in SDDM by running the following command:
 ....
 
 A second method to start LXQT is by manually invoking man:startx[1].
-For this to work, the following line is needed in ~/.xinitrc:
+For this to work, the following line is needed in `~/.xinitrc`:
 
 [source,shell]
 ....
@@ -558,10 +559,9 @@ For this to work, the following line is needed in ~/.xinitrc:
 [[desktop-browsers]]
 == Browsers
 
-This section describes how to install and configure some popular web browsers on a FreeBSD system,
-from full web browsers with high resource consumption to command line web browsers with reduced resource usage.
+This section describes how to install and configure some popular web browsers on a FreeBSD system, from full web browsers with high resource consumption to command line web browsers with reduced resource usage.
 
-.Supported browser
+.Supported browsers
 [options="header", cols="1,1,1,1"]
 |===
 | Name | License | Package | Resources Needed
@@ -624,14 +624,14 @@ from full web browsers with high resource consumption to command line web browse
 Firefox is an open source browser that features a standards-compliant HTML display engine, tabbed browsing, popup blocking, extensions, improved security, and more.
 Firefox is based on the Mozilla codebase.
 
-To install the package of the latest release version of Firefox execute:
+To install the package of the latest release version of Firefox, execute:
 
 [source,shell]
 ....
 # pkg install firefox
 ....
 
-To instead install Firefox Extended Support Release (ESR) version execute:
+To instead install Firefox Extended Support Release (ESR) version, execute:
 
 [source,shell]
 ....
@@ -645,7 +645,7 @@ Chromium is an open source browser project that aims to build a safer, faster, a
 Chromium features tabbed browsing, popup blocking, extensions, and much more.
 Chromium is the open source project upon which the Google Chrome web browser is based.
 
-To install Chromium execute:
+To install Chromium, execute:
 
 [source,shell]
 ....
@@ -663,7 +663,7 @@ The executable for Chromium is [.filename]#/usr/local/bin/chrome#, not [.filenam
 Iridium is a free, open, and libre browser modification of the Chromium code base, with privacy being enhanced in several key areas.
 Automatic transmission of partial queries, keywords, metrics to central services is inhibited and only occurs with consent.
 
-To install Iridium execute:
+To install Iridium, execute:
 
 [source,shell]
 ....
@@ -679,7 +679,7 @@ Falkon has all standard functions you expect from a web browser.
 It includes bookmarks, history (both also in sidebar) and tabs.
 Beyond that, you block ads with a builtin AdBlock plugin, block Flash content with Click2Flash and edit the local CA Certificates database with an SSL Manager.
 
-To install Falkon execute:
+To install Falkon, execute:
 
 [source,shell]
 ....
@@ -690,10 +690,9 @@ To install Falkon execute:
 === Konqueror
 
 Konqueror is more than a web browser as it is also a file manager and a multimedia viewer.
-Supports WebKit as well as its own KHTML.
-WebKit is a rendering engine used by many modern browsers including Chromium.
+It supports WebKit, a rendering engine used by many modern browsers including Chromium, as well as its own KHTML engine.
 
-To install Konqueror execute:
+To install Konqueror, execute:
 
 [source,shell]
 ....
@@ -705,21 +704,22 @@ To install Konqueror execute:
 
 Gnome Web (Epiphany) is a web browser designed to be as lightweight and fast as possible, at the expense of many of the features found in other browsers.
 
-To install Gnome Web (Epiphany) execute:
+To install Gnome Web (Epiphany), execute:
 
 [source,shell]
 ....
-# pkg install konqueror
+# pkg install epiphany
 ....
 
 [[qutebrowser]]
 === qutebrowser
 
 Qutebrowser is a keyboard-focused browser with a minimal GUI.
-It's based on Python and PyQt5 and free software, licensed under the GPL.
+It is based on Python and PyQt5 and free software, licensed under the GPL.
+// What are these and how does this information help in this context?
 It was inspired by other browsers/addons like dwb and Vimperator/Pentadactyl.
 
-To install qutebrowser execute:
+To install qutebrowser, execute:
 
 [source,shell]
 ....
@@ -729,10 +729,10 @@ To install qutebrowser execute:
 [[dillo]]
 === Dillo
 
-Dillo aims to be a multiplatform alternative browser that's small, stable, developer-friendly, usable, fast, and extensible.
+Dillo aims to be a multiplatform alternative browser that is small, stable, developer-friendly, usable, fast, and extensible.
 This new, experimental version of Dillo is based upon FLTK toolkit, rather than GTK1, and has been substantially rewritten.
 
-To install Dillo execute:
+To install Dillo, execute:
 
 [source,shell]
 ....
@@ -742,9 +742,9 @@ To install Dillo execute:
 [[links]]
 === Links
 
-Lynx-like WWW browser with text and graphics modes with many features like displaying tables, menus, etc.
+A lynx-like WWW browser with text and graphics modes with many features like displaying tables, menus, etc.
 
-To install Links execute:
+To install Links, execute:
 
 [source,shell]
 ....
@@ -756,7 +756,7 @@ To install Links execute:
 
 w3m is a pager/text-based web browser. It is a similar application to Lynx, but it has several features Lynx doesn't have like rendering tables and rendering frames.
 
-To install w3m execute:
+To install w3m, execute:
 
 [source,shell]
 ....
@@ -816,7 +816,7 @@ This section describes how to install and configure some popular development too
 Visual Studio Code is a type of tool that combines the simplicity of a code editor with what developers need for their core edit-build-debug cycle.
 It provides comprehensive editing and debugging support, an extensibility model, and lightweight integration with existing tools.
 
-To install Visual Studio Code execute:
+To install Visual Studio Code, execute:
 
 [source,shell]
 ....
@@ -836,7 +836,7 @@ Functionalities included with Qt Creator are:
 * visual debugger;
 * integrated GUI layout and forms designer.
 
-To install Qt Creator execute:
+To install Qt Creator, execute:
 
 [source,shell]
 ....
@@ -847,9 +847,9 @@ To install Qt Creator execute:
 === kdevelop
 
 Open source, feature-full, plugin extensible IDE for C/C++ and other programming languages.
-It is based on KDevPlatform and the KDE and Qt libraries, and it's under development since 1998.
+It is based on KDevPlatform and the KDE and Qt libraries, and it has been under development since 1998.
 
-To install kdevelop execute:
+To install kdevelop, execute:
 
 [source,shell]
 ....
@@ -863,7 +863,7 @@ The Eclipse Platform is an open extensible IDE for anything and yet nothing in p
 The Eclipse Platform provides building blocks and a foundation for constructing and running integrated software-development tools. 
 The Eclipse Platform allows tool builders to independently develop tools that integrate with other people's tools.
 
-To install Eclipse IDE execute:
+To install Eclipse IDE, execute:
 
 [source,shell]
 ....
@@ -880,7 +880,7 @@ Vim is often called a "programmer's editor," and so useful for programming that
 It's not just for programmers, though.
 Vim is perfect for all kinds of text editing, from composing email to editing configuration files.
 
-To install Vim execute:
+To install Vim, execute:
 
 [source,shell]
 ....
@@ -894,7 +894,7 @@ Neovim is an aggressive refactor of package:editors/vim[].
 It represents a complete overhaul of the codebase with many sanity improvements, including sensible defaults, a built-in terminal emulator, asynchronous plugin architecture, and powerful APIs designed for speed and extensibility.
 It retains full compatibility with almost all Vim plugins and scripts.
 
-To install Neovim execute:
+To install Neovim, execute:
 
 [source,shell]
 ....
@@ -907,7 +907,7 @@ To install Neovim execute:
 GNU Emacs is an extensible, customizable, free/libre text editor.
 At its core is an interpreter for Emacs Lisp, a dialect of the Lisp programming language with extensions to support text editing.
 
-To install GNU Emacs execute:
+To install GNU Emacs, execute:
 
 [source,shell]
 ....
@@ -954,7 +954,7 @@ It is a rebranded fork of Apache OpenOffice and includes applications found in a
 It is available in a number of different languages and internationalization has been extended to interfaces, spell checkers, and dictionaries.
 More information about LibreOffice can be found at http://www.libreoffice.org/[libreoffice.org].
 
-To install LibreOffice execute:
+To install LibreOffice, execute:
 
 [source,shell]
 ....
@@ -962,7 +962,7 @@ To install LibreOffice execute:
 ....
 
 The LibreOffice package comes by default only in English.
-To have a localized version of LibreOffice it is necessary to install the language pack.
+To have a localized version of LibreOffice it is necessary to install a language pack.
 For example, for the version localized in Spanish, it is necessary to install the package package:editors/libreoffice-es[] with the command:
 
 [source,shell]
@@ -977,7 +977,7 @@ The KDE Plasma desktop environment includes an office suite which can be install
 Calligra includes standard components that can be found in other office suites.
 Words is the word processor, Sheets is the spreadsheet program, Stage manages slide presentations, and Karbon is used to draw graphical documents.
 
-To install Calligra execute:
+To install Calligra, execute:
 
 [source,shell]
 ....
@@ -992,7 +992,7 @@ It is fast, contains many features, and is user-friendly.
 
 AbiWord can import or export many file formats, including some proprietary ones like Microsoft(R) [.filename]#.rtf#.
 
-To install AbiWord execute:
+To install AbiWord, execute:
 
 [source,shell]
 ....
@@ -1037,9 +1037,9 @@ This section demonstrates how to install the following document viewers:
 
 Okular is a universal document viewer, part of the KDE Plasma project.
 
-Okular combines the excellent functionalities with the versatility of supporting different kind of documents, like PDF, Postscript, DjVu, CHM, XPS, ePub and others.
+Okular combines excellent functionality with the versatility of supporting different kind of documents, like PDF, Postscript, DjVu, CHM, XPS, ePub and others.
 
-To install Okular execute:
+To install Okular, execute:
 
 [source,shell]
 ....
@@ -1053,7 +1053,7 @@ Evince is a document viewer for multiple document formats including PDF and Post
 Part of the GNOME project.
 The goal of evince is to replace document viewers such as ggv and gpdf with a single, simple application.
 
-To install Evince execute:
+To install Evince, execute:
 
 [source,shell]
 ....
@@ -1064,9 +1064,9 @@ To install Evince execute:
 === ePDFView
 
 ePDFView is a lightweight PDF document viewer that only uses the Gtk+ and Poppler libraries.
-The aim of ePDFView is to make a simple PDF document viewer, in the lines of Evince but without using the GNOME libraries.
+The aim of ePDFView is to make a simple PDF document viewer, similar to Evince but without using the GNOME libraries.
 
-To install ePDFView execute:
+To install ePDFView, execute:
 
 [source,shell]
 ....
@@ -1079,7 +1079,7 @@ To install ePDFView execute:
 For users that prefer a small FreeBSD PDF viewer, Xpdf provides a light-weight and efficient viewer which requires few resources.
 It uses the standard X fonts and does not require any additional toolkits.
 
-To install Xpdf execute:
+To install Xpdf, execute:
 
 [source,shell]
 ....
@@ -1119,7 +1119,7 @@ KMyMoney aims to provide the important features found in commercial personal fin
 It also highlights ease-of-use and proper double-entry accounting among its features.
 KMyMoney imports from standard Quicken QIF files, tracks investments, handles multiple currencies, and provides a wealth of reports.
 
-To install KMyMoney execute:
+To install KMyMoney, execute:
 
 [source,shell]
 ....
@@ -1138,7 +1138,7 @@ It can split a single transaction into several more detailed pieces.
 GnuCash can import and merge Quicken QIF files.
 It also handles most international date and currency formats.
 
-To install GnuCash execute:
+To install GnuCash, execute:
 
 [source,shell]
 ....
diff --git a/documentation/content/en/books/handbook/x11/_index.adoc b/documentation/content/en/books/handbook/x11/_index.adoc
index 4b2f19074d..523d9d2d2e 100644
--- a/documentation/content/en/books/handbook/x11/_index.adoc
+++ b/documentation/content/en/books/handbook/x11/_index.adoc
@@ -82,7 +82,7 @@ The binary meta package can be installed quickly but with fewer options for cust
 Either of these installations results in the complete Xorg system being installed.
 
 The current user must be a member of the `video` group.
-To add the current user to `video` group execute the following command:
+To add a user to `video` group, execute the following command:
 
 [source,shell]
 ....
@@ -194,14 +194,14 @@ Intel(R) Graphics refers to the class of graphics chips that are integrated on t
 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 cards.
-The Intel(R) driver can be installed executing the following command:
+The Intel(R) driver can be installed by executing the following command:
 
 [source,shell]
 ....
 # pkg install drm-kmod
 ....
 
-Then add the module to `/etc/rc.conf` file executing the following command:
+Then add the module to `/etc/rc.conf` file, executing the following command:
 
 [source,shell]
 ....
@@ -226,21 +226,21 @@ The package:graphics/drm-kmod[] package indirectly provides a range of kernel mo
 The modules `amdgpu` and `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].
 
-AMD(R) driver can be installed executing the following command:
+AMD(R) driver can be installed by executing the following command:
 
 [source,shell]
 ....
 # pkg install drm-kmod
 ....
 
-For post-HD7000 or Tahiti graphic cards add the module to `/etc/rc.conf` file executing the following command:
+For post-HD7000 or Tahiti graphic cards add the module to `/etc/rc.conf` file, executing the following command:
 
 [source,shell]
 ....
 # sysrc kld_list+=amdgpu
 ....
 
-For older graphic cards (pre-HD7000 or pre-Tahiti) add the module to `/etc/rc.conf` file executing the following command:
+For older graphic cards (pre-HD7000 or pre-Tahiti) add the module to `/etc/rc.conf` file, executing the following command:
 
 [source,shell]
 ....
@@ -251,8 +251,8 @@ For older graphic cards (pre-HD7000 or pre-Tahiti) add the module to `/etc/rc.co
 === NVIDIA(R)
 
 FreeBSD supports different versions of the proprietary NVIDIA(R) driver.
-Users of newer graphics cards will have to install the package:x11/nvidia-driver[] package.
-The oldest ones will have to check which version supports them.
+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.
 
 .Supported versions of NVIDIA(R) drivers
 [options="header", cols="1,1"]
@@ -281,14 +281,14 @@ The oldest ones will have to check which version supports them.
 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) driver can be installed running the following command:
+The latest NVIDIA(R) driver can be installed by running the following command:
 
 [source,shell]
 ....
 # pkg install nvidia-driver
 ....
 
-Then add the module to `/etc/rc.conf` file executing the following command:
+Then add the module to `/etc/rc.conf` file, executing the following command:
 
 [source,shell]
 ....
@@ -297,7 +297,7 @@ Then add the module to `/etc/rc.conf` file executing the following command:
 
 [WARNING]
 ====
-`nvidia-modeset` driver must be used *only* as an alternative to `nvidia` if starting the X server results in a hang or these values are observed in `/var/log/Xorg.0.log`:
+The `nvidia-modeset` driver must be used *only* as an alternative to `nvidia` if starting the X server results in a hang or these values are observed in `/var/log/Xorg.0.log`:
 
 [.programlisting]
 ....
@@ -426,7 +426,7 @@ EndSection
 ====
 
 To configure multiple video cards, the `BusID` can be added.
-A list of video card bus ``ID``s can be displayed executing:
+A list of video card bus ``ID``s can be displayed by executing:
 
 [source,shell]
 ....
@@ -525,7 +525,7 @@ DP-3 disconnected (normal left inverted right x axis y axis)
 ....
 
 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.
-And 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.
+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.
 
 Any of the other display modes can be selected with man:xrandr[1].
@@ -563,12 +563,12 @@ EndSection
 [[x-config-input]]
 === Input Devices
 
-Through package:x11/libinput[] Xorg supports the vast majority of input devices.
+Xorg supports the vast majority of input devices via package:x11/libinput[].
 
 [TIP]
 ====
 Some desktop environments (such as KDE Plasma) provide a graphical UI for setting these parameters.
-Check it before resorting to manual configuration editing.
+Check if this is the case before resorting to manual configuration editing.
 ====
 
 [[x-config-input-keyboard-layout]]
@@ -621,7 +621,7 @@ To have the X server detect these fonts, add an appropriate line to the X server
 ....
 Section "Files"
   FontPath "/usr/local/share/fonts/urwfonts/"
-EdnSection
+EndSection
 ....
 
 Alternatively, at the command line in the X session run:
@@ -821,4 +821,4 @@ To enable this, add the line somewhere in [.filename]#local.conf#:
 Depending on the sort of display, `rgb` may need to be changed to `bgr`, `vrgb` or `vbgr`: experiment and see which works best.
 ====
 
-For more information about how to install and configure Fonts on FreeBSD, please read the article link:{fonts}[Fonts and FreeBSD].
+For more information about how to install and configure fonts on FreeBSD, please read the article link:{fonts}[Fonts and FreeBSD].



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202302132240.31DMe2nH088187>