Great Comments

Sometimes the comments really make the code reading worth it. I just found this comment describing the purpose of a method in some source code:

"Repeatedly polls the future until it is done"

I think that might be the best thing I've read all day! And yes, in context the comment makes a lot more sense.