"Jason Johnson" <jason.johnson.081 at gmail.com> wrote in message
> But a better question is *why would you*?  From an OO design point of
> view, a CompiledMethod has nothing to do with documentation, it does
> not need something like that to do it's job.  Documentation, however
> refers to compiled methods.  So the documentation classes should point
> to what they document, and you can put a method on CompiledMethod like
> so:

+1

Also means that as code is changed e.g. re-factored, we have a handle to 
find which documentation may need to be changed, perhaps in some cases even 
update it automatically.