### Eclipse Workspace Patch 1.0
#P org.eclipse.jdt.core.tests.compiler
Index: src/org/eclipse/jdt/core/tests/compiler/regression/BatchCompilerTest.java
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.core.tests.compiler/src/org/eclipse/jdt/core/tests/compiler/regression/BatchCompilerTest.java,v
retrieving revision 1.119
diff -u -r1.119 BatchCompilerTest.java
--- src/org/eclipse/jdt/core/tests/compiler/regression/BatchCompilerTest.java	13 Sep 2007 18:01:44 -0000	1.119
+++ src/org/eclipse/jdt/core/tests/compiler/regression/BatchCompilerTest.java	28 Sep 2007 10:12:57 -0000
@@ -1210,91 +1210,92 @@
 			"		<argument value=\"-d\"/>\n" +
 			"		<argument value=\"---OUTPUT_DIR_PLACEHOLDER---\"/>\n" +
 			"	</command_line>\n" +
-			"	<options>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.codegen.inlineJsrBytecode\" value=\"disabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.codegen.targetPlatform\" value=\"1.5\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.codegen.unusedLocal\" value=\"optimize out\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.compliance\" value=\"1.5\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.debug.lineNumber\" value=\"generate\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.debug.localVariable\" value=\"do not generate\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.debug.sourceFile\" value=\"generate\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.doc.comment.support\" value=\"disabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.generateClassFiles\" value=\"enabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.maxProblemPerUnit\" value=\"100\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.annotationSuperInterface\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.assertIdentifier\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.autoboxing\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.deprecation\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.deprecationInDeprecatedCode\" value=\"disabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.deprecationWhenOverridingDeprecatedMethod\" value=\"disabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.discouragedReference\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.emptyStatement\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.enumIdentifier\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.fallthroughCase\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.fatalOptionalError\" value=\"enabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.fieldHiding\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.finalParameterBound\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.finallyBlockNotCompletingNormally\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.forbiddenReference\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.hiddenCatchBlock\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.incompatibleNonInheritedInterfaceMethod\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.incompleteEnumSwitch\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.indirectStaticAccess\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.invalidJavadoc\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.invalidJavadocTags\" value=\"disabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsDeprecatedRef\" value=\"disabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsNotVisibleRef\" value=\"disabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsVisibility\" value=\"public\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.localVariableHiding\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.methodWithConstructorName\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingDeprecatedAnnotation\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingJavadocComments\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingJavadocCommentsOverriding\" value=\"disabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingJavadocCommentsVisibility\" value=\"public\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingJavadocTags\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingJavadocTagsOverriding\" value=\"disabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingJavadocTagsVisibility\" value=\"public\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingOverrideAnnotation\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingSerialVersion\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.noEffectAssignment\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.noImplicitStringConversion\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.nonExternalizedStringLiteral\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.nullReference\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.overridingMethodWithoutSuperInvocation\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.overridingPackageDefaultMethod\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.parameterAssignment\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.possibleAccidentalBooleanAssignment\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.potentialNullReference\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.rawTypeReference\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.redundantNullCheck\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.specialParameterHidingField\" value=\"disabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.staticAccessReceiver\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.suppressWarnings\" value=\"enabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.syntheticAccessEmulation\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.typeParameterHiding\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.uncheckedTypeOperation\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.undocumentedEmptyBlock\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unhandledWarningToken\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unnecessaryElse\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unnecessaryTypeCheck\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unqualifiedFieldAccess\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownException\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownExceptionIncludeDocCommentReference\" value=\"enabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownExceptionWhenOverriding\" value=\"disabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedImport\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedLabel\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedLocal\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedParameter\" value=\"ignore\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedParameterIncludeDocCommentReference\" value=\"enabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedParameterWhenImplementingAbstract\" value=\"disabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedParameterWhenOverridingConcrete\" value=\"disabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedPrivateMember\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.problem.varargsArgumentNeedCast\" value=\"warning\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.processAnnotations\" value=\"disabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.source\" value=\"1.5\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.taskCaseSensitive\" value=\"enabled\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.taskPriorities\" value=\"\"/>\n" +
-			"		<option key=\"org.eclipse.jdt.core.compiler.taskTags\" value=\"\"/>\n" +
+			"	<options>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.codegen.inlineJsrBytecode\" value=\"disabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.codegen.targetPlatform\" value=\"1.5\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.codegen.unusedLocal\" value=\"optimize out\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.compliance\" value=\"1.5\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.debug.lineNumber\" value=\"generate\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.debug.localVariable\" value=\"do not generate\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.debug.sourceFile\" value=\"generate\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.doc.comment.support\" value=\"disabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.generateClassFiles\" value=\"enabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.maxProblemPerUnit\" value=\"100\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.annotationSuperInterface\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.assertIdentifier\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.autoboxing\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.deprecation\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.deprecationInDeprecatedCode\" value=\"disabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.deprecationWhenOverridingDeprecatedMethod\" value=\"disabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.discouragedReference\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.emptyStatement\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.enumIdentifier\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.fallthroughCase\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.fatalOptionalError\" value=\"enabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.fieldHiding\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.finalParameterBound\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.finallyBlockNotCompletingNormally\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.forbiddenReference\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.hiddenCatchBlock\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.incompatibleNonInheritedInterfaceMethod\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.incompleteEnumSwitch\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.indirectStaticAccess\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.invalidJavadoc\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.invalidJavadocTags\" value=\"disabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsDeprecatedRef\" value=\"disabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsNotVisibleRef\" value=\"disabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsVisibility\" value=\"public\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.localVariableHiding\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.methodWithConstructorName\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingDeprecatedAnnotation\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingJavadocComments\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingJavadocCommentsOverriding\" value=\"disabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingJavadocCommentsVisibility\" value=\"public\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingJavadocTagDescription\" value=\"return_tag\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingJavadocTags\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingJavadocTagsOverriding\" value=\"disabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingJavadocTagsVisibility\" value=\"public\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingOverrideAnnotation\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.missingSerialVersion\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.noEffectAssignment\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.noImplicitStringConversion\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.nonExternalizedStringLiteral\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.nullReference\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.overridingMethodWithoutSuperInvocation\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.overridingPackageDefaultMethod\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.parameterAssignment\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.possibleAccidentalBooleanAssignment\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.potentialNullReference\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.rawTypeReference\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.redundantNullCheck\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.specialParameterHidingField\" value=\"disabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.staticAccessReceiver\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.suppressWarnings\" value=\"enabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.syntheticAccessEmulation\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.typeParameterHiding\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.uncheckedTypeOperation\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.undocumentedEmptyBlock\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unhandledWarningToken\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unnecessaryElse\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unnecessaryTypeCheck\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unqualifiedFieldAccess\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownException\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownExceptionIncludeDocCommentReference\" value=\"enabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownExceptionWhenOverriding\" value=\"disabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedImport\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedLabel\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedLocal\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedParameter\" value=\"ignore\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedParameterIncludeDocCommentReference\" value=\"enabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedParameterWhenImplementingAbstract\" value=\"disabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedParameterWhenOverridingConcrete\" value=\"disabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.unusedPrivateMember\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.problem.varargsArgumentNeedCast\" value=\"warning\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.processAnnotations\" value=\"disabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.source\" value=\"1.5\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.taskCaseSensitive\" value=\"enabled\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.taskPriorities\" value=\"\"/>\n" + 
+			"		<option key=\"org.eclipse.jdt.core.compiler.taskTags\" value=\"\"/>\n" + 
 			"	</options>\n" +
 			"	<classpaths>NORMALIZED SECTION</classpaths>\n" +
 			"	<sources>\n" +
