java: javadoc: Consider clarifying “containing only the aligned leading asterisk” about styleguide HOT 2 OPEN

the intent is to not have trailing whitespace. many editors & formatters will flag & delete it automatically.

from styleguide.

In Google's internal version of this style guide, there is a section on issues that do not deserve to be commented on in code reviews. Trailing whitespace is the very first one. So I think we could consider that the intent is that there really is just an asterisk with no following space, but if there is following space then that is not worth commenting about. The internal guide does also say "It is reasonable to ask the reviewee to check their editor configuration, but don't point out specific violations." (Referring to this and also things like whether there is a newline at the end of the last line.)

I have to say that I'm not really convinced by the argument that a space after the asterisk is useful because you might conceivably be adding new comment text there. It isn't hard to type a space when you need one.

from styleguide.