I think it would be useful to be able to define anchors and links to those
anchors with rdoc. I'd like to see this feature in a future version. I
could do things like build a TOC as a bulleted list of links to H1's and
link from class/method doc to examples.