Assorted markup fixes.

Approved by:	re

8 files changed, 59 insertions, 34 deletions

diff --git a/lib/libc/gen/sysctl.3 b/lib/libc/gen/sysctl.3
index 5fe33dc..9ac8cee 100644
--- a/lib/libc/gen/sysctl.3
+++ b/lib/libc/gen/sysctl.3
@@ -454,20 +454,26 @@ whose size depends on the current number of such objects in the system.
 .It "KERN_PROC_RUID	A real user ID"
 .El
 .Pp
-If the third level name is KERN_PROC_ARGS then the command line argument
+If the third level name is
+.Dv KERN_PROC_ARGS
+then the command line argument
 array is returned in a flattened form, i.e., zero-terminated arguments
 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.
-If the third level name is KERN_PROC_PATHNAME, the path of the
+If the third level name is
+.Dv KERN_PROC_PATHNAME ,
+the path of the
 process' text file is stored.
-For KERN_PROC_PATHNAME, a process ID of
-.Li -1
+For
+.Dv KERN_PROC_PATHNAME ,
+a process ID of
+.Li \-1
 implies the current process.
 .Bl -column "Third level nameXXXXXX" "Fourth level is:XXXXXX" -offset indent
 .It Sy "Third level name	Fourth level is:"
-.It "KERN_PROC_ARGS	A process ID"
-.It "KERN_PROC_PATHNAME	A process ID"
+.It Dv KERN_PROC_ARGS Ta "A process ID"
+.It Dv KERN_PROC_PATHNAME Ta "A process ID"
 .El
 .It Li KERN_PROF
 Return profiling information about the kernel.
diff --git a/lib/libc/gen/ttyname.3 b/lib/libc/gen/ttyname.3
index db67314..5f427fb 100644
--- a/lib/libc/gen/ttyname.3
+++ b/lib/libc/gen/ttyname.3
@@ -85,10 +85,14 @@ a file descriptor for which
 .Fn isatty
 is true.
 .Pp
+The
 .Fn ttyname
+function
 returns the name stored in a static buffer which will be overwritten
 on subsequent calls.
+The
 .Fn ttyname_r
+function
 takes a buffer and length as arguments to avoid this problem.
 .Pp
 The
@@ -109,40 +113,49 @@ a
 pointer is returned.
 The
 .Fn ttyname_r
-function returns 0 if successful.  Otherwise an error number is returned.
+function returns 0 if successful.
+Otherwise an error number is returned.
 .Pp
 The
 .Fn ttyslot
 function
 returns the unit number of the device file if found; otherwise
 the value zero is returned.
