libutil: Fix mandoc warnings

- missing comma before name
- possible typo in section name: Sh CAVEAT instead of CAVEATS
- useless macro: Tn
- blank line in fill mode, using .sp
- no blank before trailing delimiter: Dv NULL?

MFC after:	3 days
This commit is contained in:
Gordon Bergling 2022-08-07 16:30:24 +02:00
parent fa1ac9693a
commit 816ca3d10f
6 changed files with 22 additions and 27 deletions

View file

@ -183,12 +183,8 @@ The
and and
.Dv HN_IEC_PREFIXES .Dv HN_IEC_PREFIXES
flags flags
conform to conform to ISO/IEC Std\~80000-13:2008
.Tn ISO/IEC and IEEE Std\~1541-2002.
Std\~80000-13:2008
and
.Tn IEEE
Std\~1541-2002.
.Sh HISTORY .Sh HISTORY
The The
.Fn humanize_number .Fn humanize_number

View file

@ -58,13 +58,6 @@ with the
mib. mib.
While the kernel returns a packed structure, this function expands the While the kernel returns a packed structure, this function expands the
data into a fixed record format. data into a fixed record format.
.Sh CAVEAT
.Fn kinfo_getvmmap
calls can cause significant CPU consumption because calculating the residency
counts requires iterating over all memory pages of the process.
Setting the sysctl variable
.Va kern.proc_vmmap_skip_resident_count
to 1 prevents this calculation.
.Sh RETURN VALUES .Sh RETURN VALUES
On success the On success the
.Fn kinfo_getvmmap .Fn kinfo_getvmmap
@ -89,3 +82,10 @@ The
.Fn kinfo_getvmmap .Fn kinfo_getvmmap
function first appeared in function first appeared in
.Fx 7.0 . .Fx 7.0 .
.Sh CAVEATS
.Fn kinfo_getvmmap
calls can cause significant CPU consumption because calculating the residency
counts requires iterating over all memory pages of the process.
Setting the sysctl variable
.Va kern.proc_vmmap_skip_resident_count
to 1 prevents this calculation.

View file

@ -68,4 +68,3 @@ The function
.Fn login_tty .Fn login_tty
first appeared in first appeared in
.Bx 4.4 . .Bx 4.4 .

View file

@ -149,7 +149,7 @@ The
and and
.Fn forkpty .Fn forkpty
functions first appeared in functions first appeared in
.Bx 4.3 Reno. .Bx 4.3 Reno .
.Sh BUGS .Sh BUGS
.Fn openpty .Fn openpty
writes the slave terminal's name to writes the slave terminal's name to

View file

@ -191,7 +191,7 @@ it will default to
.Fa master .Fa master
is the name of the password file. is the name of the password file.
If set to If set to
.Dv NULL? .Dv NULL ?
it will default to it will default to
.Pa master.passwd .Pa master.passwd
.Pp .Pp

View file

@ -29,17 +29,17 @@
.Dt QUOTAFILE 3 .Dt QUOTAFILE 3
.Os .Os
.Sh NAME .Sh NAME
.Nm quota_open .Nm quota_open ,
.Nm quota_close .Nm quota_close ,
.Nm quota_on .Nm quota_on ,
.Nm quota_off .Nm quota_off ,
.Nm quota_read .Nm quota_read ,
.Nm quota_write_limits .Nm quota_write_limits ,
.Nm quota_write_usage .Nm quota_write_usage ,
.Nm quota_fsname .Nm quota_fsname ,
.Nm quota_qfname .Nm quota_qfname ,
.Nm quota_maxid .Nm quota_maxid ,
.Nm quota_check_path .Nm quota_check_path ,
.Nm quota_convert .Nm quota_convert
.Nd "Manipulate quotas" .Nd "Manipulate quotas"
.Sh LIBRARY .Sh LIBRARY