This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.
[dev feb 03] I noticed that generated Javadoc comments (where NB is responsible for the formatting) do not quite follow the Java standard format. Either the JavadocTag impl should generate exactly the Java recommendations, or it should follow indentation engine settings, if the indentation engine in fact lets you configure this sort of thing. Specifically: make a new class with an uncommented constructor. Select the constructor in the Explorer. Click on the Javadoc property and open the custom editor. In the "Text" field, enter some text with a line break (or, add a tag of any sort). You will see e.g.: /** La la... * ahoj! */ public Foo() { } but expected e.g.: /** * La la... * ahoj! */ public Foo() { } Compare 2nd & 3rd notes under http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#format
I think that the correct form is /** * Something... */ public void theMethod() { ... } and not /** * Something... */ public void theMethod() { ... } (Although the later form is used in the first example in the above document, all other examples are formatted using the former one.)
Yes, you are right - indent my recommendations 1 space. (Necessary for formatting of class Javadoc to be possible anyway.)
Wow! This issue has 8 votes - I will look at it.
*** Issue 34760 has been marked as a duplicate of this issue. ***
Fixed in trunk. Checking in Element.java; /cvs/java/srcmodel/src/org/openide/src/Element.java,v <-- Element.java new revision: 1.4; previous revision: 1.3 done
Verified. Test golden files updated.
It is fixed in trunk. I'm reopening it, because it should be fixed in JAVA_MDR branch as well.
Well, reported version is still 3.5, that should not change.
Fixed in Nevada Patch 1 and in Arrow.
I am sorry but I have no idea what's the meaning of Nevada Patch 1 nor Arrow. Could you give us more information about that sun's internal names ? Thanks a lot. Vincent
Note original Version field: 3.5.
Moved to new subcomponent java/javacore.
Reported in 3.5.
Reassigning to pflaska. Pavle please check whether this is still a problem.
Fixed. Changed from /** javadoc * comment */ to /** * javadoc * comment */ /cvs/java/javacore/src/org/netbeans/modules/javacore/jmiimpl/javamodel/FeatureImpl.java,v <-- FeatureImpl.java new revision: 1.15; previous revision: 1.14 done Processing log script arguments... More commits to come... Checking in src/org/netbeans/modules/javacore/parser/JavaDocParser.java; /cvs/java/javacore/src/org/netbeans/modules/javacore/parser/JavaDocParser.java,v <-- JavaDocParser.java new revision: 1.7; previous revision: 1.6 done Processing log script arguments... More commits to come... Checking in test/unit/data/goldenfiles/org/netbeans/jmi/javamodel/codegen/FormatterTest/FormattedClass.pass; /cvs/java/javacore/test/unit/data/goldenfiles/org/netbeans/jmi/javamodel/codegen/FormatterTest/FormattedClass.pass,v <-- FormattedClass.pass new revision: 1.4; previous revision: 1.3 done Processing log script arguments... More commits to come... Checking in test/unit/data/goldenfiles/org/netbeans/jmi/javamodel/codegen/JavaDocTest/testAddJavaDocText2_JavaDocTest.pass; /cvs/java/javacore/test/unit/data/goldenfiles/org/netbeans/jmi/javamodel/codegen/JavaDocTest/testAddJavaDocText2_JavaDocTest.pass,v <-- testAddJavaDocText2_JavaDocTest.pass new revision: 1.3; previous revision: 1.2 done Checking in test/unit/data/goldenfiles/org/netbeans/jmi/javamodel/codegen/JavaDocTest/testAddJavaDocText_JavaDocTest.pass; /cvs/java/javacore/test/unit/data/goldenfiles/org/netbeans/jmi/javamodel/codegen/JavaDocTest/testAddJavaDocText_JavaDocTest.pass,v <-- testAddJavaDocText_JavaDocTest.pass new revision: 1.3; previous revision: 1.2 done Checking in test/unit/data/goldenfiles/org/netbeans/jmi/javamodel/codegen/JavaDocTest/testChangeJavaDocText_JavaDocTest.pass; /cvs/java/javacore/test/unit/data/goldenfiles/org/netbeans/jmi/javamodel/codegen/JavaDocTest/testChangeJavaDocText_JavaDocTest.pass,v <-- testChangeJavaDocText_JavaDocTest.pass new revision: 1.3; previous revision: 1.2 done Checking in test/unit/data/goldenfiles/org/netbeans/jmi/javamodel/codegen/JavaDocTest/testRemoveJavaDocText_JavaDocTest.pass; /cvs/java/javacore/test/unit/data/goldenfiles/org/netbeans/jmi/javamodel/codegen/JavaDocTest/testRemoveJavaDocText_JavaDocTest.pass,v <-- testRemoveJavaDocText_JavaDocTest.pass new revision: 1.3; previous revision: 1.2 done
Reorganization of java component