Summary: | Need a global preference to enable Javadoc support | ||
---|---|---|---|
Product: | [Eclipse Project] JDT | Reporter: | Philipe Mulet <philippe_mulet> |
Component: | Core | Assignee: | Frederic Fusier <frederic_fusier> |
Status: | VERIFIED FIXED | QA Contact: | |
Severity: | normal | ||
Priority: | P3 | CC: | dirk_baeumer, martinae |
Version: | 3.0 | ||
Target Milestone: | 3.0 M8 | ||
Hardware: | PC | ||
OS: | Windows 2000 | ||
Whiteboard: | |||
Bug Depends on: | |||
Bug Blocks: | 51529 |
Description
Philipe Mulet
2004-02-17 11:44:16 EST
Fixed. Additional JavaCore.COMPILER_DOC_COMMENT_SUPPORT option has been added: * COMPILER / Javadoc Comment Support * When this support is disabled, the compiler will ignore all javadoc problems options settings * and will not report any javadoc problem. It will also not find any reference in javadoc comment and * DOM AST Javadoc node will be only a flat text instead of having structured tag elements. * - option id: "org.eclipse.jdt.core.compiler.doc.comment.support" * - possible values: { "enabled", "disabled" } * - default: "enabled" Note that corresponding Compiler option is disabled by default and user will need to specify -warn:javadoc or -warn:allJavadoc option has before to let the batch compiler parse javadoc comments... [jdt-core-internal] Dvpt ==== Following classes have been modified to take into account this new option: 1) New option definition: Main, CompilerOptions, JavaCore, JavaProject 2) Field checkDocComment initialization: AbstractCommentParser, JavadocParser, DocCommentParser, CommentRecorderParser, MatchLocatorParser 3) Problem reporting: ProblemReporter 4) AST conversion: ASTConverter Tests ===== 1) Test cases added in jdt.core.tests.compiler.regression.JavadocTestMixed, jdt.core.tests.compiler.regression.JavadocTestOptions, jdt.core.tests.dom.ASTConverterJavadocTests and jdt.core.tests.dom.JavaSearchJavadocTests 2) All already existing Javadoc compiler tests are now run with global option disabled to verify that compiler never complains on invalid or missing tags/comments. 3) All already existing DOM/AST Javadoc convertion are now run with global option disabled to verify that Javadoc node is flat text instead having structured children tags. 4) All already existing Javadoc searches are now run with global option disabled to verify that no reference will be found in Javadoc comments. Verified in I200403250010. |