git: 712fd5ac9181 - main - intro.9: minor changes

From: Mitchell Horne <mhorne_at_FreeBSD.org>
Date: Wed, 31 Jan 2024 18:36:02 UTC
The branch main has been updated by mhorne:

URL: https://cgit.FreeBSD.org/src/commit/?id=712fd5ac9181b544d8ffcf88ab6313233c8ddaed

commit 712fd5ac9181b544d8ffcf88ab6313233c8ddaed
Author:     Graham Perrin <grahamperrin@gmail.com>
AuthorDate: 2023-08-06 17:34:03 +0000
Commit:     Mitchell Horne <mhorne@FreeBSD.org>
CommitDate: 2024-01-31 18:31:32 +0000

    intro.9: minor changes
    
    A correction: 'and' -> 'an'. Plus, several tweaks for brevity or
    clarity.
    
    Reviewed by:    mhorne
    MFC after:      3 days
    Pull Request:   https://github.com/freebsd/freebsd-src/pull/813
---
 share/man/man9/intro.9 | 40 ++++++++++++++++++++--------------------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/share/man/man9/intro.9 b/share/man/man9/intro.9
index 458ee0ab4697..e13566725976 100644
--- a/share/man/man9/intro.9
+++ b/share/man/man9/intro.9
@@ -6,7 +6,7 @@
 .\" This manual page was written by Mitchell Horne <mhorne@FreeBSD.org> under
 .\" sponsorship from the FreeBSD Foundation.
 .\"
-.Dd August 2, 2023
+.Dd January 30, 2024
 .Dt INTRO 9
 .Os
 .Sh NAME
@@ -16,7 +16,7 @@
 Welcome to the
 .Fx
 kernel documentation.
-Outside of the source code itself, this set of
+Outside the source code itself, this set of
 .Xr man 1
 pages is the primary resource for information on usage of the numerous
 programming interfaces available within the kernel.
@@ -177,9 +177,10 @@ The kernel interface for file systems is
 File system implementations register themselves with
 .Xr vfsconf 9 .
 .Pp
-The abstract and filesystem-independent representation of a file, directory, or
-other file-like entity within the kernel is the
-.Xr vnode 9 .
+The
+.Xr vnode 9
+is the abstract and filesystem-independent representation of a file,
+directory, or other file-like entity within the kernel.
 .Pp
 The implementation of access control lists for filesystems is described by
 .Xr acl 9 .
@@ -371,7 +372,7 @@ Signals can be sent to processes or process groups using the functions
 described by
 .Xr psignal 9 .
 .Ss Security
-See the generic security overview in
+See the overview in
 .Xr security 7 .
 .Pp
 The basic structure for user credentials is
@@ -397,7 +398,7 @@ see
 .Xr mac 9 .
 .Pp
 Cryptographic services are provided by the OpenCrypto framework.
-This API provides and interface for both consumers and crypto drivers;
+This API provides an interface for both consumers and crypto drivers;
 see
 .Xr crypto 9 .
 .Pp
@@ -409,9 +410,9 @@ and
 The interfaces for declaring loadable kernel modules are described by
 .Xr module 9 .
 .Ss Interrupts
-The machine-independent portion of the interrupt framework supporting the
-registration and execution of interrupt handlers is described by
-.Xr intr_event 9 .
+.Xr intr_event 9
+describes the machine-independent portion of the interrupt framework
+that supports registration and execution of interrupt handlers.
 .Pp
 Software interrupts are provided by
 .Xr swi 9 .
@@ -450,17 +451,16 @@ Kernel sanitizers can perform additional compiler-assisted checks against
 memory use/access.
 These runtimes are capable of detecting difficult-to-identify classes of bugs,
 at the cost of a large overhead.
-Supported is the Kernel Address Sanitizer
-.Xr KASAN 9 ,
-and the Kernel Memory Sanitizer
-.Xr KMSAN 9 .
+The Kernel Address Sanitizer
+.Xr KASAN 9
+and Kernel Memory Sanitizer
+.Xr KMSAN 9
+are supported.
 .Pp
 The
-.Cd LOCK_PROFILING
+.Xr LOCK_PROFILING 9
 kernel config option enables extra code to assist with profiling and/or
-debugging lock performance;
-see
-.Xr LOCK_PROFILING 9 .
+debugging lock performance.
 .Ss Driver Tools
 Defined functions/APIs for specific types of devices.
 .Bl -tag -width "Xr usbdi 9"
@@ -514,6 +514,6 @@ The kernel object implementation is described by
 .Xr man 1 ,
 .Xr style 9
 .Rs
-.%T "The FreeBSD Architecture Handbook"
-.%U "https://docs.freebsd.org/en/books/arch-handbook/"
+.%T The FreeBSD Architecture Handbook
+.%U https://docs.freebsd.org/en/books/arch-handbook/
 .Re