updated documentation for issue #1074