some clarifications in the manual