I wasn't very active last year on phpdoc, so I don't know current status/ideas about samples:
From DocMeeting protocol (March 2002 in Stuttgart):
<cut>
The examples in the manual should be more consistent and useful. A draft styleguide alredy exists under phpdoc/RFC/coding_standards. Additional ideas that came up were syntax highlighting and linking functions in examples to their manual pages, which need either post-processing of the HTML output or the ext/xslt changes already discussed.
We also talked about having a similar feature as the old pre-Windows Borland IDEs where it was possible to copy working examples to the clipboard with a special single keystroke. Possible ways to implement this for plain HTML and for CHM have to be examined ...
Having an example index and additional code-only pages for examples might be an alternative to this.
</cut>
Do we already have a solution? How about to provide samples for download?
Look into the 2003 meeting findings, we discussed this issue there too!
Goba