[Bug #8526] Documentation improved