Evan,

I just pushed rt46173_addendum which extends hook documentation
according to your review comments.  Could you please take a look?  Also,
feel free to push any corrections you deem necessary to the branch.
Once reviewed, I plan to commit these changes without a CHANGES note.

Thanks!