Using Doc-To-Help Markup Language Hot Spots in XML Comments

It is possible to use Doc-To-Help Markup Language (D2HML) in your XML source code comments (e.g., to create links from reference topics to narrative topics—written manually by the author).

To format a range of text in your XML comment with any D2HML style, use the <span> tag with a style attribute. Since it lets you use all styles, you have the full power of D2HML for creating hot spots of any kind. You can create topic links, keyword links, expanding text, and other kinds of hot spots. See Doc-To-Help Markup Language.

Example  

You can add a link to a Doc-To-Help topic like this.

Copy 
<remarks>
    These are my remarks and there is a link to <span style="C1H Jump">this topic|tag=mytopic</span> here
</remarks>

Note Although the standard XML comment tag <see> lets you create links to assembly element topics, it does not allow you to create links to narrative topics in your online output. Using the <span> tag, you can easily overcome this limitation. In fact, the <span> tag allows your XML comment text to use all Doc-To-Help features available in Word source documents via D2HML.