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

bad sentence break in DateFormat

    XMLWordPrintable

Details

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

    Description

      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.

      Attachments

        Issue Links

          Activity

            People

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

              Dates

                Created:
                Updated:
                Resolved: