fix: to compile with JDK25 (#22142), suppress javadoc warning-as-error 'dangling-doc-comments'

[alex-kuzmin-hg]

Description:
Since JDK23, new javadoc warning introduced that fails current CN gradle build with JDK25 compiler.
The fix is to explicitly tell compiler to ignore cases of 'dangling-doc-comments'.

As a reference, there were "uncountable" number of old-style javadoc comments that failed gradle: see
them in diff: main...alexk/JDK25_sources
The suppressing/fixing all individual cases of such comments is less practical.

Related issue(s):

Fixes #22142

Notes for reviewer:

Checklist

• Documented (Code comments, README, etc.)
• Tested (unit, integration, etc.)

[lfdt-bot]

✅ Snyk checks have passed. No issues have been found so far.

Status	Scanner	Critical	High	Medium	Low	Total (0)
✅	Open Source Security	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

[codacy-production]

Coverage summary from Codacy

See diff coverage on Codacy

Coverage variation	Diff coverage
✅ +0.00% (target: -1.00%)	✅ ∅

Coverage variation details

	Coverable lines	Covered lines	Coverage
Common ancestor commit (d6728f7)	104428	78064	74.75%
Head commit (441ce3e)	104428 (+0)	78064 (+0)	74.75% (+0.00%)

Coverage variation is the difference between the coverage for the head and common ancestor commits of the pull request branch: <coverage of head commit> - <coverage of common ancestor commit>

Diff coverage details

	Coverable lines	Covered lines	Diff coverage
Pull request (#22144)	0	0	∅ (not applicable)

Diff coverage is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: <covered lines added or modified>/<coverable lines added or modified> * 100%

See your quality gate settings    Change summary preferences

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

@@            Coverage Diff            @@
##               main   #22144   +/-   ##
=========================================
  Coverage     70.87%   70.87%           
  Complexity    24476    24476           
=========================================
  Files          2682     2682           
  Lines        104523   104523           
  Branches      10972    10972           
=========================================
  Hits          74084    74084           
  Misses        26413    26413           
  Partials       4026     4026           

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[anthony-swirldslabs]

This is being solved under #20719

and

#21900