more tests and documentation updated