RFR: 8187591: -Werror turns incubator module warning to an error [v2]

[Adam Sotona]

> -Werror turns incubator module warning to an error
> This patch disables incubating module warning at compile time when "preview" lint category is disabled.
> It also adds a test, adjusts "preview" lint category description  and updates javac man pages.
> 
> Please review.
> 
> Thanks,
> Adam

Adam Sotona has updated the pull request incrementally with one additional commit since the last revision:

  separate LintCategory.INCUBATING

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/16454/files
  - new: https://git.openjdk.org/jdk/pull/16454/files/65378f60..0aee6895

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

  Stats: 19 lines in 6 files changed: 12 ins; 1 del; 6 mod
  Patch: https://git.openjdk.org/jdk/pull/16454.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/16454/head:pull/16454

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