> 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.

Hannes Wallnöfer has updated the pull request incrementally with one additional 
commit since the last revision:

  Rephrase doclint messages

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/13990/files
  - new: https://git.openjdk.org/jdk/pull/13990/files/bb6228bc..b3590063

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=13990&range=01
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=13990&range=00-01

  Stats: 5 lines in 2 files changed: 0 ins; 0 del; 5 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

Reply via email to