Fix dangling-doc-comments warnings

[mbien]

fixes hundreds thousands of javac warnings (dangling-doc-comments) and avoids situations when comments wrongly show up as javadoc.

• unintended line comment ('///')
• some dead (and commented out) code removal
• some removal of decorative comments
• fixed wrong annotation/doc ordering
• fixed package comments meant for classes
• various other dangling comment warnings

project wide, split into 7 commits across cluster boundaries (enterprise commit is the largest)

the remaining warnings are from generated code.

closes #8392

[lkishalmi]

OMG! This one kills my Firefox!

[ebarboni]

Huge tanks for doing this

[neilcsmith-net]

Thanks, looks good from what I can see.

My Firefox just about coping! 🤣

[mbien]

reviewing this via github is no fun, but one way of going through huge diffs is to look at the patch files of the individual commits

example: https://github.com/apache/netbeans/pull/8559/commits/01ef19cf8d5031d0836d3f230b22c852f343f5ce.patch

I use also a browser plugin called Enlight, it can provide syntax highlighting for code in general, but I use it only for patch/diff files, so that the patch link above will show up in the familiar colors.

I looked through it in NB, the vertical split button is very useful for that and I have prev/next mapped to mouse buttons.

Details

thanks for the reviews. Will merge once github resolved the problem with actions.

[mbien]

will rebase and merge, github works again