javadoc

Java conventions, commenting

I don't understand this point: Block comments can start with /*-, which is recognized by indent(1) as the beginning of a bl ... . How should a comment be formed correctly, which then will not be changed automatically if it is not according to the rules?

Javadoc for Java 8 does not work

There is a project with Java 8 features, compiled, executed as it should. I work in Eclipse, Mac OS. But when generating Java ... s obtained from the official site? Or this program separately, since it is very inconvenient to load 230 MB in my conditions.

Using TODO

We decided to try using // TODO for small edits in the project, but found that there are so many TODO code, it turned out tha ... // FIXME, tell me, maybe there is some way to indicate who exactly this is intended for, for example // FIXME @programmerName

Difference between @ Deprecated and @deprecated

What is the difference between @Deprecated as an annotation in the class and @deprecated in its documentation? When to use on ... @deprecated Use CustomComboBox from Custom-UI. */ @Deprecated public class CustomComboBox extends JComboBox {} Thank you.