The {...@example} directive can optionally take an starting line number
(http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.inlineexample.pkg.html).
I've played with it with LoggerMDC.php and it would seem to allow us to add
the ASF source license header to the example PHP and .properties files without
adversely affecting the generated output (unless you really need to code
snippets in the docs to have the leading <?php.
I'm guessing that Doxia's snippet handler automatically closes a snippet at the
end of the file, so setting the line number just beyond the // START SNIPPET
and removing the // END SNIPPET eliminates those artifacts from the phpdocs.
The magic line number for .php files for me was 19 for .php files and 18 for
.properties files.
The LoggerMDC.php contained the line "The MDC is managed on a per thread basis"
3 times. Also, the <p><b><i> was rendered so a literal "<i>" was visible in
the generated documentation. Bold and italic and repetition seems extreme.
