Copy stable/10@r272459 to releng/10.1 as part of
the 10.1-RELEASE process.

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

Merge r269871 from head:

Clarify descriptions of pthread_cond_wait() and pthread_cond_timedwait()

Submitted by: Malcolm Douglas via freebsd-doc
Reviewed by: jhb

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

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

General mdoc(7) and typo fixes.

PR: 167734
Submitted by: Nobuyuki Koganemaru (kogane!jp.freebsd.org)
MFC after: 3 days

Add a set of manual pages for pthread[_attr]_[sg]etaffinity(3).

Reviewed by: davidxu
MFC after: 2 weeks

On second thought, remove the comma too.

Remove KSE bits, cross reference libthr.3.

PR: 132392
Submitted by: Niclas Zeising <niclas.zeising@gmail.com> (original version)

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

Reviewed by: deischen, davidxu

Add a reference too pthread_cancel(3).
Submitted by: Jeremie Le-Hen

Remove mentions of libc_r.

Add a manpage for pthread_atfork(3). This copies a lot of the text of
the Open Group manpage for pthread_atfork(), available online at:

http://www.opengroup.org/onlinepubs/009695399/functions/pthread_atfork.html

which should be ok, since Daniel Eischen had mailed me about Open
Group manpages and the fact that they have granted permission to
FreeBSD to use their material. Any differences from the OG text are
my changes to the original manpage text submitted by Alex Vasylenko:

- In an effort to clean up the part that describes hooks and their
calling order, I used a list instead of a single paragraph for all the three
types of fork() hooks.
- After a short discussion with Dima Dorfman a long long time ago in a
far away galaxy, I changed the RETURN VALUES section to look more
like the rest of the pthread_xxx.3 manpages.

PR: docs/68201
Submitted by: Alex Vasylenko <lxv@omut.org>

Expand *n't contractions.

Add a LIBRARY section.

Submitted by: Craig Rodrigues <rodrigc@crodrigues.org>
PR: docs/65208

Removed outdated text about libc_r replacing libc (it now provides
just libc functions wrappers), and updated text to match reality:
there are three threading libraries in FreeBSD these days.

Removed instructions of how not to build libc_r, it's documented in
the make.conf(5) manpage already.

Removed description of the FreeBSD-specific gcc(1) option, -pthread.
While it's still provided (for backwards compatibility reasons),
its usefulness is questionable.

Assorted markup fixes.

o Implement pthread_mutex_timedlock(), which does not block indefinitely on
a mutex locked by another thread.
o document it: pthread_mutex_timedlock(3)

mdoc(7) police: sort xrefs in SEE ALSO.

Add a bunch of functions.

PR: docs/32561
Reviewed by: deischen, ru
Approved by: ru
MFC after: 2 weeks

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

Removed whitespace at end-of-line; no content changes. I simply did
cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//'

BTW, what editors are the culprits? I'm using vim and it shows
me whitespace at EOL in troff files with a thick blue block...

Reviewed by: Silence from cvs diff -b
MFC after: 7 days

mdoc(7) police: removed HISTORY info from the .Os call.

mdoc(7) police: sort SEE ALSO xrefs (sort -b -f +2 -3 +1 -2).

mdoc(7) police: utilize .St macro.

Fixed missing #include and wrong prototypes. Most of these bugs were
duplicated in libc_r/man/*.3 but were fixed years ago there. Here
they were hiding under mdoc errors.

mdoc(7) police: split punctuation characters + misc fixes.

Use Fx macro wherever possible.

Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.

ack. Ignore me. Log should read:

Added references to related man pages that should be under the
"See Also" section. The related PR mentions some missing man pages
that Jason has added to his to do list.

Removed pthread(3) references to non-existant pthread related manpages.
I discussed this with Jason Evans and he's put these on his to-do list.

PR: 16537
Submitted by: AnarCat <beaupran@iro.umontreal.ca>
Approved by: jasone

Document pthread_create().

Reviewed by: jasone

$Id$ -> $FreeBSD$

Added pthread read/write locks.

Add a reference to the gcc linker option -pthread that is part of
the FreeBSD configuration LIB_SPEC.

Typo fix.
Removed "...when it is published" from conformity statement.

Use consistent spelling,
writeable -> writable (recall prior debate over this? :-)
initialise -> initialize
recognise -> recognize

Merry Christmas! :)

Update the man page to reflect that libc_r is built as part
of make world unless the '-DNOLIBC_R' option is given to make(1).

PR: 4710
Submitted by: Magnus Enbom <dot@tinto.campus.luth.se

add missing cvs Id lines.

Submitted by: John Birrell <cimaxp1!jb@werple.net.au>

Here are the diffs for libc_r to get it one step closer to P1003.1c
These make most of the thread/mutex/condvar structures opaque to the
user. There are three functions which have been renamed with _np
suffixes because they are extensions to P1003.1c (I did them for JAVA,
which needs to suspend/resume threads and also start threads suspended).

I've created a new header (pthread_np.h) for the non-POSIX stuff.

The egrep tags stuff in /usr/src/lib/libc_r/Makefile that I uncommented
doesn't work. I think its best to delete it. I don't think libc_r needs
tags anyway, 'cause most of the source is in libc which does have tags.

also:

Here's the first batch of man pages for the thread functions.
The diff to /usr/src/lib/libc_r/Makefile removes some stuff that was
inherited from /usr/src/lib/libc/Makefile that should only be done with
libc.

also:

I should have sent this diff with the pthread(3) man page.
It allows people to type

make -DWANT_LIBC_R world

to get libc_r built with the rest of the world. I put this in the
pthread(3) man page. The default is still not to build libc_r.


also:
The diff attached adds a pthread(3) man page to /usr/src/share/man/man3.
The idea is that without libc_r installed, this man page will give people
enough info to know that they have to build libc_r.