A little JavaDoc with expectations about the input and especially how the return value will be interpreted?