To make it easier and more enjoyable to comment your PHP code (afterwards I suppose), I've developed a simple tool called PHPDocFill that does the following:
- scans the current folder and subfolder to find all php files in your project
- analyzes your PHP files to find PHPDoc documentable elements
- easily insert or edit documentation blocks
- it even generates a simple HTML manual based on the documentation found in all the files
Full documentation, information, downloads and screenshots are available on its official site.
Official site: http://cnedelcu.net/phpdocfill/