The phpDocumentor tool generates documentation of the elements in your sources. The documentation is embedded in the source as comments. Nine distinct types of sections are understood by the tool: global variable, include, constant, function, define, class, variable, method, and page.
Every file inside your PHP project that you're going to process with phpDocumentor should start with a page level docblock, which documents certain aspects (like the author, package name, and so on) of this specific file. A docblock always starts with the sequence /**, unlike “normal” comments that usually start with only /*:
<?php /** * Page level docblock * @author Derick Rethans <email@example.com> * @package Examples */
After this ...