Links are one of the most common items in generated documentation pages, but the methods to generate links are poorly organized, poorly documented, and are cluttering up a superclass of HtmlDocletWriter.

It would be better to move these methods to a new factory class, better organized, and better documented.