updated documentation plus small fixes
expanded new tests
new functions added