git: 650056363bad - main - manuals: Fix errors in .2 pages
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
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"