The following sentence in DateFormat.Field defeats the break iterator used to find the first sentence of a description.
/**
* Constant identifying the time of day indicator
* (e.g. "a.m." or "p.m.") field.
*/
This leads to the incomplete API seen in the attachment.
Recommend one of:
* change `e.g.` to `for example`
* enclose `e.g.` in `{@literal ...}` (to prevent it being seen as end of sentence
* enclose entire sentence in `{@summary ...}` to force the contents of the first sentence.
/**
* Constant identifying the time of day indicator
* (e.g. "a.m." or "p.m.") field.
*/
This leads to the incomplete API seen in the attachment.
Recommend one of:
* change `e.g.` to `for example`
* enclose `e.g.` in `{@literal ...}` (to prevent it being seen as end of sentence
* enclose entire sentence in `{@summary ...}` to force the contents of the first sentence.