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"