summaryrefslogtreecommitdiffstats
path: root/lib
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2001-02-01 16:38:02 +0000
committerru <ru@FreeBSD.org>2001-02-01 16:38:02 +0000
commit8a6f8b5fe456b5b3a8f1d86173f81cfcae6cfe19 (patch)
treeb428fc12404c6d6be2c1fce52490993ab3744097 /lib
parent4923ae6c3fe2f82d94fec60b85ed2a6272b2fd67 (diff)
downloadFreeBSD-src-8a6f8b5fe456b5b3a8f1d86173f81cfcae6cfe19.zip
FreeBSD-src-8a6f8b5fe456b5b3a8f1d86173f81cfcae6cfe19.tar.gz
mdoc(7) police: split punctuation characters + misc fixes.
Diffstat (limited to 'lib')
-rw-r--r--lib/libc/gen/dlopen.32
-rw-r--r--lib/libc/gen/fts.32
-rw-r--r--lib/libc/gen/getcap.318
-rw-r--r--lib/libc/gen/getcwd.34
-rw-r--r--lib/libc/gen/getpwent.32
-rw-r--r--lib/libc/gen/glob.316
-rw-r--r--lib/libc/gen/msgget.32
-rw-r--r--lib/libc/gen/sysctl.324
-rw-r--r--lib/libc/gen/syslog.32
-rw-r--r--lib/libc/gen/tcsetattr.32
-rw-r--r--lib/libc/gen/ttyname.32
-rw-r--r--lib/libc/gen/tzset.320
-rw-r--r--lib/libc/gen/uname.34
-rw-r--r--lib/libc/gen/vis.32
-rw-r--r--lib/libc/locale/mbrune.32
-rw-r--r--lib/libc/locale/multibyte.32
-rw-r--r--lib/libc/locale/rune.34
-rw-r--r--lib/libc/locale/utf2.42
-rw-r--r--lib/libc/locale/utf2.52
-rw-r--r--lib/libc/net/if_indextoname.318
-rw-r--r--lib/libc/net/inet6_option_space.334
-rw-r--r--lib/libc/net/inet6_rthdr_space.318
-rw-r--r--lib/libc/net/resolver.33
-rw-r--r--lib/libc/stdio/printf.32
-rw-r--r--lib/libc/stdio/stdio.310
-rw-r--r--lib/libc/stdlib/getenv.32
-rw-r--r--lib/libc/stdlib/malloc.34
-rw-r--r--lib/libc/stdlib/qsort.32
-rw-r--r--lib/libc/stdlib/strtol.32
-rw-r--r--lib/libc/stdlib/strtoul.32
-rw-r--r--lib/libc/stdlib/tsearch.32
-rw-r--r--lib/libc/string/bstring.32
-rw-r--r--lib/libc/string/strcat.32
-rw-r--r--lib/libc/string/strerror.32
-rw-r--r--lib/libc/string/string.34
-rw-r--r--lib/libc/string/strtok.36
-rw-r--r--lib/libc/sys/aio_waitcomplete.22
-rw-r--r--lib/libc/sys/brk.24
-rw-r--r--lib/libc/sys/execve.22
-rw-r--r--lib/libc/sys/fcntl.220
-rw-r--r--lib/libc/sys/fhopen.22
-rw-r--r--lib/libc/sys/getdirentries.23
-rw-r--r--lib/libc/sys/getlogin.28
-rw-r--r--lib/libc/sys/getsockopt.23
-rw-r--r--lib/libc/sys/kill.22
-rw-r--r--lib/libc/sys/listen.210
-rw-r--r--lib/libc/sys/lseek.22
-rw-r--r--lib/libc/sys/ptrace.244
-rw-r--r--lib/libc/sys/recv.22
-rw-r--r--lib/libc/sys/semget.28
-rw-r--r--lib/libc/sys/shmget.28
-rw-r--r--lib/libc/sys/socket.22
-rw-r--r--lib/libc_r/man/pthread_cond_wait.33
-rw-r--r--lib/libc_r/man/pthread_testcancel.32
-rw-r--r--lib/libcompat/4.3/lsearch.32
-rw-r--r--lib/libcompat/4.3/re_comp.32
-rw-r--r--lib/libcompat/4.3/rexec.32
-rw-r--r--lib/libdevstat/devstat.32
-rw-r--r--lib/libdisk/libdisk.32
-rw-r--r--lib/libedit/editline.37
-rw-r--r--lib/libftpio/ftpio.322
-rw-r--r--lib/libipsec/ipsec_strerror.35
-rw-r--r--lib/libkvm/kvm_getfiles.32
-rw-r--r--lib/libkvm/kvm_getprocs.32
-rw-r--r--lib/libkvm/kvm_getswapinfo.358
-rw-r--r--lib/libm/common_source/asin.32
-rw-r--r--lib/libm/common_source/exp.33
-rw-r--r--lib/libm/common_source/hypot.32
-rw-r--r--lib/libm/common_source/ieee.36
-rw-r--r--lib/libm/common_source/lgamma.32
-rw-r--r--lib/libpthread/man/pthread_cond_wait.33
-rw-r--r--lib/libpthread/man/pthread_testcancel.32
-rw-r--r--lib/libstand/libstand.3275
-rw-r--r--lib/libutil/login_times.32
-rw-r--r--lib/libutil/uucplock.322
-rw-r--r--lib/msun/man/asin.32
-rw-r--r--lib/msun/man/exp.35
-rw-r--r--lib/msun/man/hypot.34
-rw-r--r--lib/msun/man/ieee.34
-rw-r--r--lib/msun/man/lgamma.32
80 files changed, 494 insertions, 304 deletions
diff --git a/lib/libc/gen/dlopen.3 b/lib/libc/gen/dlopen.3
index 634f160..f9c1084 100644
--- a/lib/libc/gen/dlopen.3
+++ b/lib/libc/gen/dlopen.3
@@ -36,7 +36,7 @@
.Os FreeBSD
.Dt DLOPEN 3
.Sh NAME
-.Nm dlopen, dlsym, dlerror, dlclose
+.Nm dlopen , dlsym , dlerror , dlclose
.Nd programmatic interface to the dynamic linker
.Sh LIBRARY
.Lb libc
diff --git a/lib/libc/gen/fts.3 b/lib/libc/gen/fts.3
index ccab5b6..b453ef0 100644
--- a/lib/libc/gen/fts.3
+++ b/lib/libc/gen/fts.3
@@ -341,7 +341,7 @@ are attempted.
The
.Fa fts_name
field is always
-.Dv NUL Ns -terminated.
+.Dv NUL Ns -terminated .
.Sh FTS_OPEN
The
.Fn fts_open
diff --git a/lib/libc/gen/getcap.3 b/lib/libc/gen/getcap.3
index 974cf7f..2d86caf 100644
--- a/lib/libc/gen/getcap.3
+++ b/lib/libc/gen/getcap.3
@@ -84,13 +84,13 @@ from the database specified by the
terminated file array
.Fa db_array
and returns a pointer to a
-.Xr malloc Ns \&'d
+.Xr malloc 3 Ns \&'d
copy of it in
.Fa buf .
The
.Fn cgetent
function will first look for files ending in
-.Nm .db
+.Pa .db
(see
.Xr cap_mkdb 1 )
before accessing the ASCII file.
@@ -103,7 +103,7 @@ must be retained through all subsequent calls to
and
.Fn cgetustr ,
but may then be
-.Xr free 3 Ns \&'d.
+.Xr free 3 Ns \&'d .
On success 0 is returned, 1 if the returned
record contains an unresolved
.Nm tc
@@ -200,7 +200,7 @@ from the capability record pointed to by
A pointer to a decoded,
.Dv NUL
terminated,
-.Xr malloc Ns \&'d
+.Xr malloc 3 Ns \&'d
copy of the string is returned in the
.Ft char *
pointed to by
@@ -241,7 +241,7 @@ or
call. If there is no such previous call, the first record in the database is
returned.
Each record is returned in a
-.Xr malloc Ns \&'d
+.Xr malloc 3 Ns \&'d
copy pointed to by
.Fa buf .
.Ic Tc
@@ -416,21 +416,27 @@ and
.Bl -column "nameXnumber"
.Sm off
.It Em name No \&# Em number Ta numeric
+.Sm on
capability
.Em name
has value
.Em number
+.Sm off
.It Em name No = Em string Ta "string capability"
+.Sm on
.Em name
has value
.Em string
+.Sm off
.It Em name No \&#@ Ta "the numeric capability"
+.Sm on
.Em name
does not exist
+.Sm off
.It Em name No \&=@ Ta "the string capability"
+.Sm on
.Em name
does not exist
-.Sm on
.El
.Pp
Numeric capability values may be given in one of three numeric bases.
diff --git a/lib/libc/gen/getcwd.3 b/lib/libc/gen/getcwd.3
index 27d37e6..4e08fab 100644
--- a/lib/libc/gen/getcwd.3
+++ b/lib/libc/gen/getcwd.3
@@ -66,7 +66,7 @@ is
.Dv NULL ,
space is allocated as necessary to store the pathname.
This space may later be
-.Xr free 3 Ns 'd.
+.Xr free 3 Ns 'd .
.Pp
The function
.Fn getwd
@@ -89,7 +89,7 @@ These routines have traditionally been used by programs to save the
name of a working directory for the purpose of returning to it.
A much faster and less error-prone method of accomplishing this is to
open the current directory
-.Pq Ql \&.
+.Pq Ql .\&
and use the
.Xr fchdir 2
function to return.
diff --git a/lib/libc/gen/getpwent.3 b/lib/libc/gen/getpwent.3
index 1e66b69..e41054c 100644
--- a/lib/libc/gen/getpwent.3
+++ b/lib/libc/gen/getpwent.3
@@ -178,7 +178,7 @@ The
.Fn getpwent ,
.Fn getpwnam ,
.Fn getpwuid ,
-.Fn setpwent,
+.Fn setpwent ,
and
.Fn endpwent
functions appeared in
diff --git a/lib/libc/gen/glob.3 b/lib/libc/gen/glob.3
index 4383994..760103b 100644
--- a/lib/libc/gen/glob.3
+++ b/lib/libc/gen/glob.3
@@ -269,7 +269,7 @@ is
.Pf non- Dv NULL ,
.Fn glob
calls
-.Fa (*errfunc)(path, errno) .
+.Fa \*(lp*errfunc\*(rp Ns ( Fa path , errno ) .
This may be unintuitive: a pattern like
.Ql */Makefile
will try to
@@ -374,7 +374,7 @@ An attempt to allocate memory failed.
The scan was stopped because an error was encountered and either
.Dv GLOB_ERR
was set or
-.Fa (*errfunc)()
+.Fa \*(lp*errfunc\*(rp\*(lp\*(rp
returned non-zero.
.El
.Pp
@@ -409,13 +409,13 @@ function is expected to be
.St -p1003.2
compatible with the exception
that the flags
-.Dv GLOB_ALTDIRFUNC,
-.Dv GLOB_BRACE
-.Dv GLOB_MAGCHAR,
-.Dv GLOB_NOMAGIC,
-.Dv GLOB_QUOTE,
+.Dv GLOB_ALTDIRFUNC ,
+.Dv GLOB_BRACE ,
+.Dv GLOB_MAGCHAR ,
+.Dv GLOB_NOMAGIC ,
+.Dv GLOB_QUOTE ,
and
-.Dv GLOB_TILDE,
+.Dv GLOB_TILDE ,
and the fields
.Fa gl_matchc
and
diff --git a/lib/libc/gen/msgget.3 b/lib/libc/gen/msgget.3
index 91a61e0..6d22141 100644
--- a/lib/libc/gen/msgget.3
+++ b/lib/libc/gen/msgget.3
@@ -60,7 +60,7 @@ or
does not have a message queue identifier associated with it, and the
.Dv IPC_CREAT
bit is set in
-.Fa msgflg.
+.Fa msgflg .
.Pp
If a new message queue is created, the data structure associated with it (the
.Va msqid_ds
diff --git a/lib/libc/gen/sysctl.3 b/lib/libc/gen/sysctl.3
index c4c39fd..82f1b74 100644
--- a/lib/libc/gen/sysctl.3
+++ b/lib/libc/gen/sysctl.3
@@ -186,7 +186,7 @@ The next and subsequent levels down are found in the include files
listed here, and described in separate sections below.
.Pp
.Bl -column CTLXMACHDEPXXX "Next level namesXXXXXX" -offset indent
-.It Sy Pa "Name Next level names Description"
+.It Sy "Name Next level names Description"
.It "CTL\_DEBUG sys/sysctl.h Debugging"
.It "CTL\_VFS sys/mount.h Filesystem"
.It "CTL\_HW sys/sysctl.h Generic CPU, I/O"
@@ -272,7 +272,7 @@ is detailed below.
The changeable column shows whether a process with appropriate
privilege may change the value.
.Bl -column "Second level nameXXXXXX" integerXXX -offset indent
-.It Sy Pa "Second level name Type Changeable"
+.It Sy "Second level name Type Changeable"
.It "HW\_MACHINE string no"
.It "HW\_MODEL string no"
.It "HW\_NCPU integer no"
@@ -318,7 +318,7 @@ system vnodes, the open file entries, routing table entries,
virtual memory statistics, load average history, and clock rate
information.
.Bl -column "KERNXMAXFILESPERPROCXXX" "struct clockrateXXX" -offset indent
-.It Sy Pa "Second level name Type Changeable"
+.It Sy "Second level name Type Changeable"
.It "KERN\_ARGMAX integer no"
.It "KERN\_BOOTFILE string yes"
.It "KERN\_BOOTTIME struct timeval no"
@@ -424,7 +424,7 @@ structures is returned,
whose size depends on the current number of such objects in the system.
The third and fourth level names are as follows:
.Bl -column "Third level nameXXXXXX" "Fourth level is:XXXXXX" -offset indent
-.It Pa "Third level name Fourth level is:"
+.It "Third level name Fourth level is:"
.It "KERN\_PROC\_ALL None"
.It "KERN\_PROC\_PID A process ID"
.It "KERN\_PROC\_PGRP A process group"
@@ -439,7 +439,7 @@ follow each other.
The total size of array is returned.
It is also possible for a process to set its own process title this way.
.Bl -column "Third level nameXXXXXX" "Fourth level is:XXXXXX" -offset indent
-.It Pa "Third level name Fourth level is:"
+.It Sy "Third level name Fourth level is:"
.It "KERN\_PROC\_ARGS A process ID"
.El
.It Li KERN_PROF
@@ -453,7 +453,7 @@ is detailed below.
The changeable column shows whether a process with appropriate
privilege may change the value.
.Bl -column "GPROFXGMONPARAMXXX" "struct gmonparamXXX" -offset indent
-.It Sy Pa "Third level name Type Changeable"
+.It Sy "Third level name Type Changeable"
.It "GPROF\_STATE integer yes"
.It "GPROF\_COUNT u_short[\|] yes"
.It "GPROF\_FROMS u_short[\|] yes"
@@ -503,7 +503,7 @@ followed by the vnode itself
The set of variables defined is architecture dependent.
The following variables are defined for the i386 architecture.
.Bl -column "CONSOLE_DEVICEXXX" "struct bootinfoXXX" -offset indent
-.It Sy Pa "Second level name Type Changeable"
+.It Sy "Second level name Type Changeable"
.It Li "CPU_CONSDEV dev_t no"
.It Li "CPU_ADJKERNTZ int yes"
.It Li "CPU_DISRTCSET int yes"
@@ -516,7 +516,7 @@ is detailed below.
The changeable column shows whether a process with appropriate
privilege may change the value.
.Bl -column "Second level nameXXXXXX" "routing messagesXXX" -offset indent
-.It Sy Pa "Second level name Type Changeable"
+.It Sy "Second level name Type Changeable"
.It "PF\_ROUTE routing messages no"
.It "PF\_INET IPv4 values yes"
.It "PF\_INET6 IPv6 values yes"
@@ -535,7 +535,7 @@ The fourth level name is an address family, which may be set to 0 to
select all address families.
The fifth and sixth level names are as follows:
.Bl -column "Fifth level nameXXXXXX" "Sixth level is:XXX" -offset indent
-.It Pa "Fifth level name Sixth level is:"
+.It Sy "Fifth level name Sixth level is:"
.It "NET\_RT\_FLAGS rtflags"
.It "NET\_RT\_DUMP None"
.It "NET\_RT\_IFLIST None"
@@ -547,7 +547,7 @@ The third level name is the protocol.
The fourth level name is the variable name.
The currently defined protocols and names are:
.Bl -column ProtocolXX VariableXX TypeXX ChangeableXX
-.It Pa "Protocol Variable Type Changeable"
+.It Sy "Protocol Variable Type Changeable"
.It "icmp bmcastecho integer yes"
.It "icmp maskrepl integer yes"
.It "ip forwarding integer yes"
@@ -598,7 +598,7 @@ is detailed below.
The changeable column shows whether a process with appropriate
privilege may change the value.
.Bl -column "USER_COLL_WEIGHTS_MAXXXX" "integerXXX" -offset indent
-.It Sy Pa "Second level name Type Changeable"
+.It Sy "Second level name Type Changeable"
.It "USER\_BC\_BASE\_MAX integer no"
.It "USER\_BC\_DIM\_MAX integer no"
.It "USER\_BC\_SCALE\_MAX integer no"
@@ -694,7 +694,7 @@ is detailed below.
The changeable column shows whether a process with appropriate
privilege may change the value.
.Bl -column "Second level nameXXXXXX" "struct loadavgXXX" -offset indent
-.It Sy Pa "Second level name Type Changeable"
+.It Sy "Second level name Type Changeable"
.It "VM\_LOADAVG struct loadavg no"
.It "VM\_METER struct vmtotal no"
.It "VM\_PAGEOUT\_ALGORITHM integer yes"
diff --git a/lib/libc/gen/syslog.3 b/lib/libc/gen/syslog.3
index 7ee51bb..e392a87 100644
--- a/lib/libc/gen/syslog.3
+++ b/lib/libc/gen/syslog.3
@@ -146,7 +146,7 @@ If
cannot pass the message to
.Xr syslogd 8
it will attempt to write the message to the console
-.Pq Dq Pa /dev/console.
+.Pq Dq Pa /dev/console .
.It Dv LOG_NDELAY
Open the connection to
.Xr syslogd 8
diff --git a/lib/libc/gen/tcsetattr.3 b/lib/libc/gen/tcsetattr.3
index d2bf500..58de728 100644
--- a/lib/libc/gen/tcsetattr.3
+++ b/lib/libc/gen/tcsetattr.3
@@ -184,7 +184,7 @@ The
.Fn cfmakeraw
function sets the flags stored in the termios structure to a state disabling
all input and output processing, giving a
-.Dq raw I/O path.
+.Dq raw I/O path .
It should be noted that there is no function to reverse this effect.
This is because there are a variety of processing options that could be
re-enabled and the correct method is for an application to snapshot the
diff --git a/lib/libc/gen/ttyname.3 b/lib/libc/gen/ttyname.3
index 5648c30..9141dfc 100644
--- a/lib/libc/gen/ttyname.3
+++ b/lib/libc/gen/ttyname.3
@@ -62,7 +62,7 @@ and named
.Pa /dev/tty Ns Em xx
and for which an entry exists
in the initialization file
-.Pa /etc/ttys.
+.Pa /etc/ttys .
(See
.Xr ttys 5 . )
.Pp
diff --git a/lib/libc/gen/tzset.3 b/lib/libc/gen/tzset.3
index d763e07..5ae5ec0 100644
--- a/lib/libc/gen/tzset.3
+++ b/lib/libc/gen/tzset.3
@@ -116,13 +116,11 @@ When
is used directly as a specification of the time conversion information,
it must have the following syntax (spaces inserted for clarity):
.Bd -filled -offset indent
-.Em std offset Bo
-.Em dst Bo
-.Em offset
-.Bc
+.Em std offset
.Bo
-.No , Em rule
-.Bc
+.Em dst
+.Bq Em offset
+.Bq , Em rule
.Bc
.Ed
.Pp
@@ -156,13 +154,13 @@ Indicates the value one must add to the local time to arrive at
Coordinated Universal Time. The
.Em offset
has the form:
-.Bd -unfilled -offset indent
+.Bd -ragged -offset indent
+.Sm off
.Em hh Bo
-.Pf \&: Em mm
-.Bo
-.Pf \&: Em ss
-.Bc
+.Em : mm
+.Bq Em : ss
.Bc
+.Sm on
.Ed
.Pp
The minutes
diff --git a/lib/libc/gen/uname.3 b/lib/libc/gen/uname.3
index 2c72472..0ad18d8 100644
--- a/lib/libc/gen/uname.3
+++ b/lib/libc/gen/uname.3
@@ -52,9 +52,9 @@ the current system into the structure referenced by
.Fa name .
.Pp
The
-.Li utsname
+.Vt utsname
structure is defined in the
-.Li <sys/utsname.h>
+.Aq Pa sys/utsname.h
header file, and contains the following members:
.Bl -tag -width nodenameXXXX -offset indent
.It sysname
diff --git a/lib/libc/gen/vis.3 b/lib/libc/gen/vis.3
index 118941b..105e1f9 100644
--- a/lib/libc/gen/vis.3
+++ b/lib/libc/gen/vis.3
@@ -100,7 +100,7 @@ characters from
.Fa src
(this
is useful for encoding a block of data that may contain
-.Dv NUL Ns 's).
+.Dv NUL Ns 's ) .
Both forms
.Dv NUL
terminate
diff --git a/lib/libc/locale/mbrune.3 b/lib/libc/locale/mbrune.3
index 1e68ae5..680b01e 100644
--- a/lib/libc/locale/mbrune.3
+++ b/lib/libc/locale/mbrune.3
@@ -98,7 +98,7 @@ The
function locates the first occurrence of the null-terminated string
.Fa pattern
in the null-terminated string
-.Fa string.
+.Fa string .
If
.Fa pattern
is the empty string,
diff --git a/lib/libc/locale/multibyte.3 b/lib/libc/locale/multibyte.3
index cf4093c..dff599d 100644
--- a/lib/libc/locale/multibyte.3
+++ b/lib/libc/locale/multibyte.3
@@ -150,7 +150,7 @@ function converts a multibyte character
.Fa mbchar
into a wide character and stores the result
in the object pointed to by
-.Fa wcharp.
+.Fa wcharp .
Up to
.Fa nbytes
bytes are examined.
diff --git a/lib/libc/locale/rune.3 b/lib/libc/locale/rune.3
index 087ef4c..a945274 100644
--- a/lib/libc/locale/rune.3
+++ b/lib/libc/locale/rune.3
@@ -159,7 +159,7 @@ is not
.Dv NULL ,
.Fa *result
will be set to
-.Dv NULL.
+.Dv NULL .
In all cases,
.Fn sputrune
will return the number of bytes which would be needed to store
@@ -266,7 +266,7 @@ These functions first appeared in
The
.Fn setrunelocale
function and the other non-ANSI rune functions were inspired by
-.Nm Plan 9 from Bell Labs
+.Sy "Plan 9 from Bell Labs"
as a much more sane alternative to the ANSI multibyte and
wide character support.
.\"They were conceived at the San Diego 1993 Summer USENIX conference by
diff --git a/lib/libc/locale/utf2.4 b/lib/libc/locale/utf2.4
index 3734dba..35eb3ad 100644
--- a/lib/libc/locale/utf2.4
+++ b/lib/libc/locale/utf2.4
@@ -49,7 +49,7 @@ The
.Nm UTF2
encoding is based on a proposed X-Open multibyte
\s-1FSS-UCS-TF\s+1 (File System Safe Universal Character Set Transformation Format) encoding as used in
-.Nm Plan 9 from Bell Labs.
+.Sy "Plan 9 from Bell Labs" .
Although it is capable of representing more than 16 bits,
the current implementation is limited to 16 bits as defined by the
Unicode Standard.
diff --git a/lib/libc/locale/utf2.5 b/lib/libc/locale/utf2.5
index 3734dba..35eb3ad 100644
--- a/lib/libc/locale/utf2.5
+++ b/lib/libc/locale/utf2.5
@@ -49,7 +49,7 @@ The
.Nm UTF2
encoding is based on a proposed X-Open multibyte
\s-1FSS-UCS-TF\s+1 (File System Safe Universal Character Set Transformation Format) encoding as used in
-.Nm Plan 9 from Bell Labs.
+.Sy "Plan 9 from Bell Labs" .
Although it is capable of representing more than 16 bits,
the current implementation is limited to 16 bits as defined by the
Unicode Standard.
diff --git a/lib/libc/net/if_indextoname.3 b/lib/libc/net/if_indextoname.3
index a0d4beb..adf82cb 100644
--- a/lib/libc/net/if_indextoname.3
+++ b/lib/libc/net/if_indextoname.3
@@ -57,11 +57,9 @@
.Fn if_freenameindex "struct if_nameindex *ptr"
.Sh DESCRIPTION
The functions map interface index to readable interface name
-.Po
-such as
-.Li ``lo0''
-.Pc
-, and vice versa.
+(such as
+.Dq Li lo0 ) ,
+and vice versa.
.Pp
.Fn if_nametoindex
converts readable interface name to interface index
@@ -76,13 +74,11 @@ argument must point to a buffer of at least
.Dv IF_NAMESIZE
bytes into which the interface name corresponding to the specified index is
returned.
-.Po
-.Dv IF_NAMESIZE
+.Dv ( IF_NAMESIZE
is also defined in
-.Li <net/if.h>
+.Aq Pa net/if.h
and its value includes a terminating null byte at the end of the
-interface name.
-.Pc
+interface name.)
This pointer is also the return value of the function.
If there is no interface corresponding to the specified index,
.Dv NULL
@@ -94,7 +90,7 @@ returns an array of
structures.
.Fa if_nametoindex
is also defined in
-.Li <net/if.h> ,
+.Aq Pa net/if.h ,
and is as follows:
.Bd -literal -offset
struct if_nameindex {
diff --git a/lib/libc/net/inet6_option_space.3 b/lib/libc/net/inet6_option_space.3
index 63cbfa5..8236548 100644
--- a/lib/libc/net/inet6_option_space.3
+++ b/lib/libc/net/inet6_option_space.3
@@ -81,17 +81,13 @@ ancillary data, including the
.Li cmsghdr
structure at the beginning,
and any padding at the end
-.Po
-to make its size a multiple of 8 bytes
-.Pc .
+(to make its size a multiple of 8 bytes).
The argument is the size of the structure defining the option,
which must include any pad bytes at the beginning
-.Po
-the value
+(the value
.Li y
in the alignment term
-.Dq Li xn + y
-.Pc ,
+.Dq Li "xn + y" ) ,
the type byte, the length byte, and the option data.
.Pp
Note: If multiple options are stored in a single ancillary data
@@ -181,17 +177,16 @@ before calling this function.
The option type must have a value from
.Li 2
to
-.Li 255 , inclusive.
-.Po
-.Li 0
+.Li 255 ,
+inclusive.
+.Li ( 0
and
.Li 1
are reserved for the
.Li Pad1
and
.Li PadN
-options, respectively.
-.Pc
+options, respectively.)
.Pp
The option data length must have a value between
.Li 0
@@ -249,12 +244,10 @@ initialized by
is the value of the option data length byte for this option.
This value is required as an argument to allow the function to
determine if padding must be appended at the end of the option.
-.Po
-The
+(The
.Fn inet6_option_append
function does not need a data length argument
-since the option data length must already be stored by the caller.
-.Pc
+since the option data length must already be stored by the caller.)
.Pp
.Fa multx
is the value
@@ -289,10 +282,8 @@ and
.Fa *tptrp
points to
the 8-bit option type field
-.Po
-which is followed by the 8-bit option
-data length, followed by the option data
-.Pc .
+(which is followed by the 8-bit option
+data length, followed by the option data).
If no more options remain
to be processed, the return value is
.Li -1
@@ -407,7 +398,8 @@ on an error.
.Pp
.Fn inet6_option_alloc
returns
-.Dv NULL on an error.
+.Dv NULL
+on an error.
.Pp
On errors,
.Fn inet6_option_next
diff --git a/lib/libc/net/inet6_rthdr_space.3 b/lib/libc/net/inet6_rthdr_space.3
index 26e5c35..2c3fd9c 100644
--- a/lib/libc/net/inet6_rthdr_space.3
+++ b/lib/libc/net/inet6_rthdr_space.3
@@ -212,10 +212,8 @@ When implemented, this should behave as follows.
.Pp
This function takes a Routing header that was received as ancillary
data
-.Po
-pointed to by the first argument,
-.Fa in
-.Pc
+(pointed to by the first argument,
+.Fa in )
and writes a new Routing
header that sends datagrams along the reverse of that route.
Both
@@ -238,10 +236,8 @@ The return value of the function is -1 upon an error.
.Ss inet6_rthdr_getaddr
This function returns a pointer to the IPv6 address specified by
.Fa index
-.Po
-which must have a value between 1 and the value returned by
-.Fn inet6_rthdr_segments
-.Pc
+(which must have a value between 1 and the value returned by
+.Fn inet6_rthdr_segments )
in the Routing header described by
.Fa cmsg .
An
@@ -255,11 +251,9 @@ Upon an error the return value of the function is
.Ss inet6_rthdr_getflags
This function returns the flags value specified by
.Fa index
-.Po
-which must
+(which must
have a value between 0 and the value returned by
-.Fn inet6_rthdr_segments
-.Pc
+.Fn inet6_rthdr_segments )
in the Routing header described by
.Fa cmsg .
For an IPv6 Type 0 Routing header the return value will be either
diff --git a/lib/libc/net/resolver.3 b/lib/libc/net/resolver.3
index dedcde1..1fb97f5 100644
--- a/lib/libc/net/resolver.3
+++ b/lib/libc/net/resolver.3
@@ -305,7 +305,8 @@ as the name is compressed.
If
.Em dnptr
is
-.Dv NULL, names are not compressed.
+.Dv NULL ,
+names are not compressed.
If
.Fa lastdnptr
is
diff --git a/lib/libc/stdio/printf.3 b/lib/libc/stdio/printf.3
index 308a1b4..ecf7f3a 100644
--- a/lib/libc/stdio/printf.3
+++ b/lib/libc/stdio/printf.3
@@ -86,7 +86,7 @@ as described below.
and
.Fn vprintf
write output to
-.Em stdout,
+.Em stdout ,
the standard output stream;
.Fn fprintf
and
diff --git a/lib/libc/stdio/stdio.3 b/lib/libc/stdio/stdio.3
index b4cd7da..657b308 100644
--- a/lib/libc/stdio/stdio.3
+++ b/lib/libc/stdio/stdio.3
@@ -42,9 +42,9 @@
.Lb libc
.Sh SYNOPSIS
.Fd #include <stdio.h>
-.Fd FILE *stdin;
-.Fd FILE *stdout;
-.Fd FILE *stderr;
+.Vt FILE *stdin ;
+.Vt FILE *stdout ;
+.Vt FILE *stderr ;
.Sh DESCRIPTION
The standard
.Tn I/O
@@ -179,9 +179,9 @@ without first removing their current definitions with
.Dv FOPEN_MAX ,
.Dv L_cuserid ,
.Dv L_ctermid ,
-.Dv L_tmpnam,
+.Dv L_tmpnam ,
.Dv NULL ,
-.Dv P_tmpdir,
+.Dv P_tmpdir ,
.Dv SEEK_CUR ,
.Dv SEEK_END ,
.Dv SEEK_SET ,
diff --git a/lib/libc/stdlib/getenv.3 b/lib/libc/stdlib/getenv.3
index 4753dfb..d1122ef 100644
--- a/lib/libc/stdlib/getenv.3
+++ b/lib/libc/stdlib/getenv.3
@@ -89,7 +89,7 @@ If the variable
.Ar name
does not exist in the list,
it is inserted with the given
-.Ar value.
+.Ar value .
If the variable does exist, the argument
.Ar overwrite
is tested; if
diff --git a/lib/libc/stdlib/malloc.3 b/lib/libc/stdlib/malloc.3
index e9e4d20..bc1a272 100644
--- a/lib/libc/stdlib/malloc.3
+++ b/lib/libc/stdlib/malloc.3
@@ -40,7 +40,7 @@
.Dt MALLOC 3
.Os FreeBSD
.Sh NAME
-.Nm malloc, calloc, realloc, free, reallocf
+.Nm malloc , calloc , realloc , free , reallocf
.Nd general purpose memory allocation functions
.Sh LIBRARY
.Lb libc
@@ -59,7 +59,7 @@
.Ft char *
.Va _malloc_options
.Ft void
-.Va (*_malloc_message)(char *p1, char *p2, char *p3, char *p4)
+.Fn \*(lp*_malloc_message\*(rp "char *p1" "char *p2" "char *p3" "char *p4"
.Sh DESCRIPTION
The
.Fn malloc
diff --git a/lib/libc/stdlib/qsort.3 b/lib/libc/stdlib/qsort.3
index 15e1690..1192721 100644
--- a/lib/libc/stdlib/qsort.3
+++ b/lib/libc/stdlib/qsort.3
@@ -40,7 +40,7 @@
.Dt QSORT 3
.Os
.Sh NAME
-.Nm qsort, heapsort, mergesort
+.Nm qsort , heapsort , mergesort
.Nd sort functions
.Sh LIBRARY
.Lb libc
diff --git a/lib/libc/stdlib/strtol.3 b/lib/libc/stdlib/strtol.3
index efa4385..528b6d3 100644
--- a/lib/libc/stdlib/strtol.3
+++ b/lib/libc/stdlib/strtol.3
@@ -40,7 +40,7 @@
.Dt STRTOL 3
.Os
.Sh NAME
-.Nm strtol, strtoq
+.Nm strtol , strtoq
.Nd convert string value to a long or quad_t integer
.Sh LIBRARY
.Lb libc
diff --git a/lib/libc/stdlib/strtoul.3 b/lib/libc/stdlib/strtoul.3
index 1bde3e9..01c092f 100644
--- a/lib/libc/stdlib/strtoul.3
+++ b/lib/libc/stdlib/strtoul.3
@@ -40,7 +40,7 @@
.Dt STRTOUL 3
.Os
.Sh NAME
-.Nm strtoul, strtouq
+.Nm strtoul , strtouq
.Nd "convert a string to an unsigned long or uquad_t integer"
.Sh LIBRARY
.Lb libc
diff --git a/lib/libc/stdlib/tsearch.3 b/lib/libc/stdlib/tsearch.3
index 051eea4..a474a69 100644
--- a/lib/libc/stdlib/tsearch.3
+++ b/lib/libc/stdlib/tsearch.3
@@ -31,7 +31,7 @@
.Dt TSEARCH 3
.Os
.Sh NAME
-.Nm tsearch, tfind, tdelete, twalk
+.Nm tsearch , tfind , tdelete , twalk
.Nd manipulate binary search trees
.Sh SYNOPSIS
.Fd #include <search.h>
diff --git a/lib/libc/string/bstring.3 b/lib/libc/string/bstring.3
index c79eb94..873c785 100644
--- a/lib/libc/string/bstring.3
+++ b/lib/libc/string/bstring.3
@@ -45,7 +45,7 @@
.Nm memchr ,
.Nm memcmp ,
.Nm memcpy ,
-.Nm memmove,
+.Nm memmove ,
.Nm memset
.Nd byte string operations
.Sh LIBRARY
diff --git a/lib/libc/string/strcat.3 b/lib/libc/string/strcat.3
index 77fd0d27..fbb2996 100644
--- a/lib/libc/string/strcat.3
+++ b/lib/libc/string/strcat.3
@@ -74,7 +74,7 @@ appends not more than
characters from
.Fa append ,
and then adds a terminating
-.Ql \e0.
+.Ql \e0 .
.Sh RETURN VALUES
The
.Fn strcat
diff --git a/lib/libc/string/strerror.3 b/lib/libc/string/strerror.3
index 762f89d..1799c1c 100644
--- a/lib/libc/string/strerror.3
+++ b/lib/libc/string/strerror.3
@@ -95,7 +95,7 @@ If
.Fa errnum
is not a recognized error number,
the error message string will contain
-.Dq Li "Unknown error:\0
+.Dq Li "Unknown error:\ "
followed by the error number in decimal.
.Pp
The message strings can be accessed directly using the external
diff --git a/lib/libc/string/string.3 b/lib/libc/string/string.3
index 8a83a37..1131b6d 100644
--- a/lib/libc/string/string.3
+++ b/lib/libc/string/string.3
@@ -44,14 +44,14 @@
.Nm strrchr ,
.Nm strcmp ,
.Nm strncmp ,
-.Nm strcasecmp,
+.Nm strcasecmp ,
.Nm strncasecmp ,
.Nm strcpy ,
.Nm strncpy ,
.Nm strerror ,
.Nm strlen ,
.Nm strpbrk ,
-.Nm strsep,
+.Nm strsep ,
.Nm strspn ,
.Nm strcspn ,
.Nm strstr ,
diff --git a/lib/libc/string/strtok.3 b/lib/libc/string/strtok.3
index 5a3c907..ea28f94 100644
--- a/lib/libc/string/strtok.3
+++ b/lib/libc/string/strtok.3
@@ -54,7 +54,7 @@
.Dt STRTOK 3
.Os FreeBSD
.Sh NAME
-.Nm strtok, strtok_r
+.Nm strtok , strtok_r
.Nd string tokens
.Sh LIBRARY
.Lb libc
@@ -165,7 +165,9 @@ Since this implementation always alters the next starting point,
such a sequence of calls would always return
.Dv NULL .
.Sh AUTHORS
-.An Wes Peters, Softweyr LLC: Aq wes@softweyr.com
+.An Wes Peters ,
+Softweyr LLC:
+.Aq wes@softweyr.com
.Pp
Based on the
.Fx 3.0
diff --git a/lib/libc/sys/aio_waitcomplete.2 b/lib/libc/sys/aio_waitcomplete.2
index 0e586d5..c554673 100644
--- a/lib/libc/sys/aio_waitcomplete.2
+++ b/lib/libc/sys/aio_waitcomplete.2
@@ -35,7 +35,7 @@
.Sh SYNOPSIS
.Fd #include <aio.h>
.Ft int
-.Fn aio_waitcomplete "struct aiocb **iocbp, struct timespec *timeout"
+.Fn aio_waitcomplete "struct aiocb **iocbp" "struct timespec *timeout"
.Sh DESCRIPTION
The
.Fn aio_waitcomplete
diff --git a/lib/libc/sys/brk.2 b/lib/libc/sys/brk.2
index 09072a4..7f40e34 100644
--- a/lib/libc/sys/brk.2
+++ b/lib/libc/sys/brk.2
@@ -99,11 +99,11 @@ beyond the
value returned from a call to
.Xr getrlimit 2 ,
e.g.\&
-.Dq etext + rlp\(->rlim_max.
+.Dq Va etext No + Va rlp\->rlim_max .
(See
.Xr end 3
for the definition of
-.Em etext ) .
+.Va etext ) .
.Sh RETURN VALUES
.Fn Brk
returns 0 if successful;
diff --git a/lib/libc/sys/execve.2 b/lib/libc/sys/execve.2
index 0467118..32dd4d8 100644
--- a/lib/libc/sys/execve.2
+++ b/lib/libc/sys/execve.2
@@ -105,7 +105,7 @@ The argument
is also a pointer to a null-terminated array of
character pointers to null-terminated strings.
A pointer to this array is normally stored in the global variable
-.Va environ.
+.Va environ .
These strings pass information to the
new process that is not directly an argument to the command (see
.Xr environ 7 ) .
diff --git a/lib/libc/sys/fcntl.2 b/lib/libc/sys/fcntl.2
index 49522c7..0b2ec89 100644
--- a/lib/libc/sys/fcntl.2
+++ b/lib/libc/sys/fcntl.2
@@ -193,11 +193,11 @@ taken as a pointer to a
(see above).
.Dv F_SETLK
is used to establish shared (or read) locks
-.Dv (F_RDLCK)
+.Pq Dv F_RDLCK
or exclusive (or write) locks,
-.Dv (F_WRLCK) ,
+.Pq Dv F_WRLCK ,
as well as remove either type of lock
-.Dv (F_UNLCK) .
+.Pq Dv F_UNLCK .
If a shared or exclusive lock cannot be set,
.Fn fcntl
returns immediately with
@@ -392,11 +392,11 @@ The argument
is
.Dv F_SETLK ,
the type of lock
-.Fa (l_type)
+.Pq Fa l_type
is a shared lock
-.Dv (F_RDLCK)
+.Pq Dv F_RDLCK
or exclusive lock
-.Dv (F_WRLCK) ,
+.Pq Dv F_WRLCK ,
and the segment of a file to be locked is already
exclusive-locked by another process;
or the type is an exclusive lock and some portion of the
@@ -413,9 +413,9 @@ is
or
.Dv F_SETLKW ,
the type of lock
-.Fa (l_type)
+.Pq Fa l_type
is a shared lock
-.Dv (F_RDLCK) ,
+.Pq Dv F_RDLCK ,
and
.Fa fildes
is not a valid file descriptor open for reading.
@@ -427,9 +427,9 @@ is
or
.Dv F_SETLKW ,
the type of lock
-.Fa (l_type)
+.Pq Fa l_type
is an exclusive lock
-.Dv (F_WRLCK) ,
+.Pq Dv F_WRLCK ,
and
.Fa fildes
is not a valid file descriptor open for writing.
diff --git a/lib/libc/sys/fhopen.2 b/lib/libc/sys/fhopen.2
index 75af67f..dbe10a7 100644
--- a/lib/libc/sys/fhopen.2
+++ b/lib/libc/sys/fhopen.2
@@ -54,7 +54,7 @@
.Fn fhstatfs "const fhandle_t *fhp" "struct statfs *buf"
.Sh DESCRIPTION
These functions provide a means to access a file given the file handle
-.Fa fhp.
+.Fa fhp .
As this method bypasses directory access restrictions, these calls are
restricted to the superuser.
.Pp
diff --git a/lib/libc/sys/getdirentries.2 b/lib/libc/sys/getdirentries.2
index 4dab8a6..f883fec 100644
--- a/lib/libc/sys/getdirentries.2
+++ b/lib/libc/sys/getdirentries.2
@@ -137,7 +137,8 @@ Alternatively, the current position pointer may be set and retrieved by
The current position pointer should only be set to a value returned by
.Xr lseek 2 ,
a value returned in the location pointed to by
-.Fa basep ( Ns Fn getdirentries
+.Fa basep
+.Pf ( Fn getdirentries
only)
or zero.
.Sh IMPLEMENTATION NOTES
diff --git a/lib/libc/sys/getlogin.2 b/lib/libc/sys/getlogin.2
index a631bfb..4015da5 100644
--- a/lib/libc/sys/getlogin.2
+++ b/lib/libc/sys/getlogin.2
@@ -86,8 +86,8 @@ is normally used only when a new session is being created on behalf
of the named user
(for example, at login time, or when a remote shell is invoked).
.Pp
-.Em NOTE:
-There is only one `login name' per `session .
+.Em NOTE :
+There is only one login name per session.
.Pp
It is
.Em CRITICALLY
@@ -107,9 +107,9 @@ which is an ideal way of detaching from a controlling terminal and
forking into the background.
.Pp
In particular, doing a
-.Fn ioctl ttyfd TIOCNOTTY ...
+.Fn ioctl ttyfd TIOCNOTTY ...\&
or
-.Fn setpgrp ...
+.Fn setpgrp ...\&
is
.Em NOT
sufficient.
diff --git a/lib/libc/sys/getsockopt.2 b/lib/libc/sys/getsockopt.2
index dd6ae3a..deb70b9 100644
--- a/lib/libc/sys/getsockopt.2
+++ b/lib/libc/sys/getsockopt.2
@@ -191,7 +191,8 @@ are queued on socket and a
.Xr close 2
is performed.
If the socket promises reliable delivery of data and
-.Dv SO_LINGER is set,
+.Dv SO_LINGER
+is set,
the system will block the process on the
.Xr close 2
attempt until it is able to transmit the data or until it decides it
diff --git a/lib/libc/sys/kill.2 b/lib/libc/sys/kill.2
index 8ce5c71..5a7c05c 100644
--- a/lib/libc/sys/kill.2
+++ b/lib/libc/sys/kill.2
@@ -75,7 +75,7 @@ to any descendant of the current process.
.It \&If Fa pid No \&is greater than zero :
.Fa Sig
is sent to the process whose ID is equal to
-.Fa pid.
+.Fa pid .
.It \&If Fa pid No \&is zero :
.Fa Sig
is sent to all processes whose group ID is equal
diff --git a/lib/libc/sys/listen.2 b/lib/libc/sys/listen.2
index 11f8fd2..3a98629 100644
--- a/lib/libc/sys/listen.2
+++ b/lib/libc/sys/listen.2
@@ -60,7 +60,7 @@ The
call applies only to sockets of type
.Dv SOCK_STREAM
or
-.Dv SOCK_SEQPACKET.
+.Dv SOCK_SEQPACKET .
.Pp
The
.Fa backlog
@@ -76,15 +76,15 @@ the request may be ignored so that retries may succeed.
The
.Xr sysctl 3
MIB variable
-.Dq Li kern.ipc.somaxconn
+.Dq Va kern.ipc.somaxconn
specifies a hard limit on
.Fa backlog ;
-if a value greater than
-.Li kern.ipc.somaxconn
+if a value greater than
+.Va kern.ipc.somaxconn
or less than zero is specified,
.Fa backlog
is silently forced to
-.Li kern.ipc.somaxconn .
+.Va kern.ipc.somaxconn .
.Sh IMPLEMENTATION NOTES
.Pp
In the non-threaded library
diff --git a/lib/libc/sys/lseek.2 b/lib/libc/sys/lseek.2
index 5ca26cb..5cc0f22 100644
--- a/lib/libc/sys/lseek.2
+++ b/lib/libc/sys/lseek.2
@@ -53,7 +53,7 @@ to the
argument
.Fa offset
according to the directive
-.Fa whence.
+.Fa whence .
The argument
.Fa fildes
must be an open
diff --git a/lib/libc/sys/ptrace.2 b/lib/libc/sys/ptrace.2
index 708f9ac..c91b2d1 100644
--- a/lib/libc/sys/ptrace.2
+++ b/lib/libc/sys/ptrace.2
@@ -54,9 +54,7 @@ that the process expects to be traced by its parent. All the other
arguments are ignored. (If the parent process does not expect to trace
the child, it will probably be rather confused by the results; once the
traced process stops, it cannot be made to continue except via
-.Eo \&
-.Fn ptrace
-.Ec \&.)
+.Fn ptrace . )
When a process has used this request and calls
.Xr execve 2
or any of the routines built on it
@@ -69,7 +67,7 @@ Also, any setuid or setgid bits on the executable being executed will
be ignored.
.It Dv PT_READ_I , Dv PT_READ_D
These requests read a single
-.Li int
+.Vt int
of data from the traced process' address space. Traditionally,
.Fn ptrace
has allowed for machines with distinct address spaces for instruction
@@ -99,12 +97,12 @@ except that they write rather than read. The
argument supplies the value to be written.
.It Dv PT_READ_U
This request reads an
-.Li int
+.Vt int
from the traced process' user structure. The
.Fa addr
argument specifies the location of the int relative to the base of the
user structure; it will usually be an integer value cast to
-.Li caddr_t
+.Vt caddr_t
either explicitly or via the presence of a prototype for
.Eo \&
.Fn ptrace
@@ -115,14 +113,14 @@ and
.Dv PT_READ_D ,
.Fa addr
must be aligned on an
-.Li int
+.Vt int
boundary. The value read is returned as the return value from
.Eo \&
.Fn ptrace
.Ec .
.It Dv PT_WRITE_U
This request writes an
-.Li int
+.Vt int
into the traced process' user structure.
.Fa addr
specifies the offset, just as for
@@ -138,7 +136,9 @@ The traced process continues execution.
.Fa addr
is an address specifying the place where execution is to be resumed (a
new value for the program counter), or
-.Li (caddr_t)1
+.Po
+.Vt caddr_t
+.Pc Ns 1
to indicate that execution is to pick up where it left off.
.Fa data
provides a signal number to be delivered to the traced process as it
@@ -180,7 +180,9 @@ are:
.Bl -tag -width 12n
.It Dv PT_GETREGS
This request reads the traced process' machine registers into the
-.Dq Li "struct reg"
+.Do
+.Vt "struct reg"
+.Dc
(defined in
.Aq Pa machine/reg.h )
pointed to by
@@ -189,7 +191,9 @@ pointed to by
This request is the converse of
.Dv PT_GETREGS ;
it loads the traced process' machine registers from the
-.Dq Li "struct reg"
+.Do
+.Vt "struct reg"
+.Dc
(defined in
.Aq Pa machine/reg.h )
pointed to by
@@ -197,7 +201,9 @@ pointed to by
.It Dv PT_GETFPREGS
This request reads the traced process' floating-point registers into
the
-.Dq Li "struct fpreg"
+.Do
+.Vt "struct fpreg"
+.Dc
(defined in
.Aq Pa machine/reg.h )
pointed to by
@@ -206,7 +212,9 @@ pointed to by
This request is the converse of
.Dv PT_GETFPREGS ;
it loads the traced process' floating-point registers from the
-.Dq Li "struct fpreg"
+.Do
+.Vt "struct fpreg"
+.Dc
(defined in
.Aq Pa machine/reg.h )
pointed to by
@@ -214,7 +222,9 @@ pointed to by
.It Dv PT_GETDBREGS
This request reads the traced process' debug registers into
the
-.Dq Li "struct dbreg"
+.Do
+.Vt "struct dbreg"
+.Dc
(defined in
.Aq Pa machine/reg.h )
pointed to by
@@ -223,7 +233,9 @@ pointed to by
This request is the converse of
.Dv PT_GETDBREGS ;
it loads the traced process' debug registers from the
-.Dq Li "struct dbreg"
+.Do
+.Vt "struct dbreg"
+.Dc
(defined in
.Aq Pa machine/reg.h )
pointed to by
@@ -265,7 +277,7 @@ to
or
.Dv PT_WRITE_U
was not
-.Li int Ns \&-aligned.
+.Vt int Ns \-aligned .
.It
The signal number (in
.Fa data )
diff --git a/lib/libc/sys/recv.2 b/lib/libc/sys/recv.2
index 88d7a4a..1c543fd 100644
--- a/lib/libc/sys/recv.2
+++ b/lib/libc/sys/recv.2
@@ -210,7 +210,7 @@ Process credentials can also be passed as ancillary data for
domain sockets using a
.Fa cmsg_type
of
-.Dv SCM_CREDS.
+.Dv SCM_CREDS .
In this case,
.Fa cmsg_data
should be a structure of type
diff --git a/lib/libc/sys/semget.2 b/lib/libc/sys/semget.2
index cdcd964..dc22c0a 100644
--- a/lib/libc/sys/semget.2
+++ b/lib/libc/sys/semget.2
@@ -84,13 +84,13 @@ parameter:
Read access for user.
.It Dv SEM_A
Alter access for user.
-.It Dv (SEM_R>>3)
+.It Dv ( SEM_R>>3 )
Read access for group.
-.It Dv (SEM_A>>3)
+.It Dv ( SEM_A>>3 )
Alter access for group.
-.It Dv (SEM_R>>6)
+.It Dv ( SEM_R>>6 )
Read access for other.
-.It Dv (SEM_A>>6)
+.It Dv ( SEM_A>>6 )
Alter access for other.
.El
.Pp
diff --git a/lib/libc/sys/shmget.2 b/lib/libc/sys/shmget.2
index 88d3b4a..05bc68c 100644
--- a/lib/libc/sys/shmget.2
+++ b/lib/libc/sys/shmget.2
@@ -82,13 +82,13 @@ parameter:
Read access for user.
.It Dv SHM_W
Write access for user.
-.It Dv (SHM_R>>3)
+.It Dv ( SHM_R>>3 )
Read access for group.
-.It Dv (SHM_W>>3)
+.It Dv ( SHM_W>>3 )
Write access for group.
-.It Dv (SHM_R>>6)
+.It Dv ( SHM_R>>6 )
Read access for other.
-.It Dv (SHM_W>>6)
+.It Dv ( SHM_W>>6 )
Write access for other.
.El
.\"
diff --git a/lib/libc/sys/socket.2 b/lib/libc/sys/socket.2
index 1cf4616..7049bc1 100644
--- a/lib/libc/sys/socket.2
+++ b/lib/libc/sys/socket.2
@@ -168,7 +168,7 @@ and
calls.
(Some protocol families, such as the Internet family,
support the notion of an
-.Dq implied connect,
+.Dq implied connect ,
which permits data to be sent piggybacked onto a connect operation by
using the
.Xr sendto 2
diff --git a/lib/libc_r/man/pthread_cond_wait.3 b/lib/libc_r/man/pthread_cond_wait.3
index 9d70318..ccbf138 100644
--- a/lib/libc_r/man/pthread_cond_wait.3
+++ b/lib/libc_r/man/pthread_cond_wait.3
@@ -48,7 +48,8 @@ variable specified by
and unblocks the mutex specified by
.Fa mutex .
The waiting thread unblocks only after another thread calls
-.Xr pthread_cond_signal 3 , or
+.Xr pthread_cond_signal 3 ,
+or
.Xr pthread_cond_broadcast 3
with the same condition variable, and the current thread requires the lock
on
diff --git a/lib/libc_r/man/pthread_testcancel.3 b/lib/libc_r/man/pthread_testcancel.3
index c1bbc7d..c27c16d 100644
--- a/lib/libc_r/man/pthread_testcancel.3
+++ b/lib/libc_r/man/pthread_testcancel.3
@@ -195,5 +195,5 @@ conforms to ISO/IEC 9945-1 ANSI/IEEE
Std 1003.1 Second Edition 1996-07-12.
.Sh AUTHORS
This man page was written by
-.An David Leonard <d@openbsd.org>
+.An David Leonard Aq d@openbsd.org
for the OpenBSD implementation of pthread_cancel.
diff --git a/lib/libcompat/4.3/lsearch.3 b/lib/libcompat/4.3/lsearch.3
index fe494f3..3e0ba94 100644
--- a/lib/libcompat/4.3/lsearch.3
+++ b/lib/libcompat/4.3/lsearch.3
@@ -37,7 +37,7 @@
.Os
.Sh NAME
.Nm lsearch ,
-.Nm lfind,
+.Nm lfind
.Nd linear searching routines
.Sh LIBRARY
.Lb libcompat
diff --git a/lib/libcompat/4.3/re_comp.3 b/lib/libcompat/4.3/re_comp.3
index 16f75cf..10cd0a8 100644
--- a/lib/libcompat/4.3/re_comp.3
+++ b/lib/libcompat/4.3/re_comp.3
@@ -91,7 +91,7 @@ and
.Fn re_exec
may have trailing or embedded newline characters;
they are terminated by
-.Dv NUL Ns s.
+.Dv NUL Ns s .
The regular expressions recognized are described in the manual entry for
.Xr ed 1 ,
given the above difference.
diff --git a/lib/libcompat/4.3/rexec.3 b/lib/libcompat/4.3/rexec.3
index 6101d1a..baa4601 100644
--- a/lib/libcompat/4.3/rexec.3
+++ b/lib/libcompat/4.3/rexec.3
@@ -74,7 +74,7 @@ specifies which well-known
.Tn DARPA
Internet port to use for
the connection; the call
-.Ql getservbyname(\\*qexec\\*q, \\*qtcp\\*q)
+.Fn getservbyname \*qexec\*q \*qtcp\*q
(see
.Xr getservent 3 )
will return a pointer to a structure, which contains the
diff --git a/lib/libdevstat/devstat.3 b/lib/libdevstat/devstat.3
index 8b8ff14..67e06e8 100644
--- a/lib/libdevstat/devstat.3
+++ b/lib/libdevstat/devstat.3
@@ -518,7 +518,7 @@ The
statistics system first appeared in
.Fx 3.0 .
.Sh AUTHORS
-.An Kenneth Merry Aq ken@FreeBSD.ORG
+.An Kenneth Merry Aq ken@FreeBSD.org
.Sh BUGS
There should probably be an interface to de-allocate memory allocated by
.Fn getdevs ,
diff --git a/lib/libdisk/libdisk.3 b/lib/libdisk/libdisk.3
index db582ec..e097cba 100644
--- a/lib/libdisk/libdisk.3
+++ b/lib/libdisk/libdisk.3
@@ -66,7 +66,7 @@
.Fd #include <sys/types.h>
.Fd #include <libdisk.h>
.Pp
-.Dv extern const char *chunk_n[];
+.Vt extern const char *chunk_n[] ;
.Ft const char *
.Fn slice_type_name "int type" "int subtype"
.Ft struct disk *
diff --git a/lib/libedit/editline.3 b/lib/libedit/editline.3
index 8dfa4eb..e968818 100644
--- a/lib/libedit/editline.3
+++ b/lib/libedit/editline.3
@@ -198,7 +198,7 @@ Refer to
.Xr editrc 5
for more information.
.Pp
-.Em NOTE:
+.Em NOTE :
.Va argv[0]
may be modified by
.Fn el_parse .
@@ -348,7 +348,7 @@ Expecting further command input as arguments, do nothing visually.
Refresh display.
.It Dv CC_CURSOR
Cursor moved, so update and perform
-.Dv CC_REFRESH.
+.Dv CC_REFRESH .
.It Dv CC_REDISPLAY
Redisplay entire input line.
This is useful if a key binding outputs extra information.
@@ -420,8 +420,7 @@ Delete
characters before the cursor.
.It Fn el_data_set
Set the user data to
-.Fa data
-.
+.Fa data .
.It Fn el_data_get
Get the user data.
.El
diff --git a/lib/libftpio/ftpio.3 b/lib/libftpio/ftpio.3
index 6815992..6d12149 100644
--- a/lib/libftpio/ftpio.3
+++ b/lib/libftpio/ftpio.3
@@ -49,31 +49,31 @@
.Ft FILE *
.Fn ftpLogin "char *host" "char *user" "char *passwd" "int ftp_port" "int verbose" "int *retcode"
.Ft int
-.Fn ftpChdir "FILE *stream, char *dirname"
+.Fn ftpChdir "FILE *stream" "char *dirname"
.Ft int
.Fn ftpErrno "FILE *stream"
.Ft const char *
.Fn ftpErrString "int errno"
.Ft time_t
-.Fn ftpGetModtime "FILE *stream, char *file"
+.Fn ftpGetModtime "FILE *stream" "char *file"
.Ft off_t
-.Fn ftpGetSize "FILE *stream, char *file"
+.Fn ftpGetSize "FILE *stream" "char *file"
.Ft FILE *
-.Fn ftpGet "FILE *stream, char *file, off_t *seekto"
+.Fn ftpGet "FILE *stream" "char *file" "off_t *seekto"
.Ft FILE *
-.Fn ftpPut "FILE *stream, char *file"
+.Fn ftpPut "FILE *stream" "char *file"
.Ft int
.Fn ftpAscii "FILE *stream"
.Ft int
.Fn ftpBinary "FILE *stream"
.Ft int
-.Fn ftpPassive "FILE *stream, int status"
+.Fn ftpPassive "FILE *stream" "int status"
.Ft void
-.Fn ftpVerbose "FILE *stream, int status"
+.Fn ftpVerbose "FILE *stream" "int status"
.Ft FILE *
-.Fn ftpGetURL "char *url, char *user, char *passwd, int *retcode"
+.Fn ftpGetURL "char *url" "char *user" "char *passwd" "int *retcode"
.Ft FILE *
-.Fn ftpPutURL "char *url, char *user, char *passwd, int *retcode"
+.Fn ftpPutURL "char *url" "char *user" "char *passwd" "int *retcode"
.Ft int
.Fn ftpLoginAf "char *host" "int af" "char *user" "char *passwd" "int ftp_port" "int verbose" "int *retcode"
.Ft FILE *
@@ -86,7 +86,7 @@ These functions implement a high-level library for managing FTP connections.
.Fn ftpLogin
attempts to log in using the supplied
.Fa user ,
-.Fa passwd,
+.Fa passwd ,
.Fa ftp_port
(if passed as 0,
.Fa ftp_port
@@ -101,7 +101,7 @@ will have the error code returned by the foreign server.
.Pp
.Fn ftpChdir
attempts to issue a server CD command to the directory named in
-.Fa dir.
+.Fa dir .
On success, zero is returned. On failure, the error code from the server.
.Pp
.Fn ftpErrno
diff --git a/lib/libipsec/ipsec_strerror.3 b/lib/libipsec/ipsec_strerror.3
index d0d3977..66ae950 100644
--- a/lib/libipsec/ipsec_strerror.3
+++ b/lib/libipsec/ipsec_strerror.3
@@ -44,8 +44,9 @@
.Sh DESCRIPTION
.Pa netinet6/ipsec.h
declares
-.Pp
-.Dl extern int ipsec_errcode;
+.Bd -ragged -offset indent
+.Vt extern int ipsec_errcode ;
+.Ed
.Pp
which is used to pass error code from IPsec policy manipulation library
to user program.
diff --git a/lib/libkvm/kvm_getfiles.3 b/lib/libkvm/kvm_getfiles.3
index 2ae572d..ec4df46 100644
--- a/lib/libkvm/kvm_getfiles.3
+++ b/lib/libkvm/kvm_getfiles.3
@@ -56,7 +56,7 @@
.Sh DESCRIPTION
.Fn kvm_getfiles
returns a (sub-)set of the open files in the kernel indicated by
-.Fa kd.
+.Fa kd .
The
.Fa op
and
diff --git a/lib/libkvm/kvm_getprocs.3 b/lib/libkvm/kvm_getprocs.3
index dea79f8..c823cf5 100644
--- a/lib/libkvm/kvm_getprocs.3
+++ b/lib/libkvm/kvm_getprocs.3
@@ -60,7 +60,7 @@
.Sh DESCRIPTION
.Fn kvm_getprocs
returns a (sub-)set of active processes in the kernel indicated by
-.Fa kd.
+.Fa kd .
The
.Fa op
and
diff --git a/lib/libkvm/kvm_getswapinfo.3 b/lib/libkvm/kvm_getswapinfo.3
index 9085661..5e41d3e 100644
--- a/lib/libkvm/kvm_getswapinfo.3
+++ b/lib/libkvm/kvm_getswapinfo.3
@@ -21,14 +21,25 @@
.Sh DESCRIPTION
The
.Fn kvm_getswapinfo
-function fills an array of kvm_swap structures with swap summary
-information for each swap device, for up to maxswap - 1 devices.
-The number of devices, up to maxswap - 1, is returned. A grand
-total of all swap devices ( including any devices that go beyond
-maxswap - 1 ) is returned in one additional array entry. This
-entry is not counted in the return value. Thus, if you specify
-a maxswap value of 1, the function will typically return the
-value 0 and the single kvm_swap structure will be filled with
+function fills an array of
+.Vt kvm_swap
+structures with swap summary
+information for each swap device, for up to
+.Fa maxswap
+\- 1 devices.
+The number of devices, up to
+.Fa maxswap
+\- 1, is returned. A grand
+total of all swap devices (including any devices that go beyond
+.Fa maxswap
+\- 1) is returned in one additional array entry. This
+entry is not counted in the return value.
+Thus, if you specify a
+.Fa maxswap
+value of 1, the function will typically return the
+value 0 and the single
+.Vt kvm_swap
+structure will be filled with
the grand total over all swap devices. The grand total is calculated
from all available swap devices whether or not you made room
for them all in the array.
@@ -38,21 +49,36 @@ The flags argument is currently unused and must be passed as 0.
.Pp
If an error occurs, -1 is returned.
.Pp
-Each swap partition and the grand total is summarized in the kvm_swap
+Each swap partition and the grand total is summarized in the
+.Vt kvm_swap
structure. This structure contains the following fields:
-.Bl -inset -width indent
-.It char ksw_devname[];
-.It int ksw_total;
-.It int ksw_used;
-.It int ksw_flags;
+.Pp
+.Bl -item -offset indent -compact
+.It
+.Va char ksw_devname[] ;
+.It
+.Va int ksw_total ;
+.It
+.Va int ksw_used ;
+.It
+.Va int ksw_flags ;
.El
.Pp
-Values are in PAGE_SIZE'd chunks ( see getpagesize() ). ksw_flags contains
+Values are in
+.Dv PAGE_SIZE Ns 'd
+chunks (see
+.Xr getpagesize 3 ) .
+.Va ksw_flags
+contains
a copy of the swap device flags.
.Pp
.Sh CACHING
This function caches the nlist values for various kernel variables which
-it reuses in successive calls. You may call the function with kd == NULL
+it reuses in successive calls.
+You may call the function with
+.Fa kd
+==
+.Dv NULL
to clear the cache.
.Sh DIAGNOSTICS
If the load average was unobtainable, \-1 is returned; otherwise,
diff --git a/lib/libm/common_source/asin.3 b/lib/libm/common_source/asin.3
index a712e9c..ca8ffda 100644
--- a/lib/libm/common_source/asin.3
+++ b/lib/libm/common_source/asin.3
@@ -57,7 +57,7 @@ The
.Fn asin
function returns the arc sine in the range
.Bk -words
-.Bq -\*(Pi/2, +\*(Pi/2
+.Bq -\*(Pi/2 , +\*(Pi/2
.Ek
radians.
On the
diff --git a/lib/libm/common_source/exp.3 b/lib/libm/common_source/exp.3
index 71d58a5..09fc4fe 100644
--- a/lib/libm/common_source/exp.3
+++ b/lib/libm/common_source/exp.3
@@ -220,7 +220,8 @@ and
.Em NaN
(the reserved
operand on a
-.Tn VAX ) . Previous implementations of pow may
+.Tn VAX ) .
+Previous implementations of pow may
have defined x**0 to be undefined in some or all of these
cases. Here are reasons for returning x**0 = 1 always:
.Bl -enum -width indent
diff --git a/lib/libm/common_source/hypot.3 b/lib/libm/common_source/hypot.3
index 281ec0c..2f77bb0 100644
--- a/lib/libm/common_source/hypot.3
+++ b/lib/libm/common_source/hypot.3
@@ -45,7 +45,7 @@
.Fd #include <math.h>
.Ft double
.Fn hypot "double x" "double y"
-.Fd struct {double x, y;} z;
+.Vt struct {double x, y;} z ;
.Ft double
.Fn cabs z
.Sh DESCRIPTION
diff --git a/lib/libm/common_source/ieee.3 b/lib/libm/common_source/ieee.3
index 466a9a6..a14e7ef 100644
--- a/lib/libm/common_source/ieee.3
+++ b/lib/libm/common_source/ieee.3
@@ -68,7 +68,7 @@ function
returns
.Fa x
with its sign changed to
-.Fa y Ns 's.
+.Fa y Ns 's .
.Pp
The
.Fn drem
@@ -102,7 +102,7 @@ the remainder is computed exactly and
.Sm on
\*(Le
.Sm off
-.Pf \\*(Ba Fa y No \\*(Ba/2.
+.Pf \\*(Ba Fa y No \\*(Ba/2 .
.Sm on
But
.Fn drem x 0
@@ -218,7 +218,7 @@ return \-1.7e38?
.Pp
.Tn IEEE
754 currently specifies that
-.Fn logb "denormalized no."
+.Fn logb "denormalized no.\&"
=
.Fn logb "tiniest normalized no. > 0"
but the consensus has changed to the specification in the new
diff --git a/lib/libm/common_source/lgamma.3 b/lib/libm/common_source/lgamma.3
index cd55003..537b5b7 100644
--- a/lib/libm/common_source/lgamma.3
+++ b/lib/libm/common_source/lgamma.3
@@ -98,7 +98,7 @@ return appropriate values unless an argument is out of range.
Overflow will occur for sufficiently large positive values, and
non-positive integers.
On the
-.Tn VAX,
+.Tn VAX ,
the reserved operator is returned,
and
.Va errno
diff --git a/lib/libpthread/man/pthread_cond_wait.3 b/lib/libpthread/man/pthread_cond_wait.3
index 9d70318..ccbf138 100644
--- a/lib/libpthread/man/pthread_cond_wait.3
+++ b/lib/libpthread/man/pthread_cond_wait.3
@@ -48,7 +48,8 @@ variable specified by
and unblocks the mutex specified by
.Fa mutex .
The waiting thread unblocks only after another thread calls
-.Xr pthread_cond_signal 3 , or
+.Xr pthread_cond_signal 3 ,
+or
.Xr pthread_cond_broadcast 3
with the same condition variable, and the current thread requires the lock
on
diff --git a/lib/libpthread/man/pthread_testcancel.3 b/lib/libpthread/man/pthread_testcancel.3
index c1bbc7d..c27c16d 100644
--- a/lib/libpthread/man/pthread_testcancel.3
+++ b/lib/libpthread/man/pthread_testcancel.3
@@ -195,5 +195,5 @@ conforms to ISO/IEC 9945-1 ANSI/IEEE
Std 1003.1 Second Edition 1996-07-12.
.Sh AUTHORS
This man page was written by
-.An David Leonard <d@openbsd.org>
+.An David Leonard Aq d@openbsd.org
for the OpenBSD implementation of pthread_cancel.
diff --git a/lib/libstand/libstand.3 b/lib/libstand/libstand.3
index 9e9a523..0305535 100644
--- a/lib/libstand/libstand.3
+++ b/lib/libstand/libstand.3
@@ -46,16 +46,25 @@ and
.Xr bstring 3 .
.Sh MEMORY ALLOCATION
.Bl -hang -width 10n
-.It Fn "void *malloc" "size_t size"
+.It Xo
+.Ft "void *"
+.Fn malloc "size_t size"
+.Xc
.Pp
Allocate
.Fa size
bytes of memory from the heap using a best-fit algorithm.
-.It Fn "void free" "void *ptr"
+.It Xo
+.Ft void
+.Fn free "void *ptr"
+.Xc
.Pp
Free the allocated object at
.Fa ptr .
-.It Fn "void setheap" "void *start" "void *limit"
+.It Xo
+.Ft void
+.Fn setheap "void *start" "void *limit"
+.Xc
.Pp
Initialise the heap. This function must be called before calling
.Fn alloc
@@ -65,7 +74,10 @@ and
.Fa limit
will be used for the heap; attempting to allocate beyond this will result
in a panic.
-.It Fn "char *sbrk" "int junk"
+.It Xo
+.Ft "char *"
+.Fn sbrk "int junk"
+.Xc
.Pp
Provides the behaviour of
.Fn sbrk 0 ,
@@ -79,17 +91,35 @@ A set of functions are provided for manipulating a flat variable space similar
to the traditional shell-supported evironment. Major enhancements are support
for set/unset hook functions.
.Bl -hang -width 10n
-.It Fn "char *getenv" "const char *name"
-.It Fn "int setenv" "const char *name" "char *value" "int overwrite"
-.It Fn "int putenv" "const char *string"
-.It Fn "int unsetenv" "const char *name"
+.It Xo
+.Ft "char *"
+.Fn getenv "const char *name"
+.Xc
+.It Xo
+.Ft int
+.Fn setenv "const char *name" "char *value" "int overwrite"
+.Xc
+.It Xo
+.Ft int
+.Fn putenv "const char *string"
+.Xc
+.It Xo
+.Ft int
+.Fn unsetenv "const char *name"
+.Xc
.Pp
These functions behave similarly to their standard library counterparts.
-.It Fn "struct env_var *env_getenv" "const char *name"
+.It Xo
+.Ft "struct env_var *"
+.Fn env_getenv "const char *name"
+.Xc
.Pp
Looks up a variable in the environment and returns its entire
data structure.
-.It Fn "int env_setenv" "const char *name" "int flags" "char *value" "ev_sethook_t sethook" "ev_unsethook_t unsethook"
+.It Xo
+.Ft int
+.Fn env_setenv "const char *name" "int flags" "char *value" "ev_sethook_t sethook" "ev_unsethook_t unsethook"
+.Xc
.Pp
Creates a new or sets an existing environment variable called
.Fa name .
@@ -117,20 +147,41 @@ may be used to prevent a variable being unset.
.El
.Sh STANDARD LIBRARY SUPPORT
.Bl -hang -width 10n
-.It Fn "int getopt" "int argc" "char * const *argv" "cont char *optstring"
-.It Fn "long strtol" "const char *nptr" "char **endptr" "int base"
-.It Fn "void srandom" "unsigned long seed"
-.It Fn "unsigned long random" "void"
-.It Fn "char *strerror" "int error"
+.It Xo
+.Ft int
+.Fn getopt "int argc" "char * const *argv" "cont char *optstring"
+.Xc
+.It Xo
+.Ft long
+.Fn strtol "const char *nptr" "char **endptr" "int base"
+.Xc
+.It Xo
+.Ft void
+.Fn srandom "unsigned long seed"
+.Xc
+.It Xo
+.Ft "unsigned long"
+.Fn random void
+.Xc
+.It Xo
+.Ft "char *"
+.Fn strerror "int error"
+.Xc
.Pp
Returns error messages for the subset of errno values supported by
.Nm No .
-.It Fn "assert" "expression"
+.It Fn assert expression
.Pp
Requires
.Fd #include <assert.h>
-.It Fn "int setjmp" "jmp_buf env"
-.It Fn "void longjmp" "jmp_buf env" "int val"
+.It Xo
+.Ft int
+.Fn setjmp "jmp_buf env"
+.Xc
+.It Xo
+.Ft void
+.Fn longjmp "jmp_buf env" "int val"
+.Xc
.Pp
Defined as
.Fn _setjmp
@@ -141,12 +192,18 @@ respectively as there is no signal state to manipulate. Requires
.El
.Sh CHARACTER I/O
.Bl -hang -width 10n
-.It Fn "void gets" "char *buf"
+.It Xo
+.Ft void
+.Fn gets "char *buf"
+.Xc
.Pp
Read characters from the console into
.Fa buf .
All of the standard cautions apply to this function.
-.It Fn "void ngets" "char *buf" "size_t size"
+.It Xo
+.Ft void
+.Fn ngets "char *buf" "size_t size"
+.Xc
.Pp
Read at most
.Fa size
@@ -156,7 +213,10 @@ If
.Fa size
is less than 1, the function's behaviour is as for
.Fn gets .
-.It Fn "int fgetstr" "char *buf" "int size" "int fd"
+.It Xo
+.Ft int
+.Fn fgetstr "char *buf" "int size" "int fd"
+.Xc
.Pp
Read a line of at most
.Fa size
@@ -166,10 +226,22 @@ Line terminating characters are stripped, and the buffer is always nul
terminated. Returns the number of characters in
.Fa buf
if successful, or -1 if a read error occurs.
-.It Fn "int printf" "const char *fmt" "..."
-.It Fn "void vprintf" "const char *fmt" "va_list ap"
-.It Fn "int sprintf" "char *buf" "const char *fmt" "..."
-.It Fn "void vsprintf" "char *buf" "const char *fmt" "va_list ap"
+.It Xo
+.Ft int
+.Fn printf "const char *fmt" "..."
+.Xc
+.It Xo
+.Ft void
+.Fn vprintf "const char *fmt" "va_list ap"
+.Xc
+.It Xo
+.Ft int
+.Fn sprintf "char *buf" "const char *fmt" "..."
+.Xc
+.It Xo
+.Ft void
+.Fn vsprintf "char *buf" "const char *fmt" "va_list ap"
+.Xc
.Pp
The *printf functions implement a subset of the standard
.Fn printf
@@ -233,19 +305,49 @@ ptr,
.El
.Sh CHARACTER TESTS AND CONVERSIONS
.Bl -hang -width 10n
-.It Fn "int isupper" "int c"
-.It Fn "int islower" "int c"
-.It Fn "int isspace" "int c"
-.It Fn "int isdigit" "int c"
-.It Fn "int isxdigit" "int c"
-.It Fn "int isascii" "int c"
-.It Fn "int isalpha" "int c"
-.It Fn "int toupper" "int c"
-.It Fn "int tolower" "int c"
+.It Xo
+.Ft int
+.Fn isupper "int c"
+.Xc
+.It Xo
+.Ft int
+.Fn islower "int c"
+.Xc
+.It Xo
+.Ft int
+.Fn isspace "int c"
+.Xc
+.It Xo
+.Ft int
+.Fn isdigit "int c"
+.Xc
+.It Xo
+.Ft int
+.Fn isxdigit "int c"
+.Xc
+.It Xo
+.Ft int
+.Fn isascii "int c"
+.Xc
+.It Xo
+.Ft int
+.Fn isalpha "int c"
+.Xc
+.It Xo
+.Ft int
+.Fn toupper "int c"
+.Xc
+.It Xo
+.Ft int
+.Fn tolower "int c"
+.Xc
.El
.Sh FILE I/O
.Bl -hang -width 10n
-.It Fn "int open" "const char *path" "int flags"
+.It Xo
+.Ft int
+.Fn open "const char *path" "int flags"
+.Xc
.Pp
Similar to the behaviour as specified in
.Xr open 2 ,
@@ -254,20 +356,41 @@ required. The
.Fa flags
argument may be one of O_RDONLY, O_WRONLY and O_RDWR (although no filesystems
currently support writing).
-.It Fn "int close" "int fd"
-.It Fn "void closeall" "void"
+.It Xo
+.Ft int
+.Fn close "int fd"
+.Xc
+.It Xo
+.Ft void
+.Fn closeall void
+.Xc
.Pp
Close all open files.
-.It Fn "ssize_t read" "int fd" "void *buf" "size_t len"
-.It Fn "ssize_t write" "int fd" "void *buf" "size_t len"
+.It Xo
+.Ft ssize_t
+.Fn read "int fd" "void *buf" "size_t len"
+.Xc
+.It Xo
+.Ft ssize_t
+.Fn write "int fd" "void *buf" "size_t len"
+.Xc
.Pp
(No filesystems currently support writing.)
-.It Fn "off_t lseek" "int fd" "off_t offset" "int whence"
+.It Xo
+.Ft off_t
+.Fn lseek "int fd" "off_t offset" "int whence"
+.Xc
.Pp
Files being automatically uncompressed during reading cannot seek backwards
from the current point.
-.It Fn "int stat" "const char *path" "struct stat *sb"
-.It Fn "int fstat" "int fd" "struct stat *sb"
+.It Xo
+.Ft int
+.Fn stat "const char *path" "struct stat *sb"
+.Xc
+.It Xo
+.Ft int
+.Fn fstat "int fd" "struct stat *sb"
+.Xc
.Pp
The
.Fn stat
@@ -285,15 +408,24 @@ filesystem always reports files having uid/gid of zero.
.Nm
supplies a simple internal pager to ease reading the output of large commands.
.Bl -hang -width 10n
-.It Fn "void pager_open"
+.It Xo
+.Ft void
+.Fn pager_open
+.Xc
.Pp
Initialises the pager and tells it that the next line output will be the top of the
display. The environment variable LINES is consulted to determine the number of
lines to be displayed before pausing.
-.It Fn "void pager_close" "void"
+.It Xo
+.Ft void
+.Fn pager_close void
+.Xc
.Pp
Closes the pager.
-.It Fn "void pager_output" "char *lines"
+.It Xo
+.Ft void
+.Fn pager_output "char *lines"
+.Xc
.Pp
Sends the lines in the nul-terminated buffer at
.Fa lines
@@ -302,7 +434,10 @@ of lines being output (wrapped lines are not accounted for).
.Fn pager_output
will return zero when all of the lines have been output, or nonzero if the
display was paused and the user elected to quit.
-.It Fn "int pager_file" "char *fname"
+.It Xo
+.Ft int
+.Fn pager_file "char *fname"
+.Xc
.Pp
Attempts to open and display the file
.Fa fname .
@@ -310,7 +445,10 @@ Returns -1 on error, 0 at EOF, or 1 if the user elects to quit while reading.
.El
.Sh MISC
.Bl -hang -width 10n
-.It Fn "void twiddle" "void"
+.It Xo
+.Ft void
+.Fn twiddle void
+.Xc
.Pp
Successive calls emit the characters in the sequence |,/,-,\\ followed by a
backspace in order to provide reassurance to the user.
@@ -356,16 +494,25 @@ returns.
.Pp
The consumer must provide the following support functions:
.Bl -hang -width 10n
-.It Fn "int getchar" "void"
+.It Xo
+.Ft int
+.Fn getchar void
+.Xc
.Pp
Return a character from the console, used by
.Fn gets ,
.Fn ngets
and pager functions.
-.It Fn "int ischar" "void"
+.It Xo
+.Ft int
+.Fn ischar void
+.Xc
.Pp
Returns nonzero if a character is waiting from the console.
-.It Fn "void putchar" "int"
+.It Xo
+.Ft void
+.Fn putchar int
+.Xc
.Pp
Write a character to the console, used by
.Fn gets ,
@@ -375,7 +522,10 @@ Write a character to the console, used by
and
.Fn twiddle
and thus by many other functions for debugging and informational output.
-.It Fn "int devopen" "struct open_file *of" "const char *name" "char **file"
+.It Xo
+.Ft int
+.Fn devopen "struct open_file *of" "const char *name" "char **file"
+.Xc
.Pp
Open the appropriate device for the file named in
.Fa name ,
@@ -388,18 +538,24 @@ which does not refer to the device. The
field in
.Fa of
will be set to point to the
-.Dv devsw
+.Vt devsw
structure for the opened device if successful. Device identifiers must
always precede the path component, but may otherwise be arbitrarily formatted.
Used by
.Fn open
and thus for all device-related I/O.
-.It Fn "int devclose" "struct open_file *of"
+.It Xo
+.Ft int
+.Fn devclose "struct open_file *of"
+.Xc
Close the device allocated for
.Fa of .
The device driver itself will already have been called for the close; this call
should clean up any allocation made by devopen only.
-.It Fn "void panic" "const char *msg" "..."
+.It Xo
+.Ft void
+.Fn panic "const char *msg" "..."
+.Xc
.Pp
Signal a fatal and unrecoverable error condition. The
.Fa msg ...
@@ -408,9 +564,10 @@ arguments are as for
.El
.Sh INTERNAL FILESYSTEMS
Internal filesystems are enabled by the consumer exporting the array
-.Dv struct fs_ops *file_system[], which should be initialised with pointers
+.Vt struct fs_ops *file_system[] ,
+which should be initialised with pointers
to
-.Dv struct fs_ops
+.Vt struct fs_ops
structures. The following filesystem handlers are supplied by
.Nm No ,
the consumer may supply other filesystems of their own:
@@ -433,7 +590,7 @@ appends
.Li .gz
to the end of the filename, and then tries to locate the file using the other
filesystems. Placement of this filesystem in the
-.Dv file_system[]
+.Va file_system[]
array determines whether gzipped files will be opened in preference to non-gzipped
files. It is only possible to seek a gzipped file forwards, and
.Fn stat
@@ -443,11 +600,11 @@ on gzipped files will report an invalid length.
.El
.Pp
The array of
-.Dv struct fs_ops
+.Vt struct fs_ops
pointers should be terminated with a NULL.
.Sh DEVICES
Devices are exported by the supporting code via the array
-.Dv struct devsw *devsw[]
+.Vt struct devsw *devsw[]
which is a NULL terminated array of pointers to device switch structures.
.Sh BUGS
.Pp
diff --git a/lib/libutil/login_times.3 b/lib/libutil/login_times.3
index c097638..bdf66f3 100644
--- a/lib/libutil/login_times.3
+++ b/lib/libutil/login_times.3
@@ -133,7 +133,7 @@ of login_time_t objects, which is up to LC_MAXTIMES (64)
elements in length, and terminated by an element with its
.Ar lt_dow
field set to
-.Em LTM_NONE.
+.Em LTM_NONE .
.Sh RETURN VALUES
.Fn parse_lt
returns a filled in structure of type login_time_t containing the
diff --git a/lib/libutil/uucplock.3 b/lib/libutil/uucplock.3
index 24b891c..404834b 100644
--- a/lib/libutil/uucplock.3
+++ b/lib/libutil/uucplock.3
@@ -88,33 +88,33 @@ returns 0 on success and -1 on failure.
.Fn uu_lock
may return any of the following values:
.Pp
-.Dv UU_LOCK_INUSE:
+.Dv UU_LOCK_INUSE :
The lock is in use by another process.
.Pp
-.Dv UU_LOCK_OK:
+.Dv UU_LOCK_OK :
The lock was successfully created.
.Pp
-.Dv UU_LOCK_OPEN_ERR:
+.Dv UU_LOCK_OPEN_ERR :
The lock file could not be opened via
.Xr open 2 .
.Pp
-.Dv UU_LOCK_READ_ERR:
+.Dv UU_LOCK_READ_ERR :
The lock file could not be read via
.Xr read 2 .
.Pp
-.Dv UU_LOCK_CREAT_ERR:
+.Dv UU_LOCK_CREAT_ERR :
Can't create temporary lock file via
.Xr creat 2 .
.Pp
-.Dv UU_LOCK_WRITE_ERR:
+.Dv UU_LOCK_WRITE_ERR :
The current process id could not be written to the lock file via a call to
.Xr write 2 .
.Pp
-.Dv UU_LOCK_LINK_ERR:
+.Dv UU_LOCK_LINK_ERR :
Can't link temporary lock file via
.Xr link 2 .
.Pp
-.Dv UU_LOCK_TRY_ERR:
+.Dv UU_LOCK_TRY_ERR :
Locking attempts are failed after 5 tries.
.Pp
If a value of
@@ -137,14 +137,14 @@ and
.Fn uu_lock_txfr
may return any of the following values:
.Pp
-.Dv UU_LOCK_OK:
+.Dv UU_LOCK_OK :
The transfer was successful. The specified process now holds the device
lock.
.Pp
-.Dv UU_LOCK_OWNER_ERR:
+.Dv UU_LOCK_OWNER_ERR :
The current process does not already own a lock on the specified device.
.Pp
-.Dv UU_LOCK_WRITE_ERR:
+.Dv UU_LOCK_WRITE_ERR :
The new process id could not be written to the lock file via a call to
.Xr write 2 .
.Sh ERRORS
diff --git a/lib/msun/man/asin.3 b/lib/msun/man/asin.3
index 1e4b2c1..b0728ee 100644
--- a/lib/msun/man/asin.3
+++ b/lib/msun/man/asin.3
@@ -62,7 +62,7 @@ and the
.Fn asinf
functions return the arc sine in the range
.Bk -words
-.Bq -\*(Pi/2, +\*(Pi/2
+.Bq -\*(Pi/2 , +\*(Pi/2
.Ek
radians.
On the
diff --git a/lib/msun/man/exp.3 b/lib/msun/man/exp.3
index 56e0cf8..e4cf9fb 100644
--- a/lib/msun/man/exp.3
+++ b/lib/msun/man/exp.3
@@ -99,7 +99,7 @@ The
and the
.Fn logf
functions compute the value of the natural logarithm of argument
-.Fa x.
+.Fa x .
.Pp
The
.Fn log10
@@ -257,7 +257,8 @@ and
.Em NaN
(the reserved
operand on a
-.Tn VAX ) . Previous implementations of pow may
+.Tn VAX ) .
+Previous implementations of pow may
have defined x**0 to be undefined in some or all of these
cases. Here are reasons for returning x**0 = 1 always:
.Bl -enum -width indent
diff --git a/lib/msun/man/hypot.3 b/lib/msun/man/hypot.3
index c65064a..a139e39 100644
--- a/lib/msun/man/hypot.3
+++ b/lib/msun/man/hypot.3
@@ -47,10 +47,10 @@
.Fn hypot "double x" "double y"
.Ft float
.Fn hypotf "float x" "float y"
-.Fd struct {double x, y;} z;
+.Vt struct {double x, y;} z ;
.Ft double
.Fn cabs z
-.Fd struct {float x, y;} z;
+.Vt struct {float x, y;} z ;
.Ft float
.Fn cabsf z
.Sh DESCRIPTION
diff --git a/lib/msun/man/ieee.3 b/lib/msun/man/ieee.3
index a9cc695..2aed69f 100644
--- a/lib/msun/man/ieee.3
+++ b/lib/msun/man/ieee.3
@@ -85,7 +85,7 @@ and
return
.Fa x
with its sign changed to
-.Fa y Ns 's.
+.Fa y Ns 's .
.Pp
.Fn finite
and
@@ -157,7 +157,7 @@ the remainder is computed exactly and
.Sm on
\*(Le
.Sm off
-.Pf \\*(Ba Fa y No \\*(Ba/2.
+.Pf \\*(Ba Fa y No \\*(Ba/2 .
.Sm on
But
.Fn remainder x 0
diff --git a/lib/msun/man/lgamma.3 b/lib/msun/man/lgamma.3
index 333bf77..9800999 100644
--- a/lib/msun/man/lgamma.3
+++ b/lib/msun/man/lgamma.3
@@ -112,7 +112,7 @@ return appropriate values unless an argument is out of range.
Overflow will occur for sufficiently large positive values, and
non-positive integers.
On the
-.Tn VAX,
+.Tn VAX ,
the reserved operator is returned,
and
.Va errno
OpenPOWER on IntegriCloud