updated documentation
exposed functions that should be public