This docblock is amazingly good. Really, all of them are. I love how much effort you put into explaining what's going on in here.