I know most of the java development tools for Eclipse will have a short-cut script for adding in JavaDoc blocks for needed elements (including the page-level).
Further, I know that PDT will allow you to “Generate Element Comment” for many things through the Source menu.
Is there an Eclipse plug-in out there (or perhaps it exists standard in PDT and I’ve just missed it) that will allow you to add PHPDoc Blocks for all/some of the supported elements in a given file?
place your text cursor right above your function, class or whatever,
type /** and press enter and you’ll have a beginning of PHPDoc written.
Eg.
You can then write
@inside the comments, and use@followed by ctrl+space to get auto-completion hints for PHPDoc tags.