Index: src/org/eclipse/jdt/core/tests/compiler/regression/JavadocBugsTest.java
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.core.tests.compiler/src/org/eclipse/jdt/core/tests/compiler/regression/JavadocBugsTest.java,v
retrieving revision 1.36
diff -u -r1.36 JavadocBugsTest.java
--- src/org/eclipse/jdt/core/tests/compiler/regression/JavadocBugsTest.java	16 Mar 2007 18:31:22 -0000	1.36
+++ src/org/eclipse/jdt/core/tests/compiler/regression/JavadocBugsTest.java	28 Sep 2007 10:12:59 -0000
@@ -20,6 +20,7 @@
 
 	String docCommentSupport = CompilerOptions.ENABLED;
 	String reportInvalidJavadoc = CompilerOptions.ERROR;
+	String reportMissingJavadocDescription = CompilerOptions.RETURN_TAG;
 	String reportInvalidJavadocVisibility = CompilerOptions.PRIVATE;
 	String reportMissingJavadocTags = CompilerOptions.ERROR;
 	String reportMissingJavadocComments = null;
@@ -68,6 +69,9 @@
 		} else {
 			options.put(CompilerOptions.OPTION_ReportMissingJavadocTags, reportInvalidJavadoc);
 		}
+		if (reportMissingJavadocDescription != null) {
+			options.put(CompilerOptions.OPTION_ReportMissingJavadocTagDescription, this.reportMissingJavadocDescription);
+		}
 		options.put(CompilerOptions.OPTION_ReportFieldHiding, CompilerOptions.IGNORE);
 		options.put(CompilerOptions.OPTION_ReportSyntheticAccessEmulation, CompilerOptions.IGNORE);
 		options.put(CompilerOptions.OPTION_ReportDeprecation, reportDeprecation);
@@ -2250,26 +2254,26 @@
 					"}\n",
 			},
 			"----------\n" + 
-				"1. ERROR in X.java (at line 2)\n" + 
-				"	/**@return*/\n" + 
-				"	    ^^^^^^\n" + 
-				"Javadoc: Missing return type description\n" + 
-				"----------\n" + 
-				"2. ERROR in X.java (at line 4)\n" + 
-				"	/**@return        */\n" + 
-				"	    ^^^^^^\n" + 
-				"Javadoc: Missing return type description\n" + 
-				"----------\n" + 
-				"3. ERROR in X.java (at line 6)\n" + 
-				"	/**@return****/\n" + 
-				"	    ^^^^^^\n" + 
-				"Javadoc: Missing return type description\n" + 
-				"----------\n" + 
-				"4. ERROR in X.java (at line 9)\n" + 
-				"	*	@return\n" + 
-				"	 	 ^^^^^^\n" + 
-				"Javadoc: Missing return type description\n" + 
-				"----------\n"
+			"1. ERROR in X.java (at line 2)\n" + 
+			"	/**@return*/\n" + 
+			"	    ^^^^^^\n" + 
+			"Javadoc: Description expected after @return\n" + 
+			"----------\n" + 
+			"2. ERROR in X.java (at line 4)\n" + 
+			"	/**@return        */\n" + 
+			"	    ^^^^^^\n" + 
+			"Javadoc: Description expected after @return\n" + 
+			"----------\n" + 
+			"3. ERROR in X.java (at line 6)\n" + 
+			"	/**@return****/\n" + 
+			"	    ^^^^^^\n" + 
+			"Javadoc: Description expected after @return\n" + 
+			"----------\n" + 
+			"4. ERROR in X.java (at line 9)\n" + 
+			"	*	@return\n" + 
+			"	 	 ^^^^^^\n" + 
+			"Javadoc: Description expected after @return\n" + 
+			"----------\n"
 		);
 	}
 	// Javadoc issue a warning on following tests
@@ -2289,12 +2293,12 @@
 				"1. ERROR in X.java (at line 3)\n" + 
 				"	*	@return* */\n" + 
 				"	 	 ^^^^^^\n" + 
-				"Javadoc: Missing return type description\n" + 
+				"Javadoc: Description expected after @return\n" + 
 				"----------\n" + 
 				"2. ERROR in X.java (at line 5)\n" + 
 				"	/**@return** **/\n" + 
 				"	    ^^^^^^\n" + 
-				"Javadoc: Missing return type description\n" + 
+				"Javadoc: Description expected after @return\n" + 
 				"----------\n"
 		);
 	}
@@ -3032,17 +3036,222 @@
 				"1. ERROR in X.java (at line 3)\n" + 
 				"	*	@return\n" + 
 				"	 	 ^^^^^^\n" + 
-				"Javadoc: Missing return type description\n" + 
+				"Javadoc: Description expected after @return\n" + 
 				"----------\n" + 
 				"2. ERROR in X.java (at line 8)\n" + 
 				"	*	@return      \n" + 
 				"	 	 ^^^^^^\n" + 
