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

MFC 261518:
- Update a few places to account for va_copy().
- Create a separate 'return values' section and move some statements about
return values to that section.
- Note that each invocation of va_start() and va_copy() must be paired with
va_end() in the same function.

Merge 257643: Document RB_FOREACH_SAFE() and RB_FOREACH_REVERSE_SAFE().

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

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

Add new FOREACH_FROM variants of the queue(3) FOREACH macros which can
optionally start the traversal from a previously found element by passing the
element in as "var". Passing a NULL "var" retains the same semantics as the
regular FOREACH macros.

Kudos to phk for suggesting the "FROM" suffix instead of my original proposal.

Reviewed by: jhb (previous version), rpaulo
MFC after: 1 week

pthread_testcancel(3): Update list of cancellation points.

This should be a fairly complete list of cancellation points in libc, libthr
and librt, including standard as well as non-standard functions.

mdoc: convert .Fd to .In, which is much nicer.

Start sentences on new lines.

Remove cross-references to nonexistent CPU_SET(3) manpage.
Also fix cpu_getaffinity(2) document title.

PR: 176317
Submitted by: brucec

Fixing a typo.

Submitted by: Benedikt Steinbusch (benedikt.steinbusch@googlemail.com)
Approved by: sbruno (mentor)

Remove contractions.

siginfo(3): Document TRAP_DTRACE signal code.

MFC after: 1 week

siginfo(3): Document SI_LWP signal code.

Describe SI_LWP as being generated by pthread_kill() because thr_kill() is
a private undocumented function.

MFC after: 1 week

siginfo(3): Document SI_USER and SI_KERNEL signal codes.

MFC after: 1 week

Bump date missed in r202756

PR: docs/171624
Submitted by: bdrewery
Approved by: gabor
MFC after: 3 days

Implement LIST_PREV().

Regular LISTs have been implemented in such a way that the prev-pointer
does not point to the previous element, but to the next-pointer stored
in the previous element. This is done to simplify LIST_REMOVE(). This
macro can be implemented without knowing the address of the list head.

Unfortunately this makes it harder to implement LIST_PREV(), which is
why this macro was never here. Still, it is possible to implement this
macro. If the prev-pointer points to the list head, we return NULL.
Otherwise we simply subtract the offset of the prev-pointer within the
structure.

It's not as efficient as traversing forward of course, but in practice
it shouldn't be that bad. In almost all use cases, people will want to
compare the value returned by LIST_PREV() against NULL, so an optimizing
compiler will not emit code that does more branching than TAILQs.

While there, make the code a bit more readable by introducing
__member2struct(). This makes STAILQ_LAST() far more readable.

MFC after: 1 month

Remove trailing whitespace.

Add manual pages for clock_getcpuclockid and pthread_getcpuclockid.

General mdoc(7) and typo fixes.

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

mdoc: fix column names, indentation, column separation within each row, and
quotation. Also make sure we have the same amount of columns in each row as
the number of columns we specify in the head arguments.

Reviewed by: brueffer

Remove trailing whitespace per mdoc lint warning

Disussed with: gavin
No objection from: doc
Approved by: joel
MFC after: 3 days

Make sure sections are sorted into conventional order.

Add implementation note about when a condition variable can be destroyed.

Fix various typos in manual pages.

Submitted by: amdmi3
PR: 165431
MFC after: 1 week

Add offsetof.3 man page

Obtained from: OpenBSD

Pull up vendor changes to mdoc(7)

This switches us to using -isoC-2011 as the symbol name which is used by
groff and mdocml. It follows the change to 4 digit years as done with
IEEE Std 1003 post-1999.

MFC after: 2 weeks (groff changes only)

Reimplement <tgmath.h> on top of __generic().

The macro construction used now, is almost identical to the code
provided in C11 proposal N1404. This new version doesn't seem to
introduce any regressions according to the regression test in tools/,
but still seems to malfunction with Clang on certain aspects.

The new code does work successfully with GCC 4.2, 4.6 and 4.7. With 4.7,
it also works when __generic() is implemented on top of _Generic().

Discussed with: stefanf

Document restriction on 32-bits and 64-bits datatypes.

