more documentation (issue #5174)