Uploaded image for project: 'Accumulo'
  1. Accumulo
  2. ACCUMULO-2734

javadoc bug with multi-line @code tag

    XMLWordPrintableJSON

    Details

    • Type: Task
    • Status: Resolved
    • Priority: Trivial
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: 1.5.2, 1.6.0
    • Component/s: None
    • Labels:
    • Environment:

      Eclipse Kepler SR2

      Description

      This is an extremely trivial bug, but it's the last remaining javadoc warning showing up in Eclipse with pretty pedantic settings, so I'd like it removed.

      TableOperations.java has a javadoc which uses a multi-line javadoc code tag. Eclipse does not properly handle this. It's also not clear to me that the inner braces ending brace inside the code block shouldn't close the javadoc tag.

      https://bugs.eclipse.org/bugs/show_bug.cgi?id=206345

      This javadoc can easily use html escapes to render the special characters that the code tag is intending to prevent parsing of. I've already verified that this renders correctly with both javadoc 1.6 and 1.7.

        Attachments

          Activity

            People

            • Assignee:
              ctubbsii Christopher Tubbs
              Reporter:
              ctubbsii Christopher Tubbs
            • Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: