25.3.1 Following WAI guidelines for links

The HTML title attribute is commonly used in links, where it “hides” the value of the href attribute that is otherwise shown, replacing it with a text description of the link destination. For more information about WAI guidelines for links, see:

http://www.w3.org/TR/WCAG10-HTML-TECHS/#links

You can provide a title attribute for a link either with a paragraph format or with a custom marker; and either may reference macro variable <$$_linksrc>.

---