Claim in documentation not supported by code

[rcousens]

http://symfony.com/doc/current/cookbook/bundles/best_practices.html

I cannot find any reference in Symfony2 code to EventListener being a specific emplacement (I understand that it may be a convention) whereas the Command, Controller and Resources subdirectories have some degree of auto-wiring functionality during compiler passes hence the specific emplacement claim.

Command: src/Symfony/Component/HttpKernel/Bundle/Bundle.php <-- wires up Command directory
Controller: src/Symfony/Bundle/FrameworkBundle/Controller/ControllerNameParser.php <-- relies on a specific emplacement of Controller to generate short names
etc...

My understanding of "specific emplacement" is that it is mandated due to the way Symfony2 processes bundles being loaded into the AppKernel. Am I missing something here?

You could put listeners under any directory and it makes no difference. It's just poor style. This is not true for the other directories listed in the screenshot above.

[javiereguiluz]

What if we add a third column to that table explaining if the location is mandatory or convention?

[xabbuh]

@javiereguiluz sounds like a good idea to me

[rcousens]

I will submit a PR in the next 24 hours.

[rcousens]

Got time put aside to do this over the weekend. Promise it's coming!