update documentation: boolean behaviour