This morning on the Internals list, the subject of the Reflection API, and its lack of official documentation came up.
I emailed the original author of the unofficial documentation, Timm Friebe (CCed), about existing documentation. He has some docs at: http://sitten-polizei.de/php/reflection_api/docs/language.reflection.html and http://sitten-polizei.de/php/reflection_api/reflection.xml that we may incorporate into the manual verbatim (with structure changes, obviously).
Unfortunately, I've never added a complete section to the manual, and am in need of some virtual hand-holding. Especially since it will be difficult to adapt a current extension (why I thought I could pull this off in the first place) to this new content -- the reflection API seems unique to the other docs that exist (it's object oriented. I'm not sure if it should be considered an extension, or not, etc etc).
So, this is my admission of inadequacy, and my call for help. I don't mind pitching in, but I feel like I'll be banging my head on the proverbial wall, trying to do this without any sort of apprenticeship.
Would someone like to grab ahold of this, and let me virtually look over your shoulder on what you've done. I'm very keen on learning how to do it.
Thanks, S
