doc for issue #6