square
JavaDoc Styling is incomplete
Can you illustrate what that would change?
My best guess is that it changes the behavior from
/**
* Foo
* <p>
* Bar
*/
to
/**
* Foo
*
* <p>Bar
*/
which is not what we want.
Oracle's Javadoc guide recommends the <p> be placed on its own line. I can't find the link right now, but I have in the past when this has come up.
Here's a link: https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html#format
It's not the one I'm thinking of, but it does illustrate that <p> goes on its own line.
@JakeWharton, not quite.
When that setting is unticked you have this (empty line allowed to stay empty):
/**
* Foo
*
* Bar
*/
Once ticked, the autoformatter inserts <p> on the empty line:
/**
* Foo
* <p>
* Bar
*/
I just checked 2019.1, and it looks like it's unticked by default with the Java Code Styles there, so it must have changed at some point between that version and 2019.3.
I have a fresh 2020.2 EAP installation from today into which I installed the styles and the checkbox is ticked for me:
Ah interesting. Was this an intentional change to the Java Code Style? Or an oversight?
huh, so I see now that the settings repo isn't specific to any IJ version. And it looks like the setting we're talking about is already false (the desired behavior) in the repo:
<option name="JD_P_AT_EMPTY_LINES" value="false" />
So I'm at a loss as to why it's defaulting to true in some cases. Will try to replicate tomorrow.