symfony/symfony — pull request #3055 by weaverryan (2012-01-07 21:43:50+00:00)
Title: More extensive PHPDoc for Security interfaces

Hey guys!

We've started to get into the habit of documenting interfaces and methods in the official docs. I think these things should be omitted from the documentation entirely, and replaced with a link to API docs that rock (I've started doing this already).

This PR just takes some of the details we have in the docs and pushes them back as PHPDoc. I use `@see`, `` and changed a particular `@throws` to have a FQ class name since there's no `use` statement.

Thanks!