update documentation, add CAVEATS section
add clear method
fix test
bump version 0.03