fixed paragraphs in javadoc comments

[Zopsss]

All Submissions:

• Have you followed the guidelines in our Contributing document?
• Have you checked to ensure there aren't other open Pull Requests for the same update/change?

Hello there, I'm a contributor at @checkstyle, I was working on this issue: checkstyle/checkstyle#15685, my PR: checkstyle/checkstyle#15686

The issue is about fixing JavadocParagraph's Implementation, currently the check does not work when a paragraph tag have it's corresponding closing tag ( <p></p>), it only works when paragraph tag does not have its corresponding closing tag ( <p> ). I was trying to fix this problem and during this process I also found some other bugs which I have solved in the same PR.

The PR is almost ready to be merged but our semaphore CI was failing, here its error logs: https://checkstyle.semaphoreci.com/jobs/fa77db90-12db-42f2-b60f-5565630dba95

as I made changes in the JavadocParagraph's implementation and added support to check for <p></p>, Semaphore CI started giving error for pgjdbc repository, indicating that it has incorrect paragraph tags' placement. My mentor @romani suggested to send a PR to pgjdbc and fix the incorrect paragraphs' placement ( checkstyle/checkstyle#15686 (comment) ).

I have tried to fix it in this PR. I have made changes in javadoc comments and tried to fix the incorrect placements. Our Check was not able to detect these incorrect changes previously but after my PR gets merged, this bug will get fixed and Check's newer version be available in the next release.

I hope my PR gets attention of pgjdbc's maintainers, thank you :)

[vlsi]

This looks good to me.

https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html#format indeed suggests there should be no starting <p>, and many OpenJDK classes even omit </p> altogether.