libc: Fix most issues reported by mandoc

- varios "new sentence, new line" warnings
- varios "sections out of conventional order" warnings
- varios "unusual Xr order" warnings
- varios "missing section argument" warnings
- varios "no blank before trailing delimiter" warnings
- varios "normalizing date format" warnings

MFC after:	1 month

lib/libc/locale/setlocale.3

@@ -157,6 +157,15 @@ if the given combination of
 and
 .Fa locale
 makes no sense.
+.Sh FILES
+.Bl -tag -width /usr/share/locale/locale/category -compact
+.It Pa $PATH_LOCALE/ Ns Em locale/category
+.It Pa /usr/share/locale/ Ns Em locale/category
+locale file for the locale
+.Em locale
+and the category
+.Em category .
+.El
 .Sh EXAMPLES
 The following code illustrates how a program can initialize the
 international environment for one language, while selectively
@@ -176,15 +185,6 @@ following manner before using any of the locale-specific information:
 .Bd -literal
     setlocale(LC_ALL, "");
 .Ed
-.Sh FILES
-.Bl -tag -width /usr/share/locale/locale/category -compact
-.It Pa $PATH_LOCALE/ Ns Em locale/category
-.It Pa /usr/share/locale/ Ns Em locale/category
-locale file for the locale
-.Em locale
-and the category
-.Em category .
-.El
 .Sh ERRORS
 No errors are defined.
 .Sh SEE ALSO

lib/libc/net/gethostbyname.3

@@ -303,7 +303,26 @@ for example, a mail-forwarder may be registered for this domain.
 .Xr hosts 5 ,
 .Xr hostname 7 ,
 .Xr named 8
-.Sh CAVEAT
+.Sh HISTORY
+The
+.Fn herror
+function appeared in
+.Bx 4.3 .
+The
+.Fn endhostent ,
+.Fn gethostbyaddr ,
+.Fn gethostbyname ,
+.Fn gethostent ,
+and
+.Fn sethostent
+functions appeared in
+.Bx 4.2 .
+The
+.Fn gethostbyname2
+function first appeared in
+.Tn BIND
+version 4.9.4.
+.Sh CAVEATS
 The
 .Fn gethostent
 function
@@ -343,25 +362,6 @@ The
 .Fn endhostent
 function
 closes the file.
-.Sh HISTORY
-The
-.Fn herror
-function appeared in
-.Bx 4.3 .
-The
-.Fn endhostent ,
-.Fn gethostbyaddr ,
-.Fn gethostbyname ,
-.Fn gethostent ,
-and
-.Fn sethostent
-functions appeared in
-.Bx 4.2 .
-The
-.Fn gethostbyname2
-function first appeared in
-.Tn BIND
-version 4.9.4.
 .Sh BUGS
 These functions use a thread-specific data storage;
 if the data is needed for future use, it should be

lib/libc/sys/copy_file_range.2

@@ -117,7 +117,6 @@ with
 .Dv SEEK_DATA
 arguments and this system call for the
 data ranges found.
-.Pp
 .Sh RETURN VALUES
 If it succeeds, the call returns the number of bytes copied, which can be fewer
 than
@@ -144,11 +143,9 @@ will fail if:
 .Bl -tag -width Er
 .It Bq Er EBADF
 If
-.Fa
-infd
+.Fa infd
 is not open for reading or
-.Fa
-outfd
+.Fa outfd
 is not open for writing, or opened for writing with
 .Dv O_APPEND ,
 or if
@@ -175,8 +172,7 @@ are reset to the initial values for the system call.
 and
 .Fa outfd
 refer to the same file and the byte ranges overlap or
-.Fa
-flags
+.Fa flags
 is not zero.
 .It Bq Er EIO
 An I/O error occurred while reading/writing the files.

lib/libc/sys/execve.2

@@ -348,7 +348,7 @@ system call conforms to The Open Group Extended API Set 2 specification.
 The
 .Fn execve
 system call appeared in
-.At V7 .
+.At v7 .
 The
 .Fn fexecve
 system call appeared in

lib/libc/sys/fhlink.2

@@ -272,6 +272,6 @@ is not
 nor a file descriptor associated with a directory.
 .El
 .Sh SEE ALSO
-.Xr fhstat 2 ,
-.Xr fhreadlink 2 ,
 .Xr fhopen 2 ,
+.Xr fhreadlink 2 ,
+.Xr fhstat 2

lib/libc/sys/pdfork.2

@@ -161,8 +161,8 @@ for
 .Xr fork 2 ,
 .Xr fstat 2 ,
 .Xr kill 2 ,
-.Xr poll 2 ,
 .Xr kqueue 2 ,
+.Xr poll 2 ,
 .Xr wait4 2 ,
 .Xr capsicum 4 ,
 .Xr procdesc 4

lib/libc/sys/ptrace.2