-				"Javadoc: Missing return type description\n" + 
+				"Javadoc: Description expected after @return\n" + 
  				"----------\n"
  		);
  	}
 
 	/**
+	 * @bug 73352: [Javadoc] Missing description should be warned for all tags
+	 * @see "https://bugs.eclipse.org/bugs/show_bug.cgi?id=73352"
+	 */
+	public void testBug73352a() {
+		String[] units = new String[] {
+			"X.java",			
+			"/**\n" +
+			"* @since\n" +
+			"* @author\n" +
+			"* @version\n" +
+			"*/\n" +
+			"public class X {\n" +
+			"	/**\n" +
+			"	 * @param  aParam\n" +
+			"	 * @return\n" +
+			"	 * @see\n" +
+			"	 * @since\n" +
+			"	 * @throws NullPointerException\n" +
+			"	 * @exception NullPointerException\n" +
+			"	 * @serial\n" +
+			"	 * @serialData\n" +
+			"	 * @serialField\n" +
+			"	 * @deprecated\n" +
+			"	 */\n" +
+			"	public String foo(String aParam) {\n" +
+			"		return new String();\n" +
+			"	}\n" +
+			"}\n"
+		};
+		reportInvalidJavadoc = CompilerOptions.WARNING;
+		reportMissingJavadocDescription = CompilerOptions.ALL_TAGS;
+		runNegativeTest(units,
+				"----------\n" + 
+				"1. WARNING in X.java (at line 2)\n" + 
+				"	* @since\n" + 
+				"	   ^^^^^\n" + 
+				"Javadoc: Description expected after @since\n" + 
+				"----------\n" + 
+				"2. WARNING in X.java (at line 3)\n" + 
+				"	* @author\n" + 
+				"	   ^^^^^^\n" + 
+				"Javadoc: Description expected after @author\n" + 
+				"----------\n" + 
+				"3. WARNING in X.java (at line 4)\n" + 
+				"	* @version\n" + 
+				"	   ^^^^^^^\n" + 
+				"Javadoc: Description expected after @version\n" + 
+				"----------\n" + 
+				"4. WARNING in X.java (at line 8)\n" + 
+				"	* @param  aParam\n" + 
+				"	          ^^^^^^\n" + 
+				"Javadoc: Description expected after this reference\n" + 
+				"----------\n" + 
+				"5. WARNING in X.java (at line 9)\n" + 
+				"	* @return\n" + 
+				"	   ^^^^^^\n" + 
+				"Javadoc: Description expected after @return\n" + 
+				"----------\n" + 
+				"6. WARNING in X.java (at line 10)\n" + 
+				"	* @see\n" + 
+				"	   ^^^\n" + 
+				"Javadoc: Missing reference\n" + 
+				"----------\n" + 
+				"7. WARNING in X.java (at line 11)\n" + 
+				"	* @since\n" + 
+				"	   ^^^^^\n" + 
+				"Javadoc: Description expected after @since\n" + 
+				"----------\n" + 
+				"8. WARNING in X.java (at line 12)\n" + 
+				"	* @throws NullPointerException\n" + 
+				"	          ^^^^^^^^^^^^^^^^^^^^\n" + 
+				"Javadoc: Description expected after this reference\n" + 
+				"----------\n" + 
+				"9. WARNING in X.java (at line 13)\n" + 
+				"	* @exception NullPointerException\n" + 
+				"	             ^^^^^^^^^^^^^^^^^^^^\n" + 
+				"Javadoc: Description expected after this reference\n" + 
+				"----------\n" + 
+				"10. WARNING in X.java (at line 14)\n" + 
+				"	* @serial\n" + 
+				"	   ^^^^^^\n" + 
+				"Javadoc: Description expected after @serial\n" + 
+				"----------\n" + 
+				"11. WARNING in X.java (at line 15)\n" + 
+				"	* @serialData\n" + 
+				"	   ^^^^^^^^^^\n" + 
+				"Javadoc: Description expected after @serialData\n" + 
+				"----------\n" + 
+				"12. WARNING in X.java (at line 16)\n" + 
+				"	* @serialField\n" + 
+				"	   ^^^^^^^^^^^\n" + 
+				"Javadoc: Description expected after @serialField\n" + 
+				"----------\n" + 
+				"13. WARNING in X.java (at line 17)\n" + 
+				"	* @deprecated\n" + 
+				"	   ^^^^^^^^^^\n" + 
+				"Javadoc: Description expected after @deprecated\n" + 
+				"----------\n"
+			);
+	}	
+	public void testBug73352b() {
+		String[] units = new String[] {
+			"X.java",			
+			"/**\n" +
+			"* @since 1.0\n" +
+			"* @author John Doe\n" +
+			"* @version 1.1\n" +
+			"*/\n" +
+			"public class X {\n" +
+			"	/**\n" +
+			"	 * @param  aParam comment\n" +
+			"	 * @return String\n" +
+			"	 * @see String\n" +
+			"	 * @since 1.1\n" +
+			"	 * @throws NullPointerException an exception\n" +
+			"	 * @exception NullPointerException an exception\n" +
+			"	 * @serial aSerial\n" +
+			"	 * @serialData aSerialData\n" +
+			"	 * @serialField aSerialField\n" +
+			"	 * @deprecated use another method\n" +
+			"	 */\n" +
+			"	public String foo(String aParam) {\n" +
+			"		return new String();\n" +
+			"	}\n" +
+			"}\n"
+		};
+		reportInvalidJavadoc = CompilerOptions.WARNING;
+		reportMissingJavadocDescription = CompilerOptions.ALL_TAGS;
+		runConformTest(units);
+	}
+	public void testBug73352c() {
+		String[] units = new String[] {
+			"X.java",			
+			"/**\n" +
+			"* @since\n" +
+			"* @author\n" +
+			"* @version\n" +
+			"*/\n" +
+			"public class X {\n" +
+			"	/**\n" +
+			"	 * @param  aParam\n" +
+			"	 * @return\n" +
+			"	 * @see\n" +
+			"	 * @since\n" +
+			"	 * @throws NullPointerException\n" +
+			"	 * @exception NullPointerException\n" +
+			"	 * @serial\n" +
+			"	 * @serialData\n" +
+			"	 * @serialField\n" +
+			"	 * @deprecated\n" +
+			"	 */\n" +
+			"	public String foo(String aParam) {\n" +
+			"		return new String();\n" +
+			"	}\n" +
+			"}\n"
+		};
+		reportInvalidJavadoc = CompilerOptions.WARNING;
+		reportMissingJavadocDescription = CompilerOptions.RETURN_TAG;
+		runNegativeTest(units,
+			"----------\n" + 
+			"1. WARNING in X.java (at line 9)\n" + 
+			"	* @return\n" + 
+			"	   ^^^^^^\n" + 
+			"Javadoc: Description expected after @return\n" + 
+			"----------\n" + 
+			"2. WARNING in X.java (at line 10)\n" + 
+			"	* @see\n" + 
+			"	   ^^^\n" + 
+			"Javadoc: Missing reference\n" + 
+			"----------\n"
+			);
+	}
+	
+	public void testBug73352d() {
+		String[] units = new String[] {
+			"X.java",			
+			"/**\n" +
+			"* @since\n" +
+			"* @author\n" +
+			"* @version\n" +
+			"*/\n" +
+			"public class X {\n" +
+			"	/**\n" +
+			"	 * @param  aParam\n" +
+			"	 * @return\n" +
+			"	 * @see\n" +
+			"	 * @since\n" +
+			"	 * @throws NullPointerException\n" +
+			"	 * @exception NullPointerException\n" +
+			"	 * @serial\n" +
+			"	 * @serialData\n" +
+			"	 * @serialField\n" +
+			"	 * @deprecated\n" +
+			"	 */\n" +
+			"	public String foo(String aParam) {\n" +
+			"		return new String();\n" +
+			"	}\n" +
+			"}\n"
+		};
+		reportInvalidJavadoc = CompilerOptions.WARNING;
+		reportMissingJavadocDescription = CompilerOptions.NO_TAG;
+		runConformTest(units);
+	}	
+
+	/**
 	 * Bug 73479: [Javadoc] Improve error message for invalid link in @see tags
 	 * @see <a href="http://bugs.eclipse.org/bugs/show_bug.cgi?id=73479">73479</a>
 	 */
@@ -5211,7 +5420,7 @@
 			"1. ERROR in X.java (at line 21)\n" + 
 			"	* @return\n" + 
 			"	   ^^^^^^\n" + 
-			"Javadoc: Missing return type description\n" + 
+			"Javadoc: Description expected after @return\n" + 
 			"----------\n"
 		);
 	}
Index: src/org/eclipse/jdt/core/tests/compiler/regression/EnumTest.java
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.core.tests.compiler/src/org/eclipse/jdt/core/tests/compiler/regression/EnumTest.java,v
retrieving revision 1.117
diff -u -r1.117 EnumTest.java
--- src/org/eclipse/jdt/core/tests/compiler/regression/EnumTest.java	15 Jul 2007 00:17:48 -0000	1.117
+++ src/org/eclipse/jdt/core/tests/compiler/regression/EnumTest.java	28 Sep 2007 10:12:58 -0000
@@ -1240,47 +1240,47 @@
 				"	public String val(Object x) { return x.toString(); }\n" +
 				"}\n"
 		},
-		"----------\n" +
-			"1. ERROR in E.java (at line 3)\n" + 
-			"	* @see e\n" + 
-			"	       ^\n" + 
-			"Javadoc: e cannot be resolved to a type\n" + 
-			"----------\n" + 
-			"2. ERROR in E.java (at line 4)\n" + 
-			"	* @see #VALIDE\n" + 
-			"	        ^^^^^^\n" + 
-			"Javadoc: VALIDE cannot be resolved or is not a field\n" + 
-			"----------\n" + 
-			"3. ERROR in E.java (at line 8)\n" + 
-			"	* @see E#test\n" + 
-			"	         ^^^^\n" + 
-			"Javadoc: test cannot be resolved or is not a field\n" + 
-			"----------\n" + 
-			"4. ERROR in E.java (at line 9)\n" + 
-			"	* @see EUX\n" + 
-			"	       ^^^\n" + 
-			"Javadoc: EUX cannot be resolved to a type\n" + 
-			"----------\n" + 
-			"5. ERROR in E.java (at line 13)\n" + 
-			"	* @param obj the object\n" + 
-			"	         ^^^\n" + 
-			"Javadoc: Parameter obj is not declared\n" + 
-			"----------\n" + 
-			"6. ERROR in E.java (at line 14)\n" + 
-			"	* @return\n" + 
-			"	   ^^^^^^\n" + 
-			"Javadoc: Missing return type description\n" + 
-			"----------\n" + 
-			"7. ERROR in E.java (at line 15)\n" + 
-			"	* @see Objet\n" + 
-			"	       ^^^^^\n" + 
-			"Javadoc: Objet cannot be resolved to a type\n" + 
-			"----------\n" + 
-			"8. ERROR in E.java (at line 17)\n" + 
-			"	public String val(Object x) { return x.toString(); }\n" + 
-			"	                         ^\n" + 
-			"Javadoc: Missing tag for parameter x\n" + 
-			"----------\n"
+		"----------\n" + 
+		"1. ERROR in E.java (at line 3)\n" + 
+		"	* @see e\n" + 
+		"	       ^\n" + 
+		"Javadoc: e cannot be resolved to a type\n" + 
+		"----------\n" + 
+		"2. ERROR in E.java (at line 4)\n" + 
+		"	* @see #VALIDE\n" + 
+		"	        ^^^^^^\n" + 
+		"Javadoc: VALIDE cannot be resolved or is not a field\n" + 
+		"----------\n" + 
+		"3. ERROR in E.java (at line 8)\n" + 
+		"	* @see E#test\n" + 
+		"	         ^^^^\n" + 
+		"Javadoc: test cannot be resolved or is not a field\n" + 
+		"----------\n" + 
+		"4. ERROR in E.java (at line 9)\n" + 
+		"	* @see EUX\n" + 
+		"	       ^^^\n" + 
+		"Javadoc: EUX cannot be resolved to a type\n" + 
+		"----------\n" + 
+		"5. ERROR in E.java (at line 13)\n" + 
+		"	* @param obj the object\n" + 
+		"	         ^^^\n" + 
+		"Javadoc: Parameter obj is not declared\n" + 
+		"----------\n" + 
+		"6. ERROR in E.java (at line 14)\n" + 
+		"	* @return\n" + 
+		"	   ^^^^^^\n" + 
+		"Javadoc: Description expected after @return\n" + 
+		"----------\n" + 
+		"7. ERROR in E.java (at line 15)\n" + 
+		"	* @see Objet\n" + 
+		"	       ^^^^^\n" + 
+		"Javadoc: Objet cannot be resolved to a type\n" + 
+		"----------\n" + 
+		"8. ERROR in E.java (at line 17)\n" + 
+		"	public String val(Object x) { return x.toString(); }\n" + 
+		"	                         ^\n" + 
+		"Javadoc: Missing tag for parameter x\n" + 
+		"----------\n"
 	);
 }
 public void test042() {
#P org.eclipse.jdt.core
Index: compiler/org/eclipse/jdt/core/compiler/IProblem.java
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/compiler/org/eclipse/jdt/core/compiler/IProblem.java,v
retrieving revision 1.190
diff -u -r1.190 IProblem.java
--- compiler/org/eclipse/jdt/core/compiler/IProblem.java	11 Jul 2007 13:47:21 -0000	1.190
+++ compiler/org/eclipse/jdt/core/compiler/IProblem.java	28 Sep 2007 10:13:01 -0000
@@ -815,6 +815,11 @@
 	 * Javadoc comments
 	 */
 	/** 
+	 * Problem warned on missing tag description.
+	 * @since 3.4
+	 */
+	int JavadocMissingTagDescription = Javadoc + Internal + 463;
+	/** 
 	 * Problem warned on duplicated tag.
 	 * @since 3.3
 	 */
Index: compiler/org/eclipse/jdt/internal/compiler/impl/CompilerOptions.java
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/compiler/org/eclipse/jdt/internal/compiler/impl/CompilerOptions.java,v
retrieving revision 1.186
diff -u -r1.186 CompilerOptions.java
--- compiler/org/eclipse/jdt/internal/compiler/impl/CompilerOptions.java	13 Sep 2007 18:00:47 -0000	1.186
+++ compiler/org/eclipse/jdt/internal/compiler/impl/CompilerOptions.java	28 Sep 2007 10:13:01 -0000
@@ -74,6 +74,7 @@
 	public static final String OPTION_ReportMissingJavadocTagsVisibility = "org.eclipse.jdt.core.compiler.problem.missingJavadocTagsVisibility"; //$NON-NLS-1$
 	public static final String OPTION_ReportMissingJavadocTagsOverriding = "org.eclipse.jdt.core.compiler.problem.missingJavadocTagsOverriding"; //$NON-NLS-1$
 	public static final String OPTION_ReportMissingJavadocComments = "org.eclipse.jdt.core.compiler.problem.missingJavadocComments"; //$NON-NLS-1$
+	public static final String OPTION_ReportMissingJavadocTagDescription = "org.eclipse.jdt.core.compiler.problem.missingJavadocTagDescription"; //$NON-NLS-1$
 	public static final String OPTION_ReportMissingJavadocCommentsVisibility = "org.eclipse.jdt.core.compiler.problem.missingJavadocCommentsVisibility"; //$NON-NLS-1$
 	public static final String OPTION_ReportMissingJavadocCommentsOverriding = "org.eclipse.jdt.core.compiler.problem.missingJavadocCommentsOverriding"; //$NON-NLS-1$
 	public static final String OPTION_ReportFinallyBlockNotCompletingNormally = "org.eclipse.jdt.core.compiler.problem.finallyBlockNotCompletingNormally"; //$NON-NLS-1$
@@ -145,6 +146,9 @@
 	public static final String PROTECTED = "protected";	//$NON-NLS-1$
 	public static final String DEFAULT = "default";	//$NON-NLS-1$
 	public static final String PRIVATE = "private";	//$NON-NLS-1$
+	public static final String RETURN_TAG = "return_tag";	//$NON-NLS-1$
+	public static final String NO_TAG = "no_tag";	//$NON-NLS-1$
+	public static final String ALL_TAGS = "all_tags";	//$NON-NLS-1$
 
 	/**
 	 * Bit mask for configurable problems (error/warning threshold)
@@ -201,6 +205,7 @@
 	public static final long OverridingMethodWithoutSuperInvocation = ASTNode.Bit50L;
 	public static final long PotentialNullReference = ASTNode.Bit51L;
 	public static final long RedundantNullCheck = ASTNode.Bit52L;
+	public static final long MissingJavadocTagDescription = ASTNode.Bit53L;
 
 	// Map: String optionKey --> Long irritant>
 	private static Map OptionToIrritants;
@@ -287,6 +292,7 @@
 	public boolean reportInvalidJavadocTags = false;
 	public boolean reportInvalidJavadocTagsDeprecatedRef = false;
 	public boolean reportInvalidJavadocTagsNotVisibleRef = false;
+	public String reportMissingJavadocTagDescription = RETURN_TAG;
 
 	// check missing javadoc tags
 	public int reportMissingJavadocTagsVisibility = ClassFileConstants.AccPublic;
@@ -394,6 +400,7 @@
 		optionsMap.put(OPTION_ReportMissingJavadocTagsVisibility, getVisibilityString(this.reportMissingJavadocTagsVisibility));
 		optionsMap.put(OPTION_ReportMissingJavadocTagsOverriding, this.reportMissingJavadocTagsOverriding ? ENABLED : DISABLED);
 		optionsMap.put(OPTION_ReportMissingJavadocComments, getSeverityString(MissingJavadocComments));
+		optionsMap.put(OPTION_ReportMissingJavadocTagDescription, this.reportMissingJavadocTagDescription);
 		optionsMap.put(OPTION_ReportMissingJavadocCommentsVisibility, getVisibilityString(this.reportMissingJavadocCommentsVisibility));
 		optionsMap.put(OPTION_ReportMissingJavadocCommentsOverriding, this.reportMissingJavadocCommentsOverriding ? ENABLED : DISABLED);
 		optionsMap.put(OPTION_ReportFinallyBlockNotCompletingNormally, getSeverityString(FinallyBlockNotCompleting));
@@ -560,6 +567,8 @@
 					return OPTION_ReportFallthroughCase;
 				case (int)(OverridingMethodWithoutSuperInvocation >>> 32) :
 					return OPTION_ReportOverridingMethodWithoutSuperInvocation;
+				case (int) MissingJavadocTagDescription :
+					return OPTION_ReportMissingJavadocTagDescription;
 			}
 		}
 		return null;
@@ -901,7 +910,10 @@
 		}
 		if ((optionValue = optionsMap.get(OPTION_ReportMissingJavadocComments)) != null) {
 			updateSeverity(MissingJavadocComments, optionValue);
-		}
+		}		
+		if ((optionValue = optionsMap.get(OPTION_ReportMissingJavadocTagDescription)) != null) {
+			this.reportMissingJavadocTagDescription = (String) optionValue;
+		}		
 		if ((optionValue = optionsMap.get(OPTION_ReportMissingJavadocCommentsVisibility)) != null) {
 			if (PUBLIC.equals(optionValue)) {
 				this.reportMissingJavadocCommentsVisibility = ClassFileConstants.AccPublic;
@@ -977,6 +989,7 @@
 		buf.append("\n\t\t+ visibility level to report missing javadoc tags: ").append(getVisibilityString(this.reportMissingJavadocTagsVisibility)); //$NON-NLS-1$
 		buf.append("\n\t\t+ report missing javadoc tags in overriding methods: ").append(this.reportMissingJavadocTagsOverriding ? ENABLED : DISABLED); //$NON-NLS-1$
 		buf.append("\n\t\t+ missing javadoc comments: ").append(getSeverityString(MissingJavadocComments)); //$NON-NLS-1$
+		buf.append("\n\t\t+ report missing tag description option: ").append(this.reportMissingJavadocTagDescription); //$NON-NLS-1$
 		buf.append("\n\t\t+ visibility level to report missing javadoc comments: ").append(getVisibilityString(this.reportMissingJavadocCommentsVisibility)); //$NON-NLS-1$
 		buf.append("\n\t\t+ report missing javadoc comments in overriding methods: ").append(this.reportMissingJavadocCommentsOverriding ? ENABLED : DISABLED); //$NON-NLS-1$
 		buf.append("\n\t- finally block not completing normally: ").append(getSeverityString(FinallyBlockNotCompleting)); //$NON-NLS-1$
@@ -1133,6 +1146,7 @@
 			OPTION_ReportMethodWithConstructorName,
 			OPTION_ReportMissingDeprecatedAnnotation,
 			OPTION_ReportMissingJavadocComments,
+			OPTION_ReportMissingJavadocTagDescription,
 			OPTION_ReportMissingJavadocTags,
 			OPTION_ReportMissingOverrideAnnotation,
 			OPTION_ReportMissingSerialVersion,
Index: model/org/eclipse/jdt/core/JavaCore.java
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/model/org/eclipse/jdt/core/JavaCore.java,v
retrieving revision 1.584
diff -u -r1.584 JavaCore.java
--- model/org/eclipse/jdt/core/JavaCore.java	27 Sep 2007 15:07:26 -0000	1.584
+++ model/org/eclipse/jdt/core/JavaCore.java	28 Sep 2007 10:13:04 -0000
@@ -70,6 +70,11 @@
  *                                 COMPILER_PB_UNUSED_PARAMETER_INCLUDE_DOC_COMMENT_REFERENCE
  *     IBM Corporation - added the following constants:
  *                                 COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION_INCLUDE_DOC_COMMENT_REFERENCE
+ *     IBM Corporation - added the following constants:
+ *                                 COMPILER_PB_MISSING_JAVADOC_TAG_DESCRIPTION
+ *								    COMPILER_PB_MISSING_JAVADOC_TAG_DESCRIPTION_NO_TAG
+ *								    COMPILER_PB_MISSING_JAVADOC_TAG_DESCRIPTION_RETURN_TAG
+ *								    COMPILER_PB_MISSING_JAVADOC_TAG_DESCRIPTION_ALL_TAGS
  *******************************************************************************/
 package org.eclipse.jdt.core;
 
@@ -559,6 +564,30 @@
 	 */
 	public static final String COMPILER_PB_INVALID_JAVADOC_TAGS_VISIBILITY = PLUGIN_ID + ".compiler.problem.invalidJavadocTagsVisibility"; //$NON-NLS-1$
 	/**
+	 * Possible configurable option ID.
+	 * @see #getDefaultOptions()
+	 * @since 3.4
+	 */
+	public static final String COMPILER_PB_MISSING_JAVADOC_TAG_DESCRIPTION = PLUGIN_ID + ".compiler.problem.missingJavadocTagDescription"; //$NON-NLS-1$
+	/**
+	 * Possible configurable option value.
+	 * @see #getDefaultOptions()
+	 * @since 3.4
+	 */
+	public static final String COMPILER_PB_MISSING_JAVADOC_TAG_DESCRIPTION_NO_TAG = CompilerOptions.NO_TAG;
+	/**
+	 * Possible configurable option value.
+	 * @see #getDefaultOptions()
+	 * @since 3.4
+	 */
+	public static final String COMPILER_PB_MISSING_JAVADOC_TAG_DESCRIPTION_RETURN_TAG = CompilerOptions.RETURN_TAG;
+	/**
+	 * Possible configurable option value.
+	 * @see #getDefaultOptions()
+	 * @since 3.4
+	 */
+	public static final String COMPILER_PB_MISSING_JAVADOC_TAG_DESCRIPTION_ALL_TAGS = CompilerOptions.ALL_TAGS;
+	/**
 	 * Possible  configurable option ID.
 	 * @see #getDefaultOptions()
 	 * @since 3.0
Index: compiler/org/eclipse/jdt/internal/compiler/problem/ProblemReporter.java
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/compiler/org/eclipse/jdt/internal/compiler/problem/ProblemReporter.java,v
retrieving revision 1.351
diff -u -r1.351 ProblemReporter.java
--- compiler/org/eclipse/jdt/internal/compiler/problem/ProblemReporter.java	19 Jul 2007 14:07:25 -0000	1.351
+++ compiler/org/eclipse/jdt/internal/compiler/problem/ProblemReporter.java	28 Sep 2007 10:13:03 -0000
@@ -275,6 +275,7 @@
 		case IProblem.JavadocUsingDeprecatedMethod:
 		case IProblem.JavadocUsingDeprecatedType:
 		case IProblem.JavadocHiddenReference:
+		case IProblem.JavadocMissingTagDescription:
 			return CompilerOptions.InvalidJavadoc;
 
 		case IProblem.JavadocMissingParamTag:
@@ -1021,7 +1022,6 @@
 		case IProblem.JavadocInvalidParamName:
 		case IProblem.JavadocDuplicateParamName:
 		case IProblem.JavadocMissingParamName:
-		case IProblem.JavadocMissingIdentifier:
 		case IProblem.JavadocInvalidMemberTypeQualification:
 		case IProblem.JavadocInvalidThrowsClassName:
 		case IProblem.JavadocDuplicateThrowsClassName:
@@ -1055,7 +1055,6 @@
 		case IProblem.JavadocIncorrectArityForParameterizedConstructor:
 		case IProblem.JavadocParameterizedConstructorArgumentTypeMismatch:
 		case IProblem.JavadocTypeArgumentsForRawGenericConstructor:
-		case IProblem.JavadocEmptyReturnTag:
 			if (!this.options.reportInvalidJavadocTags) {
 				return ProblemSeverities.Ignore;		
 			}
@@ -1083,6 +1082,19 @@
 				return ProblemSeverities.Ignore;			
 			}
 			break;
+		/*
+		 * Javadoc missing tag descriptions
+		 */
+		case IProblem.JavadocEmptyReturnTag:
+			if (CompilerOptions.NO_TAG.equals(this.options.reportMissingJavadocTagDescription)) {
+				return ProblemSeverities.Ignore;
+			}
+			break;
+		case IProblem.JavadocMissingTagDescription:
+			if (! CompilerOptions.ALL_TAGS.equals(this.options.reportMissingJavadocTagDescription)) {
+				return ProblemSeverities.Ignore;
+			}
+			break;
 	}
 	long irritant = getIrritant(problemID);
 	if (irritant != 0) {
@@ -3747,7 +3759,8 @@
 	int severity = computeSeverity(IProblem.JavadocEmptyReturnTag);
 	if (severity == ProblemSeverities.Ignore) return;
 	if (javadocVisibility(this.options.reportInvalidJavadocTagsVisibility, modifiers)) {
-		this.handle(IProblem.JavadocEmptyReturnTag, NoArgument, NoArgument, sourceStart, sourceEnd);
+		String[] arguments = new String[] { new String(JavadocTagConstants.TAG_RETURN) };
+		this.handle(IProblem.JavadocEmptyReturnTag, arguments, arguments, sourceStart, sourceEnd);
 	}
 }
 public void javadocErrorNoMethodFor(MessageSend messageSend, TypeBinding recType, TypeBinding[] params, int modifiers) {
@@ -4332,9 +4345,26 @@
 		this.handle(IProblem.JavadocMissingReturnTag, NoArgument, NoArgument, sourceStart, sourceEnd);
 	}
 }
