Would like to be able to include links to images in Class/Interface/Namespace docs

I would like to embed (link to) images in generated documentation for a custom module API.

I am developing a special object-oriented "bridge" tutorial module for Drupal7 that is coded to offer a high level of support for reverse-engineering of PHP to UML using PEAR PHP UML and has extensive graphical Unified Modeling Language (UML) diagrams → for most major classes and interfaces of the tutorial module.

I would like to be able to display UML diagram images especially in the header docs for Classes and Interfaces, and in some cases also for operations/methods. And I would also like to be able to display Package overview diagrams for Namespaces.

An example of such a UML diagram for a Class is visible at DefaultMenuItem:

http://drupal7demo.webel.com.au/system/files/DefaultMenuItem.imp_.jpg

I would like to include such a diagram (by say 'src' reference) in the generated API docs for the Class at class DefaultMenuItem.

But when I naively insert the following into the header docs for the class:

<img src="http://drupal7demo.webel.com.au/system/files/DefaultMenuItem.imp_.jpg"/>

All I see in the generated API page is exactly the same thing but with the URL to the img as a link, like this:

<img src="http://drupal7demo.webel.com.au/system/files/DefaultMenuItem.imp_.jpg"/>

Grateful for any suggestions on how this can be done. See also:

http://drupal7demo.webel.com.au/module/ooe
http://drupal7demo.webel.com.au/module/ooe/uml
http://drupal7demo.webel.com.au/api/ooe