This is very complete and I can't think
of much to add.
Is it possible to have html links in documentation,
or better yet html code? I know "see" has this ablity, but what about in a
general comment. For example In some cases you
may want to insert a picture of what your talking
about.