[java] Improve CommentSize

[oowekyala]

Rule: CommentSize

Describe the PR

• CommentSize didn't report long lines on the right lines but always on the first line of the comment.
• When counting the characters of long lines, the indentation (white space) is ignored as well as the comment markers at the beginning of the lines (e.g. *, //).

Related issues

• Fixes #

Ready?

• Added unit tests for fixed bug/feature
• Passing all unit tests
• Complete build ./mvnw clean verify passes (checked automatically by github actions)
• Added (in-code) documentation (if needed)

[pmd-test]

	2 Messages
📖	Compared to pmd/7.0.x: This changeset changes 6 violations, introduces 52834 new violations, 1 new errors and 0 new configuration errors, removes 44 violations, 1438 errors and 0 configuration errors. Full report
📖	Compared to master: This changeset changes 50621 violations, introduces 34682 new violations, 9 new errors and 0 new configuration errors, removes 141951 violations, 4 errors and 7 configuration errors. Full report

Generated by 🚫 Danger

[jsotuyod]

Great finding!

Now that this is fixed however, it seems like a poor rule, specially regarding the "number of lines part"… at the very least I think Javadocs should be treated differently. I don't think there is any scenario were having "too much" javadoc is ever an issue, on the contrary, people usually complain for the lack of it…

I suggest we add a new property maxJavadocLines, with a more sensible default (ie: -1 to have no limit?)