updated readme to reflect changes in code
updated internal documentation to reflect changes

done:
* updated internal documentation
* fixed a bug in the helper definitions

todo:
* testing
* possible factory function reference counting
* add better windows error messages