documentation for issue #3049