+.Sh FILES
+.Bl -tag -width ".Pa /etc/ttys" -compact
+.It Pa /dev/\(**
+.It Pa /etc/ttys
+.El
 .Sh ERRORS
+The
 .Fn ttyname_r
-may return the following error codes:
+may fail and return the following error codes:
 .Bl -tag -width Er
 .It Bq Er ENOTTY
+The
 .Fa fd
+argument
 is not a valid file descriptor.
 .It Bq Er ERANGE
+The
 .Fa bufsize
+argument
 is smaller than the length of the string to be returned.
-.Sh FILES
-.Bl -tag -width /etc/ttys -compact
-.It Pa /dev/\(**
-.It Pa /etc/ttys
 .El
 .Sh SEE ALSO
 .Xr ioctl 2 ,
 .Xr ttys 5
 .Sh HISTORY
-A
+The
 .Fn isatty ,
 .Fn ttyname ,
 and
 .Fn ttyslot
-function
+functions
 appeared in
 .At v7 .
+The
 .Fn ttyname_r
+function
 appeared in
 .Fx 6.0 .
diff --git a/lib/libc/net/getaddrinfo.3 b/lib/libc/net/getaddrinfo.3
index 3982bfe..9c5a8b6 100644
--- a/lib/libc/net/getaddrinfo.3
+++ b/lib/libc/net/getaddrinfo.3
@@ -30,8 +30,10 @@
 .Fd #include <sys/socket.h>
 .Fd #include <netdb.h>
 .Ft int
-.Fn getaddrinfo "const char *hostname" "const char *servname" \
-    "const struct addrinfo *hints" "struct addrinfo **res"
+.Fo getaddrinfo
+.Fa "const char *hostname" "const char *servname"
+.Fa "const struct addrinfo *hints" "struct addrinfo **res"
+.Fc
 .Ft void
 .Fn freeaddrinfo "struct addrinfo *ai"
 .Sh DESCRIPTION
diff --git a/lib/libc/net/getnameinfo.3 b/lib/libc/net/getnameinfo.3
index 54dce39..61479cf 100644
--- a/lib/libc/net/getnameinfo.3
+++ b/lib/libc/net/getnameinfo.3
@@ -29,8 +29,10 @@
 .Fd #include <sys/socket.h>
 .Fd #include <netdb.h>
 .Ft int
-.Fn getnameinfo "const struct sockaddr *sa" "socklen_t salen" "char *host" \
-    "size_t hostlen" "char *serv" "size_t servlen" "int flags"
+.Fo getnameinfo
+.Fa "const struct sockaddr *sa" "socklen_t salen" "char *host"
+.Fa "size_t hostlen" "char *serv" "size_t servlen" "int flags"
+.Fc
 .Sh DESCRIPTION
 The
 .Fn getnameinfo
diff --git a/lib/libc/net/getnetent.3 b/lib/libc/net/getnetent.3
index 978b25b..3c329a6 100644
--- a/lib/libc/net/getnetent.3
+++ b/lib/libc/net/getnetent.3
@@ -167,7 +167,7 @@ functions appeared in
 .Bx 4.2 .
 .Sh BUGS
 The data space used by
-these functions is a thread-specific; if future use requires the data, it should be
+these functions is thread-specific; if future use requires the data, it should be
 copied before any subsequent calls to these functions overwrite it.
 Only Internet network
 numbers are currently understood.
diff --git a/lib/libc/net/inet6_rth_space.3 b/lib/libc/net/inet6_rth_space.3
index b8110e1..3903485 100644
--- a/lib/libc/net/inet6_rth_space.3
+++ b/lib/libc/net/inet6_rth_space.3
@@ -61,7 +61,7 @@
 The IPv6 Advanced API, RFC 3542, defines the functions that an
 application calls to build and examine IPv6 Routing headers.
 Routing headers are used to perform source routing in IPv6 networks.
-The RFC uses the word 
+The RFC uses the word
 .Dq segments
 to describe addresses and that is the term used here as well.
 All of the functions are defined in the
@@ -82,14 +82,14 @@ The
 .Fn inet6_rth_space
 function returns the number of bytes required to hold a Routing Header
 of the type, specified in the
-.Fa type 
+.Fa type
 argument and containing the number of addresses specified in the
 .Fa segments
 argumment.
-When the type is 
+When the type is
 .Dv IPV6_RTHDR_TYPE_0
 the number of segments must be from 0 through 127.
-Routing headers of type 
+Routing headers of type
 .Dv IPV6_RTHDR_TYPE_2
 contain only one segment, and are only used with Mobile IPv6.
 The return value from this function is the number of bytes required to
@@ -166,20 +166,25 @@ The
 .Fa index
 is the location in the routing header from which the application wants
 to retrieve an address.
-The 
-.Fa index 
+The
+.Fa index
 parameter must have a value between 0 and one less than the number of
 segments present in the routing header.
 The
-.Fn inet6_rth_segments 
+.Fn inet6_rth_segments
 function, described in the last section, should be used to determine
 the total number of segments in the routing header.
 The
 .Fn inet6_rth_getaddr
-function returns a pointer to an IPv6 address on success or 
+function returns a pointer to an IPv6 address on success or
 .Dv NULL
 when an error has occurred.
 .\"
+.Sh EXAMPLES
+RFC 3542 gives extensive examples in Section 21, Appendix B.
+.Pp
+KAME also provides examples in the advapitest directory of its kit.
+.\"
 .Sh DIAGNOSTICS
 The
 .Fn inet6_rth_space
@@ -198,11 +203,6 @@ and
 .Fn inet6_rth_reverse
 functions return 0 on success, or \-1 upon an error.
 .\"
-.Sh EXAMPLES
-RFC 3542 gives extensive examples in Section 21, Appendix B.
-.Pp
-KAME also provides examples in the advapitest directory of its kit.
-.\"
 .Sh SEE ALSO
 .Rs
 .%A W. Stevens
diff --git a/lib/libc/nls/catgets.3 b/lib/libc/nls/catgets.3
index fe78211..38e92ba 100644
--- a/lib/libc/nls/catgets.3
+++ b/lib/libc/nls/catgets.3
@@ -63,7 +63,7 @@ otherwise it returns
 .It Bq Er EBADF
 The
 .Fa catd
-argument is not valid message catalog descriptor.
+argument is not a valid message catalog descriptor.
 .It Bq Er EBADMSG
 The message identified by
 .Fa set_id
diff --git a/lib/libc/sys/send.2 b/lib/libc/sys/send.2
index 7434db2..20e005b 100644
--- a/lib/libc/sys/send.2
+++ b/lib/libc/sys/send.2
@@ -137,7 +137,9 @@ protocol family, and is used to implement Transaction
 .Dv MSG_DONTROUTE
 is usually used only by diagnostic or routing programs.
 .Dv MSG_NOSIGNAL
-is used to prevent SIGPIPE generation when writing a socket that
+is used to prevent
+.Dv SIGPIPE
+generation when writing a socket that
 may be closed.
 .Pp
 See