The new Taglet API provides a .toString method that should return the HTML used to replace the tag in the generated page.

The spec should document the required properties of that HTML and/or the context in which the HTML will be replaced.

While the properties are simple for an inline tag (for example, `{@link}`) ... it must be inline flow content, the properties are *not* obvious for a block tag ... currently the output will be embedded with `<dl>`, meaning that it should be a sequence of `<dt>` and `<dd>` tags. We could change that, of course, but that is what is expected today.