Add missing \.

While sorting the MLINKS by name, I forgot to re-add it.

Add manual page for atomic operations.

Fix a little typo and get rid of a cryptic description by aligning the
text to the remaining description.

Approved by: re

Remove note that claims pthread_set_name_np is for debugging only.

As Garrett points out,
It is no more a debugging interface than setproctitle(3), and has not
been since the name started getting stuffed into the kernel. This
statement may have made sense when the name was only visible in thread
state dumps and the debugger.
PR: threads/158815
Submitted by: wollman@

Note that the _SWAP operation is supported for all list/queue types.
Also place STAILQ_REMOVE_HEAD in alphabetical order. Lastly, document
the _SWAP macros.

PR: kern/143033
MFC after: 1 week

- Fix typo

Approved by: davidxu

Add restrict keyword to pthread_sigmask prototype and manpage.

MFC after: 1 week

Fix the previous commit of pthread_getthreadid_np(3).

Introduce a non-portable function pthread_getthreadid_np(3) to retrieve
calling thread's unique integral ID, which is similar to AIX function of
the same name. Bump __FreeBSD_version to note its introduction.

Reviewed by: kib

Remove a bullet point that appears to have been accidentally inserted twice.
It has also been included within the feature lists to which it is relevant.

Submitted by: tobez
MFC after: 1 week

Explain some of the reasons that fpsetprec() is unlikely to work as
one might expect. (These functions have already been deprecated for
many years.)

PR: 133583

Follow the change made in libthr, add ERANGE error code and more
EINVAL error cases.

mdoc: drop redundant .Pp and .LP calls

They have no effect when coming in pairs, or before .Bl/.Bd

Make a link for pthread_timedjoin_np.

kill() does queue signal now.

mdoc: remove unused/empty macros

Cross reference tree(3) and queue(3).

MFC after: 1 week

- The ETIMEDOUT error applies to pthread_timedjoin_np(), not pthread_join().
- Tweak wording in history section for pthread_timedjoin_np().

MFC after: 3 days

mdoc: move remaining sections into consistent order

This pertains mostly to FILES, HISTORY, EXIT STATUS and AUTHORS sections.

Found by: mdocml lint run
Reviewed by: ru

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

mdoc: order prologue macros consistently by Dd/Dt/Os

Although groff_mdoc(7) gives another impression, this is the ordering
most widely used and also required by mdocml/mandoc.

Reviewed by: ru
Approved by: philip, ed (mentors)

Correct cross reference.

MFC after: 2 weeks

Document pthread_timedjoin_np.
Note implementation-defined EOPNOTSUPP error [1].

PR: threads/143115 [1]
MFC after: 3 days

Remove stale references to utmp(5) and its corresponding filenames.

I removed utmp and its manpage, but not other manpages referring to it.

Various fixes.

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

Reviewed by: davidxu
MFC after: 2 weeks

Fix typo.

PR: 140615
Submitted by: Andrius Morkunas <hinokind@gmail.com>
MFC after: 3 days

Fix typo (noded -> nodes).

Rename the queue macros I introduced last year.

Last year I added SLIST_REMOVE_NEXT and STAILQ_REMOVE_NEXT, to remove
entries behind an element in the list, using O(1) time. I recently
discovered NetBSD also has a similar macro, called SLIST_REMOVE_AFTER.
In my opinion this approach is a lot better:

- It doesn't have the unused first argument of the list pointer. I added
this, mainly because OpenBSD also had it.

- The _AFTER suffix makes a lot more sense, because it is related to
SLIST_INSERT_AFTER. _NEXT is only used to iterate through the list.

The reason why I want to rename this now, is to make sure we don't
release a major version with the badly named macros.

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)

Small typo in the makedev(3) manpage.

devtoname(3) is a nonexistent function. We do have devtoname(9), but
that's entirely different. The correct function is devname(3).

Several documentation fixups related to device minor/major numbers:

- Document the minor(3), major(3) and makedev(3) macro's. They also
apply to umajor() and uminor() in the kernel, but hopefully we'll sort
that out one day.

- Briefly dev2unit() inside the make_dev(9) manual page, since this is
now the preferred macro to obtain character device unit numbers inside
the kernel.

