git: 3609e56813b4 - stable/14 - manuals: Fix errors in .2 pages

From: Mitchell Horne <mhorne_at_FreeBSD.org>
Date: Mon, 04 Nov 2024 15:56:34 UTC
The branch stable/14 has been updated by mhorne:

URL: https://cgit.FreeBSD.org/src/commit/?id=3609e56813b4322660c9f4a882f7336d57b7d723

commit 3609e56813b4322660c9f4a882f7336d57b7d723
Author:     Graham Percival <gperciva@tarsnap.com>
AuthorDate: 2024-09-20 01:54:39 +0000
Commit:     Mitchell Horne <mhorne@FreeBSD.org>
CommitDate: 2024-11-04 15:56:24 +0000

    manuals: Fix errors in .2 pages
    
    These were reported by `mandoc -T lint ...` as errors.
    
    fhlink.2, fhreadlink.2: remove unneeded block closing.
    
    getfh.2, procctl.2: add necessary block closing.
    
    ptrace.2: -width only takes one argument.
    
    swapon.2: <sys/vmparam.h> and <vm/swap_pager.h> weren't being displayed,
        because .It is for a list item whereas .In is for included files.
        Also, we want a blank line between <sys/ > headers and the other
        one.
    
    Signed-off-by:  Graham Percival <gperciva@tarsnap.com>
    PR:             281597
    Reviewed by:    mhorne
    Sponsored by:   Tarsnap Backup Inc.
    
    (cherry picked from commit 650056363baddb83c61c85b0539ee536f3d4b56c)
---
 lib/libc/sys/fhlink.2     | 1 -
 lib/libc/sys/fhreadlink.2 | 2 --
 lib/libc/sys/getfh.2      | 1 +
 lib/libc/sys/procctl.2    | 1 +
 lib/libc/sys/ptrace.2     | 2 +-
 lib/libc/sys/swapon.2     | 5 +++--
 6 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/lib/libc/sys/fhlink.2 b/lib/libc/sys/fhlink.2
index 332856630879..b7f7d02dd136 100644
--- a/lib/libc/sys/fhlink.2
+++ b/lib/libc/sys/fhlink.2
@@ -38,7 +38,6 @@
 .Fn fhlink "fhandle_t *fhp" "const char *to"
 .Ft int
 .Fn fhlinkat "fhandle_t *fhp" "int tofd" "const char *to"
-.Fc
 .Sh DESCRIPTION
 The
 .Fn fhlink
diff --git a/lib/libc/sys/fhreadlink.2 b/lib/libc/sys/fhreadlink.2
index 23850c6a2117..222142de223e 100644
--- a/lib/libc/sys/fhreadlink.2
+++ b/lib/libc/sys/fhreadlink.2
@@ -36,7 +36,6 @@
 .In sys/mount.h
 .Ft int
 .Fn fhreadlink "fhandle_t *fhp" "char *buf" "size_t bufsize"
-.Fc
 .Sh DESCRIPTION
 The
 .Fn fhreadlink
@@ -86,7 +85,6 @@ The file handle
 .Fa fhp
 is no longer valid
 .El
-.El
 .Sh SEE ALSO
 .Xr fhstat 2 ,
 .Xr fhlink 2 ,
diff --git a/lib/libc/sys/getfh.2 b/lib/libc/sys/getfh.2
index f5eaf4be7874..ae3b67edf1e8 100644
--- a/lib/libc/sys/getfh.2
+++ b/lib/libc/sys/getfh.2
@@ -214,6 +214,7 @@ argument is not an absolute path and
 is neither
 .Dv AT_FDCWD
 nor a file descriptor associated with a directory.
+.El
 .Sh SEE ALSO
 .Xr fhopen 2 ,
 .Xr open 2 ,
diff --git a/lib/libc/sys/procctl.2 b/lib/libc/sys/procctl.2
index cb5234b6e40c..b040116a8e60 100644
--- a/lib/libc/sys/procctl.2
+++ b/lib/libc/sys/procctl.2
@@ -712,6 +712,7 @@ following statuses:
 The status is or-ed with the
 .Va PROC_KPTI_STATUS_ACTIVE
 in case KPTI is active for the current address space of the process.
+.El
 .Sh NOTES
 Disabling tracing on a process should not be considered a security
 feature, as it is bypassable both by the kernel and privileged processes,
diff --git a/lib/libc/sys/ptrace.2 b/lib/libc/sys/ptrace.2
index ae1770315aa5..9b789a0e45b3 100644
--- a/lib/libc/sys/ptrace.2
+++ b/lib/libc/sys/ptrace.2
@@ -830,7 +830,7 @@ value.
 If the system call completed in an unusual fashion,
 .Va sr_error
 is set to a negative value:
-.Bl -tag -width Dv EJUSTRETURN -compact
+.Bl -tag -width EJUSTRETURN -compact
 .It Dv ERESTART
 System call will be restarted.
 .It Dv EJUSTRETURN
diff --git a/lib/libc/sys/swapon.2 b/lib/libc/sys/swapon.2
index c0c12d9dde68..8cfac8ce1f64 100644
--- a/lib/libc/sys/swapon.2
+++ b/lib/libc/sys/swapon.2
@@ -36,8 +36,9 @@
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
-.It vm/vm_param.h
-.It vm/swap_pager.h
+.In vm/vm_param.h
+.In vm/swap_pager.h
+.Pp
 .In unistd.h
 .Ft int
 .Fn swapon "const char *special"