git: 712fd5ac9181 - main - intro.9: minor changes
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
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