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

Leading and trailing code blocks by indentation

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P3 P3
    • 24
    • 23, 24
    • tools
    • None

      From an email to javadoc-dev

      Using javadoc 23-ea the following snippet is not handled the way I would
      expect from the specification in JEP 467:

           /// @Override
           /// void m() {}
           ///
           /// Plain text
           ///
           /// @Override
           /// void m() {}
           public void m() {}

      First, javadoc complains on the first line that @Override is an unknown
      tag. But due to the indentation it should be parsed as code, not as a
      javadoc tag.

      Second, when I remove the offending line (or move it down one line),
      then the first code block is correctly rendered, but the second,
      trailing code block is silently dropped.

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

              Created:
              Updated:
              Resolved: