Yes, frequently noticed this issue as well, although can't remember back
to know a starting version.
It doesn't seem restricted to dash-containing Javadoc, (I've definitely
encounted it in doc without). My experiences tend to have been with
multiline comments and/or methods with generics/wildcards/etc., but now
I've said that I can't reliably reproduce it by trying those out.
Another thought was to do with right margin crossing (or potential of
based on next word in comment). Typical behaviour seems to be joining
lines by eliminating a line-break, or moving it inappropriately, like NB
is failing to reformat the rest of the Javadoc correctly after inserting
a param/throws definition.
For me this has been the reason I've not reported it, as I can't find
any reliable pattern by which the issue appears, but it's definitely an
issue.
Stan
On 31/07/2023 23:55, Greenberg, Gary wrote:
Forgot to mentioned, garbling occurs always only if you have dashes
(-) in the Javadoc text.
Otherwise it works normal.
*From:* Greenberg, Gary <ggree...@visa.com.INVALID>
*Sent:* Monday, July 31, 2023 3:48 PM
*To:* users@netbeans.apache.org
*Subject:* NB18 garbles Javadoc
I had to make some changes to the code that already has extensive
Javadoc in it.
Those changes include adding parameters to several functions.
After I add these parameters, a yellow warning badge appears near the
function,
which says “Missing @param tag for …”.
If I select to add it, the tag is added, but the rest of Javadoc is
garbled.
I.e. NB merges some lines and add line brakes in some other places
where they shouldn’t be.
I have to edit it again.
Have anybody noticed such behavior? Has a bug report been filed?
Unfortunately, I can’t file report myself, as access to external
repositories forbidden by company policy.
*Gary Greenberg*
Staff Software Engineer
