This is somewhat what the entire method does, and therefore I suggest putting it in the method javadoc. Also, when something is a programming idiom, always consider leaving out the explanation and assume people know this (they should know idioms anyway).