@@ -698,7 +698,6 @@ value.
 If the system call completed in an unusual fashion,
 .Va sr_error
 is set to a negative value:
-.Pp
 .Bl -tag -width Dv EJUSTRETURN -compact
 .It Dv ERESTART
 System call will be restarted.
@@ -830,7 +829,6 @@ The
 .Fa data
 argument is ignored.
 .El
-.Pp
 .Sh x86 MACHINE-SPECIFIC REQUESTS
 .Bl -tag -width "Dv PT_GETXSTATE_INFO"
 .It Dv PT_GETXMMREGS

lib/libc/sys/revoke.2

@@ -31,7 +31,7 @@
 .\"     @(#)revoke.2	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd Jan 25, 2016
+.Dd January 25, 2016
 .Dt REVOKE 2
 .Os
 .Sh NAME

lib/libc/sys/rtprio.2

@@ -135,7 +135,10 @@ field ranges between 0 and
 .Pq usually 31 .
 0 is the highest possible priority.
 .Pp
-Realtime and idle priority is inherited through fork() and exec().
+Realtime and idle priority is inherited through
+.Fn fork
+and
+.Fn exec .
 .Pp
 A realtime thread can only be preempted by a thread of equal or
 higher priority, or by an interrupt; idle priority threads will run only

lib/libc/sys/sendfile.2

@@ -381,14 +381,14 @@ does not support
 The socket peer has closed the connection.
 .El
 .Sh SEE ALSO
-.Xr loader.conf 5 ,
 .Xr netstat 1 ,
 .Xr open 2 ,
 .Xr send 2 ,
 .Xr socket 2 ,
 .Xr writev 2 ,
-.Xr sysctl 8 ,
-.Xr tuning 7
+.Xr loader.conf 5 ,
+.Xr tuning 7 ,
+.Xr sysctl 8
 .Rs
 .%A K. Elmeleegy
 .%A A. Chanda

lib/libc/sys/thr_exit.2

@@ -72,12 +72,12 @@ A return from the function indicates that the calling thread was the
 last one in the process.
 .Sh SEE ALSO
 .Xr _exit 2 ,
+.Xr _umtx_op 2 ,
 .Xr thr_kill 2 ,
 .Xr thr_kill2 2 ,
 .Xr thr_new 2 ,
 .Xr thr_self 2 ,
 .Xr thr_set_name 2 ,
-.Xr _umtx_op 2 ,
 .Xr pthread_exit 3
 .Sh STANDARDS
 The

lib/libc/sys/thr_new.2

@@ -225,6 +225,7 @@ There was not enough kernel memory to allocate the new thread structures.
 .El
 .Sh SEE ALSO
 .Xr ps 1 ,
+.Xr _umtx_op 2 ,
 .Xr execve 2 ,
 .Xr racct 2 ,
 .Xr thr_exit 2 ,
@@ -232,7 +233,6 @@ There was not enough kernel memory to allocate the new thread structures.
 .Xr thr_kill2 2 ,
 .Xr thr_self 2 ,
 .Xr thr_set_name 2 ,
-.Xr _umtx_op 2 ,
 .Xr pthread_create 3
 .Sh STANDARDS
 The

lib/libc/sys/thr_self.2

@@ -71,12 +71,12 @@ The memory pointed to by the
 argument is not valid.
 .El
 .Sh SEE ALSO
+.Xr _umtx_op 2 ,
 .Xr thr_exit 2 ,
 .Xr thr_kill 2 ,
 .Xr thr_kill2 2 ,
 .Xr thr_new 2 ,
 .Xr thr_set_name 2 ,
-.Xr _umtx_op 2 ,
 .Xr pthread_getthreadid_np 3 ,
 .Xr pthread_self 3
 .Sh STANDARDS

lib/libc/sys/thr_set_name.2

@@ -78,12 +78,12 @@ does not exist in the current process.
 .El
 .Sh SEE ALSO
 .Xr ps 1 ,
+.Xr _umtx_op 2 ,
 .Xr thr_exit 2 ,
 .Xr thr_kill 2 ,
 .Xr thr_kill2 2 ,
 .Xr thr_new 2 ,
 .Xr thr_self 2 ,
-.Xr _umtx_op 2 ,
 .Xr pthread_set_name_np 3 ,
 .Xr ddb 4 ,
 .Xr ktr 9

lib/libc/sys/thr_suspend.2

@@ -98,7 +98,6 @@ As with
 called from another thread, the next
 .Nm
 call does not result in suspension.
-.Pp
 .Sh RETURN VALUES
 .Rv -std thr_suspend
 .Sh ERRORS

lib/libc/sys/thr_wake.2

@@ -74,7 +74,7 @@ If
 .Fa id
 is not equal to the current thread identifier, the specified thread is
 woken up if suspended by the
-.Xr thr_suspend
+.Xr thr_suspend 2
 system call.
 If the thread is not suspended at the time of the
 .Nm