+public void javadocMissingTagDescription(char[] tokenName, int sourceStart, int sourceEnd, int modifiers) {
+	int severity = computeSeverity(IProblem.JavadocMissingTagDescription);
+	if (severity == ProblemSeverities.Ignore) return;
+	if (javadocVisibility(this.options.reportInvalidJavadocTagsVisibility, modifiers)) {
+		String[] arguments = new String[] { new String(tokenName) };
+		// use IProblem.JavadocEmptyReturnTag for all identified tags
+		this.handle(IProblem.JavadocEmptyReturnTag, arguments, arguments, sourceStart, sourceEnd);
+	}
+}
+public void javadocMissingTagDescriptionAfterReference(int sourceStart, int sourceEnd, int modifiers){
+	int severity = computeSeverity(IProblem.JavadocMissingTagDescription);
+	if (severity == ProblemSeverities.Ignore) return;
+	if (javadocVisibility(this.options.reportInvalidJavadocTagsVisibility, modifiers)) {
+		this.handle(IProblem.JavadocMissingTagDescription, NoArgument, NoArgument, severity, sourceStart, sourceEnd);
+	}
+}
 public void javadocMissingThrowsClassName(int sourceStart, int sourceEnd, int modifiers){
-	if (javadocVisibility(this.options.reportInvalidJavadocTagsVisibility, modifiers))
+	if (javadocVisibility(this.options.reportInvalidJavadocTagsVisibility, modifiers)) {
 		this.handle(IProblem.JavadocMissingThrowsClassName, NoArgument, NoArgument, sourceStart, sourceEnd);
+	}
 }
 public void javadocMissingThrowsTag(TypeReference typeRef, int modifiers){
 	int severity = computeSeverity(IProblem.JavadocMissingThrowsTag);
Index: compiler/org/eclipse/jdt/internal/compiler/problem/messages.properties
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/compiler/org/eclipse/jdt/internal/compiler/problem/messages.properties,v
retrieving revision 1.222
diff -u -r1.222 messages.properties
--- compiler/org/eclipse/jdt/internal/compiler/problem/messages.properties	13 Sep 2007 16:55:30 -0000	1.222
+++ compiler/org/eclipse/jdt/internal/compiler/problem/messages.properties	28 Sep 2007 10:13:03 -0000
@@ -373,6 +373,7 @@
 460 = Empty block should be documented
 
 ### DOC 
+463 = Description expected after this reference
 464 = Unexpected duplicated tag @{0}
 465 = ''{0}'' visibility for malformed doc comments hides this ''{1}'' reference
 466 = Invalid member type qualification
@@ -425,7 +426,7 @@
 513 = Malformed reference (missing end space separator)
 514 = Javadoc: 
 515 = Missing #: "{0}"
-516 = Missing return type description
+516 = Description expected after @{0}
 517 = Only static field reference is allowed for @value tag
 518 = Unexpected text
 519 = Invalid param tag name
Index: formatter/org/eclipse/jdt/internal/formatter/DefaultCodeFormatter.java
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/formatter/org/eclipse/jdt/internal/formatter/DefaultCodeFormatter.java,v
retrieving revision 1.62
diff -u -r1.62 DefaultCodeFormatter.java
--- formatter/org/eclipse/jdt/internal/formatter/DefaultCodeFormatter.java	6 Mar 2007 02:38:50 -0000	1.62
+++ formatter/org/eclipse/jdt/internal/formatter/DefaultCodeFormatter.java	28 Sep 2007 10:13:03 -0000
@@ -298,6 +298,7 @@
 			optionsMap.put(CompilerOptions.OPTION_ReportInvalidJavadoc, CompilerOptions.IGNORE);
 			optionsMap.put(CompilerOptions.OPTION_ReportInvalidJavadocTagsVisibility, CompilerOptions.PUBLIC);
 			optionsMap.put(CompilerOptions.OPTION_ReportInvalidJavadocTags, CompilerOptions.DISABLED);
+			optionsMap.put(CompilerOptions.OPTION_ReportMissingJavadocTagDescription, CompilerOptions.RETURN_TAG);
 			optionsMap.put(CompilerOptions.OPTION_ReportInvalidJavadocTagsDeprecatedRef, CompilerOptions.DISABLED);
 			optionsMap.put(CompilerOptions.OPTION_ReportInvalidJavadocTagsNotVisibleRef, CompilerOptions.DISABLED);
 			optionsMap.put(CompilerOptions.OPTION_ReportMissingJavadocTags, CompilerOptions.IGNORE);
Index: compiler/org/eclipse/jdt/internal/compiler/parser/JavadocParser.java
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/compiler/org/eclipse/jdt/internal/compiler/parser/JavadocParser.java,v
retrieving revision 1.63
diff -u -r1.63 JavadocParser.java
--- compiler/org/eclipse/jdt/internal/compiler/parser/JavadocParser.java	27 Apr 2007 15:51:39 -0000	1.63
+++ compiler/org/eclipse/jdt/internal/compiler/parser/JavadocParser.java	28 Sep 2007 10:13:02 -0000
@@ -331,6 +331,21 @@
 	}
 
 	/*
+	 * Parse @throws tag declaration and flag missing description if corresponding option is enabled
+	 */
+	protected boolean parseThrows() {
+		boolean valid = super.parseThrows();
+		if (valid && this.reportProblems && verifyEndLine(this.scanner.currentPosition)) {
+			// retrieve last identifier position (valid as, in the super method, we already parsed an identifier)			
+			int start = (int) (this.identifierPositionStack[0] >>> 32);
+			int end = (int) this.identifierPositionStack[this.identifierPtr];
+			this.sourceParser.problemReporter().javadocMissingTagDescriptionAfterReference(start, end, this.sourceParser.modifiers);
+			return false;
+		}
+		return valid;
+	}
+
+	/*
 	 * Parse @return tag declaration
 	 */
 	protected boolean parseReturn() {
@@ -465,6 +480,7 @@
 	
 		// Decide which parse to perform depending on tag name
 		this.tagValue = NO_TAG_VALUE;
+		boolean alreadyParsedTag = false;
 		switch (token) {
 			case TerminalTokens.TokenNameIdentifier :
 				switch (tagName[0]) {
@@ -485,6 +501,7 @@
 						if (length == TAG_EXCEPTION_LENGTH && CharOperation.equals(TAG_EXCEPTION, tagName)) {
 							this.tagValue = TAG_EXCEPTION_VALUE;
 							valid = parseThrows();
+							alreadyParsedTag = true;
 						}
 						break;
 					case 'i':
@@ -514,6 +531,7 @@
 									this.sourceParser.problemReporter().javadocUnexpectedTag(this.tagSourceStart, this.tagSourceEnd);
 								}
 							}
+							alreadyParsedTag = true;
 						} else if (length == TAG_LINKPLAIN_LENGTH && CharOperation.equals(TAG_LINKPLAIN, tagName)) {
 							this.tagValue = TAG_LINKPLAIN_VALUE;
 							if (this.inlineTagStarted) {
@@ -524,12 +542,14 @@
 									this.sourceParser.problemReporter().javadocUnexpectedTag(this.tagSourceStart, this.tagSourceEnd);
 								}
 							}
