Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add @param tag to a Markdown javadoc adds a new javadoc #7827

Open
lahodaj opened this issue Oct 3, 2024 · 0 comments
Open

Add @param tag to a Markdown javadoc adds a new javadoc #7827

lahodaj opened this issue Oct 3, 2024 · 0 comments
Assignees
Labels
Java [ci] enable extra Java tests (java.completion, java.source.base, java.hints, refactoring.java, form) JavaDoc [ci] enable java/javadoc tests and build-javadoc target kind:bug Bug report or fix

Comments

@lahodaj
Copy link
Contributor

lahodaj commented Oct 3, 2024

Apache NetBeans version

Apache NetBeans latest daily build

What happened

As noted in:
#7491 (comment)

    ///
    /// @param str
    ///
    public static void foo(String str, int i) {}

the hint will suggest to insert the doc for i in the old format, ignoring that the method has already a block in the new format.

result:

    ///
    /// @param str
    ///

    /**
     *
     * @param str
     * @param i
     */
    public static void foo(String str, int i) {}

Language / Project Type / NetBeans Component

Java

How to reproduce

    ///
    /// @param str
    ///
    public static void foo(String str, int i) {}

the hint will suggest to insert the doc for i in the old format, ignoring that the method has already a block in the new format.

result:

    ///
    /// @param str
    ///

    /**
     *
     * @param str
     * @param i
     */
    public static void foo(String str, int i) {}

Did this work correctly in an earlier version?

No / Don't know

Operating System

(Presumably) any

JDK

JDK 23

Apache NetBeans packaging

Own source build

Anything else

No response

Are you willing to submit a pull request?

Yes

@lahodaj lahodaj added kind:bug Bug report or fix Java [ci] enable extra Java tests (java.completion, java.source.base, java.hints, refactoring.java, form) labels Oct 3, 2024
@lahodaj lahodaj self-assigned this Oct 3, 2024
@mbien mbien added the JavaDoc [ci] enable java/javadoc tests and build-javadoc target label Oct 3, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Java [ci] enable extra Java tests (java.completion, java.source.base, java.hints, refactoring.java, form) JavaDoc [ci] enable java/javadoc tests and build-javadoc target kind:bug Bug report or fix
Projects
None yet
Development

No branches or pull requests

2 participants