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.