DocBlock corrections and typo fixes

: )
Please revert all changes in this file. The symfony request is in fact correct.