+							alreadyParsedTag = true;
 						}
 						break;
 					case 'p':
 						if (length == TAG_PARAM_LENGTH && CharOperation.equals(TAG_PARAM, tagName)) {
 							this.tagValue = TAG_PARAM_VALUE;
 							valid = parseParam();
+							alreadyParsedTag = true;
 						}
 						break;
 					case 's':
@@ -545,6 +565,7 @@
 								this.tagValue = TAG_SEE_VALUE;
 								valid = parseReference();
 							}
+							alreadyParsedTag = true;
 						}
 						break;
 					case 'v':
@@ -572,6 +593,7 @@
 									if (this.reportProblems) this.sourceParser.problemReporter().javadocUnexpectedTag(this.tagSourceStart, this.tagSourceEnd);
 								}
 							}
+							alreadyParsedTag = true;
 						} else {
 							createTag();
 						}
@@ -584,6 +606,7 @@
 			case TerminalTokens.TokenNamereturn :
 				this.tagValue = TAG_RETURN_VALUE;
 				valid = parseReturn();
+				alreadyParsedTag = true;
 				/* verify characters after return tag (we're expecting text description)
 				if(!verifyCharsAfterReturnTag(this.index)) {
 					if (this.sourceParser != null) {
@@ -596,9 +619,29 @@
 			case TerminalTokens.TokenNamethrows :
 				this.tagValue = TAG_THROWS_VALUE;
 				valid = parseThrows();
+				alreadyParsedTag = true;
 				break;
 		}
 		this.textStart = this.index;
+		if (! alreadyParsedTag && this.reportProblems && verifyEndLine(this.scanner.currentPosition)) {
+			this.sourceParser.problemReporter().javadocMissingTagDescription(tagName, this.tagSourceStart, this.tagSourceEnd, this.sourceParser.modifiers);
+			return false;
+		}
+		return valid;
+	}
+	
+	/*
+	 * Parse @param tag declaration and flag missing description if corresponding option is enabled
+	 */
+	protected boolean parseParam() throws InvalidInputException {
+		boolean valid = super.parseParam();
+		if (valid && this.reportProblems && verifyEndLine(this.scanner.currentPosition)) {
+			// retrieve last identifier position (valid as, in the super method, we already parsed an identifier)
+			int start = (int) (this.identifierPositionStack[0] >>> 32);
+			int end = (int) this.identifierPositionStack[this.identifierPtr];
+			this.sourceParser.problemReporter().javadocMissingTagDescriptionAfterReference(start, end, this.sourceParser.modifiers);
+			return false;
+		}	
 		return valid;
 	}
 
