And adding a comment in the docblock which tells the whole story would be nice. We should've done that from the beginning I guess.