git: 650056363bad - main - manuals: Fix errors in .2 pages

From: Mitchell Horne <mhorne_at_FreeBSD.org>
Date: Fri, 20 Sep 2024 14:37:22 UTC
The branch main has been updated by mhorne:

URL: https://cgit.FreeBSD.org/src/commit/?id=650056363baddb83c61c85b0539ee536f3d4b56c

commit 650056363baddb83c61c85b0539ee536f3d4b56c
Author:     Graham Percival <gperciva@tarsnap.com>
AuthorDate: 2024-09-20 01:54:39 +0000
Commit:     Mitchell Horne <mhorne@FreeBSD.org>
CommitDate: 2024-09-20 14:37:02 +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.
---
 lib/libsys/fhlink.2     | 1 -
 lib/libsys/fhreadlink.2 | 2 --
 lib/libsys/getfh.2      | 1 +
 lib/libsys/procctl.2    | 1 +
 lib/libsys/ptrace.2     | 2 +-
 lib/libsys/swapon.2     | 5 +++--
 6 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/lib/libsys/fhlink.2 b/lib/libsys/fhlink.2
index 332856630879..b7f7d02dd136 100644
--- a/lib/libsys/fhlink.2
+++ b/lib/libsys/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/libsys/fhreadlink.2 b/lib/libsys/fhreadlink.2
index 23850c6a2117..222142de223e 100644
--- a/lib/libsys/fhreadlink.2
+++ b/lib/libsys/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/libsys/getfh.2 b/lib/libsys/getfh.2
index a03a3394aabb..d16a34da4f28 100644
--- a/lib/libsys/getfh.2
+++ b/lib/libsys/getfh.2
@@ -212,6 +212,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/libsys/procctl.2 b/lib/libsys/procctl.2
index 049568c5fc09..cdb379696401 100644
--- a/lib/libsys/procctl.2
+++ b/lib/libsys/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/libsys/ptrace.2 b/lib/libsys/ptrace.2
index ae1770315aa5..9b789a0e45b3 100644
--- a/lib/libsys/ptrace.2
+++ b/lib/libsys/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/libsys/swapon.2 b/lib/libsys/swapon.2
index 78fc94eb6e34..d7694ed48c8e 100644
--- a/lib/libsys/swapon.2
+++ b/lib/libsys/swapon.2
@@ -34,8 +34,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"