Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8304993

bad sentence break in DateFormat

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P4 P4
    • 21
    • 20
    • core-libs
    • b17

      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.

            jlu Justin Lu
            jjg Jonathan Gibbons
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: