1. Introduction
   micoro (for MIcro COROutine & MIke's COROtine) is a light weight, high
performance coroutine implementation.
   The basic idea of micoro come from the paper "Revisiting Coroutines"
(https://www.inf.puc-rio.br/~roberto/docs/MCC15-04.pdf). As the paper proved,
the "full asymmetric coroutine" model is powerful, easier to use and 
expressive power equivalent to other similar models. So micoro is actually
a "full asymmetric coroutine" implemenation with simple API and clear 
semantics.
   The original motivation of micoro is to implement a light-weight 
cooperative multitasking infrastructure for server environment, so simple, 
performance and robust (rather than portability) is often the top 
considerations across disign and implementation. 
   some features:
   * x86 user space fast context switch
   * x86 user level light-weight lock
   * thread-safe operations
   * stack overflow detection
   * robust code with careful design and test
   * portable for non-x86 using ucontext
   * running activity statistics
2. Requirement
   Currently only POSIX systems are supported.
   Some tested platform:
     Linux-2.6.16  x86_32
     Linux-2.6.32  x86_64
     Linux-3.2     x86_64  GCC-4.7.1
     MacOS-10.7.4  x86_64  LLVM-GCC-4.2.1
     FreeBSD-9.0   x86_64  GCC-4.2.1
     Cygwin_NT-6.1   i686  GCC-4.5.3
3. Install
3.1 install from tarball
   tar -xvf micoro-1.0.tar.gz
   cd micoro-1.0
   ./configure
   make
   sudo make install
3.2 install from git source
   * require GNU autotools & libtool installed
   git clone git://github.com/mikewei/micoro.git
   cd micoro
   autoreconf -i
   ./configure
   make
   sudo make install
4. Performance
   micoro has much higher performance compared with others
   (e.g. GNU Pth, PCL, pthread ...)
   * my benchmark with a Linux-3.2 CoreDuo 2.1G PC
   context switch performance for 10000 concurrent routines:
   GNU Pth -     5,876 switches per second
   pthread -   237,318 switches per second
       PCL -   879,165 switches per second
    micoro - 4,577,256 switches per second
5. Bug report
   please email to <bin@vip.qq.com>