Hi Eddie:
> 3) "Why use Reflection?" - an analysis of realistic cases where
> Reflection is useful, perhaps linking ot external resources for
> further research (wikipedia, probably)
>
> And basically, I've not seen (not that it doesn't exist), an example
> of #3 in use in the PHP manual any where, nor can I find any sort of
> RFC or guideline forbidding it. So, my question is whether or not
> that sort of documentation is allowed or not.
You're making a very good point. It makes a lot of sense to have a
"Purpose" section. A simple paragraph or two telling folks how this
class/extension/whatever can make your life better.
Thanks,
--Dan
--
T H E A N A L Y S I S A N D S O L U T I O N S C O M P A N Y
data intensive web and database programming
http://www.AnalysisAndSolutions.com/
4015 7th Ave #4, Brooklyn NY 11232 v: 718-854-0335 f: 718-854-0409