fixes for issue #1 and documentation