PHPdoc block formatting

phpdoc.php

<?php

/**
 * One line description then an empty line
 * 
 * Optional additional description, multiline if needed, with
 * code examples, links, anything
 * 
 * Can be separated in multiple paragraphs, as long as there's
 * a blank line before the first @tag
 *
 * @param  bool   $stuff      The first @param must be after a blank line, even if other @tags are used before
 * @param  string $param_one  Descriptions in one line, at least two spaces after the $var name
 * @param  int    $var        Other descriptions should be aligned to the rightmost description
 * @return array              Minimum should be @param and @return tags (if applicable)
 */
... <code> ...