updated documentation
issue #1005: updated documentation