I have a large Java project created more than 20 years ago: https://bitbucket.org/DanielAlievsky/algart/src/master/
Most of the classes and methods are documented in JavaDoc. Unfortunately, I used a lot of tags that became deprecated since Java 9, because they are incompatible with HTML5. In particular, I always used <tt>
instead of <code>
– it is shorter, and even Joshua Bloch recommended this as a possible option in early edition on his “Effective Java”.
Today I have a lot of classes with ~20000 errors, detected by javadoc utility (without -html parameter).
Are there any tools, allowing to cleanly replace some tag inside all JavaDoc comments inside some folder? “Сleanly” means that there is a guarantee, for example, that it will not correct string constants in operators like
String s = "<tt>my example</tt>"
and will not correct usual comments /*...*/
, that are not JavaDoc /**...*/
.
Now I use “find and replace” in IntelliJ IDEA (with regexp), but this require accurate manual checking all performed corrections – theoretically, replacement with regexp may corrupt some code.
Or, maybe, there is a tool that offer more intellectual corrections, for example, correction of all JavaDoc according requirements of HTML5?
2