#P org.eclipse.jdt.ui
Index: ui/org/eclipse/jdt/internal/ui/preferences/JavadocProblemsConfigurationBlock.java
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.ui/ui/org/eclipse/jdt/internal/ui/preferences/JavadocProblemsConfigurationBlock.java,v
retrieving revision 1.9
diff -u -r1.9 JavadocProblemsConfigurationBlock.java
--- ui/org/eclipse/jdt/internal/ui/preferences/JavadocProblemsConfigurationBlock.java	27 Sep 2005 16:41:04 -0000	1.9
+++ ui/org/eclipse/jdt/internal/ui/preferences/JavadocProblemsConfigurationBlock.java	28 Sep 2007 10:13:05 -0000
@@ -46,6 +46,7 @@
 	private static final Key PREF_PB_MISSING_JAVADOC_TAGS_OVERRIDING= getJDTCoreKey(JavaCore.COMPILER_PB_MISSING_JAVADOC_TAGS_OVERRIDING);
 
 	private static final Key PREF_PB_MISSING_JAVADOC_COMMENTS= getJDTCoreKey(JavaCore.COMPILER_PB_MISSING_JAVADOC_COMMENTS);
+	private static final Key PREF_PB_MISSING_JAVADOC_TAG_DESCRIPTION= getJDTCoreKey(JavaCore.COMPILER_PB_MISSING_JAVADOC_TAG_DESCRIPTION);
 	private static final Key PREF_PB_MISSING_JAVADOC_COMMENTS_VISIBILITY= getJDTCoreKey(JavaCore.COMPILER_PB_MISSING_JAVADOC_COMMENTS_VISIBILITY);
 	private static final Key PREF_PB_MISSING_JAVADOC_COMMENTS_OVERRIDING= getJDTCoreKey(JavaCore.COMPILER_PB_MISSING_JAVADOC_COMMENTS_OVERRIDING);
 	
@@ -63,6 +64,10 @@
 	private static final String DEFAULT= JavaCore.DEFAULT;
 	private static final String PRIVATE= JavaCore.PRIVATE;
 	
+	private static final String NO_TAG= JavaCore.COMPILER_PB_MISSING_JAVADOC_TAG_DESCRIPTION_NO_TAG;
+	private static final String RETURN_TAG= JavaCore.COMPILER_PB_MISSING_JAVADOC_TAG_DESCRIPTION_RETURN_TAG;
+	private static final String ALL_TAGS= JavaCore.COMPILER_PB_MISSING_JAVADOC_TAG_DESCRIPTION_ALL_TAGS;
+	
 	private PixelConverter fPixelConverter;
 	private Composite fJavadocComposite;
 
@@ -81,7 +86,7 @@
 				PREF_PB_INVALID_JAVADOC_TAGS_VISIBILITY,
 				PREF_PB_INVALID_JAVADOC_TAGS_NOT_VISIBLE_REF, PREF_PB_INVALID_JAVADOC_TAGS_DEPRECATED_REF,
 				PREF_PB_MISSING_JAVADOC_TAGS, PREF_PB_MISSING_JAVADOC_TAGS_VISIBILITY, PREF_PB_MISSING_JAVADOC_TAGS_OVERRIDING,
