make phpdoc more specific
Merge pull request #45 from FriendsOfSymfony/phpdoc-improve

make phpdoc more specific