Improved description of library.  Added caveats.  Moved TODOs to top.

Signed-off-by: David Arbuckle <dintlu@gmail.com>