Copy stable/9 to releng/9.3 as part of the 9.3-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

MFC r235286:

General mdoc(7) and typo fixes.

PR: 167734

Copy head to stable/9 as part of 9.0-RELEASE release cycle.

Approved by: re (implicit)

Document clock and pshared condvar attributes.

Note: clock accepts CLOCK_VIRTUAL and CLOCK_PROF too, but this seems broken
as it simply waits for the difference of the current and given value of the
clock as if it were CLOCK_MONOTONIC. So document only CLOCK_REALTIME and
CLOCK_MONOTONIC as allowed.

MFC after: 1 week

Hide the implementation details about multiple threading libraries
from the synopses of pthread*(3) manpages.

Reviewed by: deischen, davidxu

Remove mentions of libc_r.

Document interfaces that are supported by libthr.

Have a single set of POSIX threads man pages. The LIBRARY section
of each manpage lists libraries that have corresponding interfaces
implemented.

Prodded by: threads
Reviewed by: deischen

Get rid of duplicates.

The .Fn function. Use .Xr where appropriate.

mdoc(7) police: Use the new .In macro for #include statements.

Spell "FreeBSD" with "F" and "BSD" in uppercase.

Remove whitespace at EOL.

/^\.St/ s/-iso9945-1/-p1003.1-96/

Prepare for mdoc(7)NG.

Use Fx macro wherever possible.

Change my email address in the copyright notices for the sake of consistency
(jasone@canonware.com --> jasone@freebsd.org).

mdoc(7) cleanup:

. use real function names as `.Nm' macro argument in NAME section. It allows
them to appear in apropos(1) or whatis(1) output.

. replace empty lines with `.Pp' macro.

. replace hardcoded standard names with their `.St' macro equivalents.

. sort cross references in SEE ALSO section

Add missing man pages. Fix various compliance bugs, mostly having to do with
error return values. Implement pthread_mutexattr_gettype().

PR: docs/16537, docs/17538