Clarify documentation (bug #3495)