Summary

Update the spec for Taglet and StandardDoclet to better describe their interaction.

Problem

The Taglet API is a service provider interface (SPI) but does not adequately specify how it should be called. In addition, StandardDoclet does not specify any requirement on the text generated by a taglet, but should.

Solution

Specify how a doclet should interact with a taglet and the requirements on taglets invoked from the standard doclet.

Specification

There are no behavioral changes; this is just a clarification of existing behavior

Specdiff attached, and available at http://cr.openjdk.java.net/~jjg/8228561-taglet-stddoclet/specdiff-ref-taglet/overview-summary.html