build: Provide npth.pc, generated by configure.
[npth.git] / README
1              nPth - The New GNU Portable Threads Library
2
3 * Overview
4
5   This is a library to provide the GNU Pth API and thus a
6   non-preemptive threads implementation.
7
8   In contrast to GNU Pth is is based on the system's standard threads
9   implementation.  This allows the use of libraries which are not
10   compatible to GNU Pth.  Experience with a Windows Pth emulation
11   showed that this is a solid way to provide a co-routine based
12   framework.
13
14   See the file AUTHORS for contact and copyright information.
15
16 * License
17
18   nPth is released under the LGPLv2+ license.
19
20 * Porting hints
21
22   Documentation is currently missing.  If you are using GNU Pth you
23   should be able to understand the API.  Given that GNU Pth is rarely
24   used, we hestitate to spend work on a migration guide.  If you have
25   questions, please ask on gnupg-devel.  Here are some hints:
26
27   - Pth mutexes are recursive, that is they will not block if called
28     by the same thread.  In contrast, nPth mutexes are not recursive;
29     it is best to change your code to avoid recursive use of mutexes.
30     nPth uses non-recursive mutexes for performance reasons.