if you remove this micro-comment, your beautiful explanation of this function will end up in javadoc