- Remove the device_ids(9) manual page. It contains highly inaccurate
information, such as a description of the nonexistent major().

Introduce REMOVE_NEXT() macro's for SLIST and STAILQ.

Even though single linked lists allow items to be removed at constant time
(when the previous element is known), the queue macro's don't allow this.
Implement new REMOVE_NEXT() macro's. Because the REMOVE() macro's also
contain the same code, make it call REMOVE_NEXT().

The OpenBSD version of SLIST_REMOVE_NEXT() needs a reference to the list
head, even though it is unused. We'd better mimic this. The STAILQ version
also needs a reference to the list. This means the prototypes of both
macro's are the same.

Approved by: philip (mentor)
PR: kern/121117

Remove options MK_LIBKSE and DEFAULT_THREAD_LIB now that we no longer
build libkse. This should fix WITHOUT_LIBTHR builds as a side effect.

Install manpage links for RB_PREV and RB_FOREACH_REVERSE.

Implement RB_PREV() AND RB_FOREACH_REVERSE().

Add sqrt() to the first table in the manpage. It seems it was accidentally
omitted.

Don't imply O(n) removal for the doubly linked data structures.

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

Reviewed by: deischen, davidxu

Remove an obsolete paragraph that pthread_single_np(3) is
not implemented in libthr.

Reviewed by: deischen, davidxu

Tweak the handling of "WITHOUT_LIBPTHREAD". Also remove the accidental
treatment of 'LIBKSE' as an "old style" knob.

Submitted by: ru
Approved by: re(kensmith)

Repo copy libpthreads to libkse.
This introduces the WITHOUT_LIBKSE nob,
and changes WITHOUT_LIBPTHREADS to mean with neither threading libs.
Approved by: re(kensmith)

Document that EPERM is returned when the calling thread does not have
the mutex locked. Also tweak the wording to make it more consistant
between pthread_cond_wait and pthread_cond_tiedwait.

Confirmed with the opengroup's web site that this is a valid return
value. Wording used specifically not that of opengroup's online man
pages.

MFC After: 1 week

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

Xref pthread_condattr.3, pthread_attr.3, and pthread_mutexattr.3.

PR: 60679
Submitted by: roam (with minor modifications)

o Expand "Nov" to "November" in Dd macro, remove eol whitespace.

Add error code EPERM.

Reviewed by: ru, deischen

Bring manpage up-to-date with respect to the scheduling priority
range, and mention the SCHED_OTHER scheduling policy.

Submitted by: davidxu
PR: docs/37843
MFC after: 3 days

Revise markup.

Removed libc_r build support.

Remove mentions of libc_r.

o Add pthread_yield.3 man page.

PR: docs/100083
Reviewed by: deischen, ru
Obtained from: OpenBSD
MFC after: 2 weeks

Markup fixes.

The removal of CIRCLEQ left four queue macros. One sentence was missed
in the man page update.

PR: docs/94938
Submitted by: Ed Schouten <ed@fxq.nl>
MFC After: 3 days

Typesetting fix for -r1.137.

If a tail queue is empty the return value of TAILQ_LAST is not
undefined, it is NULL.

Submitted by: Ruslan Ermilov <ru@FreeBSD.org>

If a tail queue is empty the return value is not
undefined, it is NULL.

Reimplementation of world/kernel build options. For details, see:

http://lists.freebsd.org/pipermail/freebsd-current/2006-March/061725.html

The src.conf(5) manpage is to follow in a few days.

Brought to you by: imp, jhb, kris, phk, ru (all bugs are mine)

- Massage wording to make it easier to understand and fix some grammar.

Submitted by: sbahra at gwu dot edu
Reviewed by: ru@
Approved by: ceri@
MFC after: 3 days

Does not return EBUSY, the mutex will keep blocking until it's unlocked.

Add the RB_PROTOTYPE_STATIC and RB_GENERATE_STATIC macros.

Approved by: markm (mentor)

o Sort MLINKS.

Add the RB_NFIND() macro, which is useful for red-black tree searches
for which there may not be an exact match.

Reviewed by: glebius, julian
Approved by: markm (mentor)

