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

Use <wbr> instead of ZERO_WIDTH_SPACE

    XMLWordPrintable

Details

    • Enhancement
    • Status: Resolved
    • P3
    • Resolution: Fixed
    • 17
    • 17
    • tools
    • None

    Description

      javadoc currently uses an entity ( `&#8203;`) for ZERO_WIDTH_SPACE to indicate to a user agent a position to break a run of characters. This is typically in a long signature, between the method name and left parenthesis.

      As a character, this appears in the displayed output, and is included if a user copies a signature for use elsewhere. The resulting "unusual" large hex Unicode character can cause surprise and confusion.

      An alternative to consider would be to use the HTML `<wbr>` element.

      As an added benefit `<wbr>` is a shorter string than `&#8203;` so the HTML files will also be smaller as a result.

      Attachments

        Issue Links

          Activity

            People

              hannesw Hannes Wallnoefer
              jjg Jonathan Gibbons
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: