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

[Hannes Wallnöfer]

> 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