RFR: JDK-8292157: Incorrect error: "block element not allowed within inline element <a>"

Hannes Wallnöfer hannesw at openjdk.org
Mon May 15 14:49:55 UTC 2023


Please review a change to downgrade from error to warning if the label of a `<a>` element or reference tag contains an HTML block element. Before HTML 5, elements were clearly divided into block and inline elements, and the latter were not allowed to contain the former. 

With HTML5, the division between block and inline elements is delegated to CSS, and although elements have default styles, styles can be freely customized by the author. This applies especially true for the `<a>` element which is commonly used both with inline and block layout. That was the rationale for downgrading from error to warning for the `<a>` element only. See the JBS issue comments for details and references.

The error message for the warning was enhanced to refer to the default style for the `<a>` element.

-------------

Commit messages:
 - JDK-8292157: Improve warning messages
 - Merge branch 'master' into JDK-8292157
 - JDK-8292157: Incorrect error: "block element not allowed within inline element <a>"

Changes: https://git.openjdk.org/jdk/pull/13990/files
 Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=13990&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8292157
  Stats: 31 lines in 4 files changed: 13 ins; 0 del; 18 mod
  Patch: https://git.openjdk.org/jdk/pull/13990.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/13990/head:pull/13990

PR: https://git.openjdk.org/jdk/pull/13990


More information about the javadoc-dev mailing list