Style fixs, add missing word 'signal'.

Reviewed by: deischen

Add siginfo.

Fix prototype.

Remove a spurious newline. The TAILQ_INIT() is part of the 'faster tailq
deletion' example.

MFC after: 1 week

Fix typos and use consistent section names in manual pages:

s/SYSCTLS/SYSCTL VARIABLES/
s/TUNABLES/LOADER TUNABLES/
s/CAVEAT/CAVEATS/
s/DESCIPTION/DESCRIPTION/

Reviewed by: ru
MFC after: 3 days

Use 'manual page' instead of 'man page' for consistency.

Approved by: re (hrs)

(Mostly) markup fixes.

Approved by: re (blanket)

The correct copyright notice for manpages that copy material from Open
Group's documentation is `/usr/share/examples/mdoc/POSIX-copyright',
not the one I copied from `/usr/share/examples/etc/bsd-copyright'.

Suggested by: simon
2nd pointy hat of the day: yours truly

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>

Remove fpsetsticky(). This was added for SysV compatibility, but due
to mistakes from day 1, it has always had semantics inconsistent with
SVR4 and its successors. In particular, given argument M:

- On Solaris and FreeBSD/{alpha,sparc64}, it clobbers the old flags
and *sets* the new flag word to M. (NetBSD, too?)
- On FreeBSD/{amd64,i386}, it *clears* the flags that are specified in M
and leaves the remaining flags unchanged (modulo a small bug on amd64.)
- On FreeBSD/ia64, it is not implemented.

There is no way to fix fpsetsticky() to DTRT for both old FreeBSD apps
and apps ported from other operating systems, so the best approach
seems to be to kill the function and fix any apps that break. I
couldn't find any ports that use it, and any such ports would already
be broken on FreeBSD/ia64 and Linux anyway.

By the way, the routine has always been undocumented in FreeBSD,
except for an MLINK to a manpage that doesn't describe it. This
manpage has stated since 5.3-RELEASE that the functions it describes
are deprecated, so that must mean that functions that it is *supposed*
to describe but doesn't are even *more* deprecated. ;-)

Note that fpresetsticky() has been retained on FreeBSD/i386. As far
as I can tell, no other operating systems or ports of FreeBSD
implement it, so there's nothing for it to be inconsistent with.

PR: 75862
Suggested by: bde

Expand *n't contractions.

Document EBUSY.

PR: 73387
Submitted by: Thomas Ludwig <tludwig@smr.ch> (original version)

Fixed xref.

Sort sections.

Improved markup.

Some grammar, spelling, and mdoc(7) fixes. No content changes.

PR: 75581
Submitted by: Nobuyuki Koganemaru n-kogane@syd.odn.ne.jp (original version)

NOLIBC_R -> NO_LIBC_R
NOLIBPTHREAD -> NO_LIBPTHREAD
NOLIBTHR -> NO_LIBTHR

Mutually cross-reference sysexits(3) and err(3). Add text to err(3)
recommending that the standard exit codes in sysexits(3) be used.

Reviewed by: ru

Sort MAN and MLINKS in dictionary order ignoring case.

Add a man page for tgmath.h.

Reviewed by: keramida

mdoc(7) fixes.

Added missing punctuation.

Mechanically kill hard sentence breaks and double whitespaces.

Removed trailing whitespace.

Spelling fixes.

Fixed markup bugs.

Fixed markup bugs.
Spell function correctly when talking about restarting after a signal.

Cross-reference fenv(3).

Add missing links.

Support for dynamic adjustment of FPU precision is only available on
i386 and amd64, so fp[gs]prec(3) don't exist on other platforms.

PR: 52882

Add a LIBRARY section.

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

Implement PThreads barriers and barrier attributes.

o Implement the pthread_spin_* functions in libthr.
o Man pages

Use a single style for share/man/ makefiles:

- Sort MAN and MLINKS in "dictionary" order ignoring case.

- For multi-value MAN and multi-pair MLINKS, put each value/pair
on its own line, for easier sorting and so that further diffs
are easier to see.

Add an implementation of pthread_rwlock_timed{rd,wr}lock() to libthr with
attendant documentation.

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.

Removed the IMPLEMENTATION NOTES section made redundant by not
putting libc_r into the LIBRARY section.

pthread_multi_np() is implemented in all threading libraries.
pthread_single_np() is not implemented in libthr.

Revert previous delta -- these interfaces aren't supported by libthr.

Document interfaces that are supported by libthr.

Assorted markup fixes.

Spell POSIX threads library as "libpthread", mdoc(7) is smart
enough to render it as "-lkse" these days.

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

This interface is not provided by libc_r. It is, on the other
hand, is also provided by libthr, but this will be addressed
later.

Pull revision 1.13 from libpthread/man/pthread_mutex_init.3:

- Remove error code that can't be returned (and original description
was not proper English)

PR: docs/57434

Aargh, cvs add pthread_mutex_timedlock

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

RB_EMPTY() applies to red-black trees, not splay trees.

Get rid of duplicates.

mdoc(7): Properly mark C headers.

mdoc(7): Use the new feature of the .In macro.

Add safe _FOREACH iterators to the rest of the queue.h types.

Document LIST_FOREACH_SAFE in queue(3).

Asked with "please" by Ruslan Ermilov. I've always had a weakness
for "please".

mdoc(7) fixes.

Approved by: re (blanket)

Add stub implementations of pthread_[gs]etconcurrency to libc_r and
libthr. No changes were made to libpthread by request of deischen,
who will soon commit a real implementation for that library.

PR: standards/50848
Submitted by: Sergey A. Osokin <osa@freebsd.org.ru>
MFC after: 1 week

The .Fn function. Use .Xr where appropriate.

mdoc(7) police: Scheduled sweep.

Add AUTHORS section

Finally! Document all undocumented functions in libc_r.

Add manual pages for following functions:

. pthread_attr_setcreatesuspend_np(3)
. pthread_main_np(3)
. pthread_multi_np(3)
. pthread_single_np(3)
. pthread_mutexattr_getkind_np(3)
. pthread_mutexattr_setkind_np(3)
. pthread_resume_all_np(3)
. pthread_resume_np(3)
. pthread_set_name_np(3)
. pthread_suspend_all_np(3)
. pthread_suspend_np(3)
. pthread_switch_add_np(3)
. pthread_switch_delete_np(3)

MFC after: 3 days

Break important implementation detail note into IMPLEMENTATION DETAILS
section. Add cross reference to pthread_attr_getstack() function.

MFC after: 1 day

Add cross reference for pthread_attr_get_np()

Add pthread_attr_getstack() and pthread_attr_setstack().

Submitted by: Craig Rodrigues <rodrigc@attbi.com>

The .Fn function

Document additional behaviour of this function (see
rev 1.3 of uthread_attr_get_np.c)

pthread_attr_get_np() now takes 'pthread_t' (not 'pthread_t *')
to be consistent with other pthread_XXX functions

english(4) police.

mdoc(7) police: Deal with self-xrefs.

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

mdoc(7) police: markup overhaul.

Uniformly refer to a file system as "file system".

Approved by: re

mdoc(7) police: overhaul.

Consistently mark std(in|out|err) with .Dv, because that's how they
are marked up in stdio(3), and because they are defined expressions
of type "FILE *".

Approved by: re

mdoc(7) police: scheduled sweep.

Approved by: re

Add & hookup manpage for pthread_attr_get_np(3).

MFC after: 3 days

Make the example "assertion failure" message match reality.

Update the Standards section for the addition of the C99 va_copy macro.

Implement C99's va_copy() macro.

Fix a typo.

MFC after: 3 days

Install the tree(3) man page.

This commit was generated by cvs2svn to compensate for changes in r98681,
which included commits to RCS files with non-trunk default branches.

More file system > filesystem

Document STAILQ_CONCAT and TAILQ_CONCAT.

PR: 20024
Submitted by: Tony Finch <dot@dotat.at> (TAILQ_CONCAT, slightly changed
by me)
Reviewed by: ru (earlier version)

mdoc(7) police: tidy up.

Add a bunch of functions.

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

fix MLINKS for timeradd.3

Add manpage for timeradd macros and friends. A companion page for
timespecadd should be added at a future point...

PR: 13079

mdoc(7) police: tidy up previous delta.

Document some behaviour I'm depending on.
(TAILQ_FOREACH leaves the variable NULL if there were no more to do)

mdoc(7) police: one-line literal displays are faster.

Describe handling of NULLs passed to pthread_setcancelstate().

PR: docs/31745
Submitted by: Andrew <andrew@ugh.net.au>

Mark up NULL in .Dv.

PR: 31747
Submitted by: <andrew@ugh.net.au>

Only provide function information in compile environments that support
the C99 variable __func__ and never for C++. Provide a more meaningful
example in the assert(3) manual.

Reviewed by: asmodai, bde

Document C99 conformity.
Update text which is printed out to reflect reality.

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

STAILQ_LAST() macro takes 3 arguments, not 1.

Remove unused variable in example.

mdoc(7) police: s/OpenBSD/.Ox/ where appropriate.

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

mdoc(7) police:

Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text.
Not only this slows down the mdoc(7) processing significantly, but it also
has an undesired (in this case) effect of disabling hyphenation within the
entire enclosed block.

Implement pthread_attr_[gs]etguardsize(). Non-default-size stacks used to
be malloc()ed, but they are now allocated using mmap(), just as the
default-size stacks are. A separate cache of stacks is kept for
non-default-size stacks.

Collaboration with: deischen

Remove whitespace at EOL.

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: removed HISTORY info from the .Os call.

mdoc(7) police: remove extraneous .Pp before and/or after .Sh.

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

Typo fix: requires -> reacquires

Submitted by: Murray S. Kucherawy <msk@sendmail.com>
MFC after: 3 days

Add a missing word.

Obtained from: OpenBSD

Add a missing word.

Fixed typo in the description.

PR: docs/27411
Submitted by: David Wimsey <dwimsey@rtci.com>

MAN[1-9] -> MAN.

Remove the last remnants of circle queues.

PR: 25184
Submitted by: Alex Kapranoff <alex@kapran.bitmcnit.bryansk.su>
Approved by: nik

mdoc(7) police: fix markup.

mdoc(7) police: utilize .St macro.

Use ``.St -p1003.1-96''.

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

.St -ansiC -> .St -isoC

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.

Fix typo.

PR: docs/23936
Submitted by: Garret Rooney <rooneg@rpi.edu>

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

mdoc(7) police: Ft/Vt now accept punctuation-type arguments.

Remove comma after final .Nm entry before .Nd

Remove CIRCLEQ manual page links now that CIRCLEQ has been axed.

Prepare for mdoc(7)NG.

CIRCLEQs are a disgrace to everything Knuth taught us in Volume 1 Chapter 2.

Retire them before anybody starts to use them again.

Use TAILQ instead, it provides the same functionality.

Prepare for mdoc(7)NG.

mdoc(7) police: use the new features of the Nm macro.

mdoc(7) police: use certified section headers wherever possible.

remove fullstops from the end of .Xr lines in SEE ALSO sections.

Use Fx macro wherever possible.

Avoid use of direct troff requests in mdoc(7) manual pages.

Manpage incorrectly states that STAILQ_REMOVE_HEAD takes an arg
called 'elm'. It doesn't take an arg 'elm', it simply removes the
element at the head of the list.

Whitespace-only change: fix hard sentence breaks in previous commit.

Apply fixes from NetBSD to bring this manual page into reallity.

Inspired by: ru & 4.4BSD Design and Implementation
Obtained from: NetBSD

Fix minor typo.

pthread_once --> pthread_once_t.

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

Add MLINKS for queue(3) FOREACH_REVERSE and HEAD_INITIALIZER macros.

Forgotten by: jake, archie

(1) document *_HEAD_INITIALIZER
(2) fix a STAILQ_HEAD that should have been STAILQ_FIRST

Requested by: (1) bde
(2) W Gerald Hicks <jhix@mindspring.com>

Fix a misspelling: undefied -> undefined

Add MLINKS for all macros decribed in queue.3 manpage.

"Fixed" missing include in synopsis. POSIX.1-1996 only specifies
including <signal.h>, but that must be a bug in POSIX.1, because it
also specifies that the relevant prototype is [only] in <pthread.h>.

Fixed misspelling of a struct tag in a function parameter type.

Fix miscellaneous mdoc macro argument limit infringements.

PR: 18465
Reported by: Kazu TAKAMUNE <takamune@avrl.mei.co.jp>

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 .El macro.

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

Document TAILQ_FOREACH_REVERSE() and CIRCLEQ_FOREACH_REVERSE() macros.

Submitted by: Jake Burkholder <jburkhol@home.com>

Introduce .Lb macro to libc_r manpages.

Update STAILQ example to use STAILQ_REMOVE_HEAD instead of
TAILQ_REMOVE_HEAD.

PR: docs/17590
Submitted by: Benno Rice <benno@netizen.com.au>

Remove more single-space hard sentence breaks.

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.

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.

s/curses/ncurses/

PR: docs/17061
Submitted by: Udo Erdelhoff <ue@nathan.ruhr.de>

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

Mandate the inclusion of <ieeefp.h> instead of <floatingpoint.h>. The
latter is just wrong.

There were many other problems spotted by bde, none of which are
addressed here.

Reviewed by: bde

Fixed bitrot in synopsis. The change from "int *pshared" to "int pshared"
hadn't reached here.

Sync with reality.

PR: docs/15036
Submitted by: Jake Burkholder <jburkhol@home.com>

Fix typos

PR: docs/14858
Submitted by: OKAZAKI Tetsurou <okazaki@be.to>

Document pthread_create().

Reviewed by: jasone

add pthread_cancel, obtained from OpenBSD.

eischen (Daniel Eischen) added wrappers to protect against cancled
threads orphaning internal resources.

the cancelability code is still a bit fuzzy but works for test
programs of my own, OpenBSD's and some examples from ORA's books.

add readdir_r to both libc and libc_r

add some 'const' attributes to function parameters

Reviewed by: eischen, jasone

$Id$ -> $FreeBSD$

Fix EINVAL related descriptions.

Bad reference exit(2) changed to exit(3)

Add $Id$, to make it simpler for members of the translation teams to
track.

The $Id$ line is normally at the bottom of the main comment block in the
man page, separated from the rest of the manpage by an empty comment,
like so;

.\" $Id$
.\"

If the immediately preceding comment is a @(#) format ID marker than the
the $Id$ will line up underneath it with no intervening blank lines.
Otherwise, an additional blank line is inserted.

Approved by: bde

fix the links to the bitstring man page..

fix wording in man page, through != to

Removed extraneous comma in xrefs.

Added missing comma in xrefs.

Minor punctuation/grammar nits.

Typo fix (set --> get).

Obtained from: OpenBSD (David Leonard)

Fixed bitrot in synopsis (some const poisoning hadn't reached here).

Fix typo by rewriting sentence.

Added pthread read/write locks.

Implement pthread read/write locks as defined by Version 2 of the Single
UNIX Specification.

As with our standard mutexes, process shared locks are not supported at
this time.

Sort cross references.

Changed prototype in synopsis to match prototype in <pthread.h>.

The pthreads standard has been published. Change:
...is expected to conform to IEEE (``POSIX'') Std 1003.1c when it is
published.
to:
...conforms to ISO/IEC 9945-1 ANSI/IEEE (``POSIX'') Std 1003.1 Second
Edition 1996-07-12.

Discussed with: jb

I've put together man pages for the pthread_cleanup, pthread_cond, and
pthread_mutex routines. I've also tweaked pthread_create.3 to point to
pthread_cleanup_push(3) and pthread_cleanup_pop(3).

PR: 7450
Submitted by: Brian Cully <shmit@kublai.com>

Spelling corrections.

PR: 6868
Submitted by: Josh Gilliam <josh@quick.net>

Typo fixes

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

This function compiles with the standard, so say so.

This function compiles with the standard, so say so.

Add a note about not touching errno and warn about previous drafts
of the standard which changed the level of indirection to the thread
argument. POSIX had a bit of trouble deciding what to do. So anyone
coding to both draft 4 and draft 10 (the final draft) will get burnt
by this function. I did. Grrr.

Fixed a function arg type in the synopsis.

Document the fpgetprec/fpsetprec functions in their man page.
Add cross-references to the elusive fpsetmask() function to various other
man pages.
Reviewed by: bde

Expanded cross references.

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

Fixed type bugs in synopsis. Some of the typedefs that were used here
haven't existed for years, if they ever existed. The "prototypes" are
actually for macros, so they are difficult to check automatically.

Fixed misuse of .Ft for enum members. (.Fa seems to be the best
available macro for enum, struct and union members. .Ft seems to
be the best available macro for enum, struct and union tags and
types).

Fixed missing void arg types.

Fixed wrong number of args in STAILQ_REMOVE_HEAD() in synopsis.

The CIRCLEQ_ENTRY example was wrong. Part of PR# 2917.

add missing cvs Id lines.

Revert $FreeBSD$ to $Id$

Revert $FreeBSD$ back to $Id$

Bring intro(3) a bit closer to reality:

1) comment out xref to non-existant libc(3)
2) comment out reference to Fortran specific section (3f)
3) add libkvm with reference to kvm(3)
4) comment out xref to non-existant pc(1)
5) comment out libplot and libplotf77
6) fix problem with -ltermcap not being parenthesized
7) sort files listing

still missing most of the libraries that exist in /usr/lib.

Closes PR#1151

Minor mdoc cleanup.

I just found a bug in my program, I was calling va_arg (..., char),
when parsing a printf-like arg list. Looking for someone to blame,
I noticed that the man page has a bad example. It clearly says at
the top that types following the last known argument are passed after
their default type conversions, and then later the example uses

va_arg (..., char);

so I fixed it.

Sort cross references.

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.

Sort cross references.

Add SLIST_EMPTY, SLIST_FIRST, SLIST_NEXT.

Is it time to split this into one "intro" type and a number of
detailed pages ?

add missing comma(s) in .Xr macros

fix .Xr macro

Use the .Bx macro where appropriate.

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.

Another man page with a messed up .Dd line.

Indicate that assert exits with abort(3) instead of _exit(2). Closes
PR 1317.

Reviewed by: alex
Submitted by: Cove Schneider <cove@brazil.nbn.com>

add manpage links

TAILQ_EMPTY.3 -> queue.3
TAILQ_FIRST.3 -> queue.3
TAILQ_LAST.3 -> queue.3
TAILQ_NEXT.3 -> queue.3

Document 5 new macros in TAILQ family.

Correct some man page xrefs, and some other minor changes to bring some
man pages up to mdoc guidelines and fix some minor formatting glitches.
Also fixed a number of man pages to not abuse the .Xr macro to
display functions and path names and a lot of other junk.

Add man page links for the SLIST_* and STAILQ_* macros that were added
recently.

Add sysexits(3). It's horrible to always examine the include file for
this.

Update the queue man page for the new SLIST and STAILQ macros.

4.4Lite2 implemented the LIST_INSERT_BEFORE and TAILQ_INSERT_BEFORE
exactly as I did (should have checked there first I guess) except my
macro for TAILQ_INSERT_BEFORE took an unneeded arg. We now match 4.4Lite2.

Suggested by: Jeffrey Hsu <hsu@FreeBSD.org>

Added some missing MLINKS for section 3 man pages.
Also corrected a few minor formatting errors, file location and cross
references in some of the section 3 man pages.

This shuts up a lot of the output from "manck" for section 3.

Fix a bunch of spelling errors in a bunch of man pages.

Add LIST_INSERT_BEFORE and TAILQ_INSERT_BEFORE.

Change examples to actually free() the nodes removed from lists.
Give examples of faster list deletion routines.

Remove private rules for clean, depend, lint, tags and install.
The private clean rules have been broken since we started
building compressed man pages in the obj directory and the
others don't do anything different from the general rules.

the man-link for moncontrol soesn't belong here...

Obtained from: 1.1.5 (originally by Andrew Moore)

Add the manpage for the stuff in <machine/floatingpoint.h>.

Make man page installation work for ``unattached'' and kernel pages.

This commit was generated by cvs2svn to compensate for changes in r1638,
which included commits to RCS files with non-trunk default branches.