Page-level docblocks and phpdocumentor templates

Question

I'm having a really hard time to get phpDocumentor 2 working.

I have several files in procedural style, that must be documented. The only I found to do that is to use page-level docblocks, but it seems, that they don't work anymore correctly in phpDocumentor version 2.

A related question on stackoverflow shows that others run in the same problem. In this question there are two suggestions:

1. Add a namespace to the files that should be documented
2. As of phpDoc issue 910 use the template abstract or new-black

Unfortunately, I'm not able to get work either one.

1. When I add the namespace, the namespace itself shows up in the doc, but not the content of the docblock.
2. When I choose another template (I tried zend, abstract and new-black) whith the phar version of phpDoc 2, I get the error PHP Warning: XSLTProcessor::transformToUri(): No stylesheet associated to this object in phar. Apparently this is a known problem.

EDIT:

I'm a step further. I installed the PEAR version of phpDocumentor, and tried out each available template. But I'm still far from reaching the goal: page-level docblocks in the generated documentation.
The templates fall in two categories :

• clean, responsive, responsive-twig and old-ocean: They do not output page-level docblocks in the generated documentation.
• abstract, new-black and zend: They have a doc by file section, which show the expected file-level documentation. But they miss several ressources (.js files and images), therefore they look all the same, and do not work correctly (the navigation pane does not have expand-collapse behavior). I looked in their git repository, and the files seem to miss even there.

At this point I'm just wondering if I'm looking in the right direction: It seems inconceivable, that it is impossible to have a documentation showing file level docblocks, due to major regressions and bugs in phpDocumentor 2.

If I'm really on the wrong track, please suggest me how to get a valuable documentation out of my PHP project. If I'm on the right track, please help me to understand what important part in the puzzle I'm missing.

Gowk

Did you ever resolve this issue? – Aeroballistics

@brandon yes, by leaving phpdocumentor behind and going with doxygen. – Gowk