-				PREF_PB_MISSING_JAVADOC_COMMENTS, PREF_PB_MISSING_JAVADOC_COMMENTS_VISIBILITY, PREF_PB_MISSING_JAVADOC_COMMENTS_OVERRIDING,
+				PREF_PB_MISSING_JAVADOC_COMMENTS, PREF_PB_MISSING_JAVADOC_TAG_DESCRIPTION, PREF_PB_MISSING_JAVADOC_COMMENTS_VISIBILITY, PREF_PB_MISSING_JAVADOC_COMMENTS_OVERRIDING,
 			};
 		return keys;
 	}
@@ -120,6 +125,15 @@
 				PreferencesMessages.JavadocProblemsConfigurationBlock_default, 
 				PreferencesMessages.JavadocProblemsConfigurationBlock_private
 		};
+		
+		String[] considerTagDescriptions= new String[] { NO_TAG, RETURN_TAG, ALL_TAGS  };
+		
+		String[] considerTagDescriptionsLabels= new String[] {
+				PreferencesMessages.JavadocProblemsConfigurationBlock_pb_missing_javadoc_description_no_tag_label, 
+				PreferencesMessages.JavadocProblemsConfigurationBlock_pb_missing_javadoc_description_return_tag_label, 
+				PreferencesMessages.JavadocProblemsConfigurationBlock_pb_missing_javadoc_description_all_tag_label
+		};
+		
 		int nColumns= 3;
 				
 
@@ -161,10 +175,14 @@
 		
 		label = PreferencesMessages.JavadocProblemsConfigurationBlock_pb_invalid_javadoc_tags_visibility_label; 
 		addComboBox(composite, label, PREF_PB_INVALID_JAVADOC_TAGS_VISIBILITY, visibilities, visibilitiesLabels, indent);
-
+		
 		label= PreferencesMessages.JavadocProblemsConfigurationBlock_pb_invalid_javadoc_tags_label; 
 		addCheckBox(composite, label, PREF_PB_INVALID_JAVADOC_TAGS, enabledDisabled, indent);
 		
+		label = PreferencesMessages.JavadocProblemsConfigurationBlock_pb_missing_javadoc_description_label; 
+		addComboBox(composite, label, PREF_PB_MISSING_JAVADOC_TAG_DESCRIPTION, considerTagDescriptions, considerTagDescriptionsLabels, indent);
+		setComboEnabled(PREF_PB_MISSING_JAVADOC_TAG_DESCRIPTION, true);
+		
 		label= PreferencesMessages.JavadocProblemsConfigurationBlock_pb_invalid_javadoc_tags_not_visible_ref_label; 
 		addCheckBox(composite, label, PREF_PB_INVALID_JAVADOC_TAGS_NOT_VISIBLE_REF, enabledDisabled, indent);
 		
@@ -188,7 +206,7 @@
 		
 		label = PreferencesMessages.JavadocProblemsConfigurationBlock_pb_missing_comments_label; 
 		addComboBox(composite, label, PREF_PB_MISSING_JAVADOC_COMMENTS, errorWarningIgnore, errorWarningIgnoreLabels, 0);
-
+		
 		label = PreferencesMessages.JavadocProblemsConfigurationBlock_pb_missing_comments_visibility_label; 
 		addComboBox(composite, label, PREF_PB_MISSING_JAVADOC_COMMENTS_VISIBILITY, visibilities, visibilitiesLabels, indent);
 		
@@ -211,6 +229,7 @@
 			if (PREF_PB_INVALID_JAVADOC.equals(changedKey) ||
 					PREF_PB_MISSING_JAVADOC_TAGS.equals(changedKey) ||
 					PREF_PB_MISSING_JAVADOC_COMMENTS.equals(changedKey) ||
+					PREF_PB_INVALID_JAVADOC_TAGS.equals(changedKey) ||
 					PREF_JAVADOC_SUPPORT.equals(changedKey)) {				
 				updateEnableStates();
 			} else {
@@ -225,9 +244,10 @@
 	private void updateEnableStates() {		
 		boolean enableJavadoc= checkValue(PREF_JAVADOC_SUPPORT, ENABLED);
 		enableConfigControls(enableJavadoc);
-
+		
 		if (enableJavadoc) {
 			boolean enableInvalidTagsErrors= !checkValue(PREF_PB_INVALID_JAVADOC, IGNORE);
+			setComboEnabled(PREF_PB_MISSING_JAVADOC_TAG_DESCRIPTION, enableInvalidTagsErrors);
 			getCheckBox(PREF_PB_INVALID_JAVADOC_TAGS).setEnabled(enableInvalidTagsErrors);
 			getCheckBox(PREF_PB_INVALID_JAVADOC_TAGS_NOT_VISIBLE_REF).setEnabled(enableInvalidTagsErrors);
 			getCheckBox(PREF_PB_INVALID_JAVADOC_TAGS_DEPRECATED_REF).setEnabled(enableInvalidTagsErrors);
Index: ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.java
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.ui/ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.java,v
retrieving revision 1.90
diff -u -r1.90 PreferencesMessages.java
--- ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.java	17 Sep 2007 10:48:12 -0000	1.90
+++ ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.java	28 Sep 2007 10:13:06 -0000
@@ -453,6 +453,10 @@
 	public static String JavadocProblemsConfigurationBlock_javadoc_description;
 	public static String JavadocProblemsConfigurationBlock_pb_javadoc_support_label;
 	public static String JavadocProblemsConfigurationBlock_pb_invalid_javadoc_label;
+	public static String JavadocProblemsConfigurationBlock_pb_missing_javadoc_description_label;
+	public static String JavadocProblemsConfigurationBlock_pb_missing_javadoc_description_no_tag_label;
+	public static String JavadocProblemsConfigurationBlock_pb_missing_javadoc_description_return_tag_label;
+	public static String JavadocProblemsConfigurationBlock_pb_missing_javadoc_description_all_tag_label;
 	public static String JavadocProblemsConfigurationBlock_pb_invalid_javadoc_tags_label;
 	public static String JavadocProblemsConfigurationBlock_pb_invalid_javadoc_tags_visibility_label;
 	public static String JavadocProblemsConfigurationBlock_pb_invalid_javadoc_tags_not_visible_ref_label;
Index: ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.properties
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.ui/ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.properties,v
retrieving revision 1.438
diff -u -r1.438 PreferencesMessages.properties
--- ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.properties	18 Sep 2007 16:59:36 -0000	1.438
+++ ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.properties	28 Sep 2007 10:13:06 -0000
@@ -501,6 +501,10 @@
 JavadocProblemsConfigurationBlock_pb_javadoc_support_label=Proc&ess Javadoc comments (includes search and refactoring)
 JavadocProblemsConfigurationBlock_pb_invalid_javadoc_label=Mal&formed Javadoc comments:
 JavadocProblemsConfigurationBlock_pb_invalid_javadoc_tags_label=Report e&rrors in tags
+JavadocProblemsConfigurationBlock_pb_missing_javadoc_description_label=Report missing tag description
+JavadocProblemsConfigurationBlock_pb_missing_javadoc_description_no_tag_label=Ignore
+JavadocProblemsConfigurationBlock_pb_missing_javadoc_description_return_tag_label=Return tag
+JavadocProblemsConfigurationBlock_pb_missing_javadoc_description_all_tag_label=All tags
 JavadocProblemsConfigurationBlock_pb_invalid_javadoc_tags_visibility_label=On&ly consider members as visible as:
 JavadocProblemsConfigurationBlock_pb_invalid_javadoc_tags_not_visible_ref_label=Report non &visible references
 JavadocProblemsConfigurationBlock_pb_invalid_javadoc_tags_deprecated_label=Report de&precated references