API documentation generator #1

We have several choices for API documentation generation. There's the obvious one, PHPDocumentor. Then there's these little gems:

• varspool/sphpdox - sphinx/python based api docs generator compatible with readthedocs.org
• http://phpdox.de/
• http://www.apigen.org/
• https://github.com/FriendsOfPHP/Sami (created by fabien potencier. he also wrote these sphinx tools for readthedocs.org documentation. This is an example of sami api docs: http://api.symfony.com/3.2/index.html)
• http://www.stack.nl/~dimitri/doxygen/
• http://www.peej.co.uk/phpdoctor/#examples