Attachment 218860 Details for Bug 326514 – Fix

[patch] Fix

bug326514_v01.patch (text/plain), 123.96 KB, created by Tomasz Zarna

on 2012-07-18 05:49:25 EDT

(hide)

Description:

Filename:

MIME Type:

Creator: Tomasz Zarna

Created: 2012-07-18 05:49:25 EDT

Size: 123.96 KB

patch

obsolete

>diff --git a/org.eclipse.jdt.core/model/org/eclipse/jdt/core/JavaCore.java b/org.eclipse.jdt.core/model/org/eclipse/jdt/core/JavaCore.java
>index 1af5510..d20050f 100644
>--- a/org.eclipse.jdt.core/model/org/eclipse/jdt/core/JavaCore.java
>+++ b/org.eclipse.jdt.core/model/org/eclipse/jdt/core/JavaCore.java
>@@ -220,7 +220,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Generating Local Variable Debug Attribute.
> 	 * When generated, this attribute will enable local variable names
> 	 * to be displayed in debugger, only in place where variables are
>-	 * definitely assigned (.class file is then bigger).
>+	 * definitely assigned (.class file is then bigger).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.debug.localVariable"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "generate", "do not generate" }</code></dd>
>@@ -232,7 +232,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Generating Line Number Debug Attribute.
> 	 * When generated, this attribute will enable source code highlighting in debugger
>-	 * (.class file is then bigger).
>+	 * (.class file is then bigger).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.debug.lineNumber"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "generate", "do not generate" }</code></dd>
>@@ -244,7 +244,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Generating Source Debug Attribute.
> 	 * When generated, this attribute will enable the debugger to present the
>-	 * corresponding source code.
>+	 * corresponding source code.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.debug.sourceFile"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "generate", "do not generate" }</code></dd>
>@@ -256,7 +256,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Preserving Unused Local Variables.
> 	 * Unless requested to preserve unused local variables (that is, never read), the
>-	 * compiler will optimize them out, potentially altering debugging.
>+	 * compiler will optimize them out, potentially altering debugging.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.codegen.unusedLocal"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "preserve", "optimize out" }</code></dd>
>@@ -267,11 +267,11 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_CODEGEN_UNUSED_LOCAL = PLUGIN_ID + ".compiler.codegen.unusedLocal"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Defining Target Java Platform.
>-	 * For binary compatibility reason, .class files can be tagged to with certain VM versions and later.
>+	 * For binary compatibility reason, .class files can be tagged to with certain VM versions and later.
> 	 * Note that <code>"1.4"</code> target requires to toggle compliance mode to <code>"1.4"</code>, <code>"1.5"</code> target requires
> 	 * to toggle compliance mode to <code>"1.5"</code>, <code>"1.6"</code> target requires to toggle compliance mode to <code>"1.6"</code> and
> 	 * <code>"1.7"</code> target requires to toggle compliance mode to <code>"1.7"</code>.
>-	 * <code>"cldc1.1"</code> requires the source version to be <code>"1.3"</code> and the compliance version to be <code>"1.4"</code> or lower.
>+	 * <code>"cldc1.1"</code> requires the source version to be <code>"1.3"</code> and the compliance version to be <code>"1.4"</code> or lower.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.codegen.targetPlatform"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "1.1", "1.2", "1.3", "1.4", "1.5", "1.6", "1.7", "cldc1.1" }</code></dd>
>@@ -284,10 +284,10 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Inline JSR Bytecode Instruction.
> 	 * When enabled, the compiler will no longer generate JSR instructions, but rather inline corresponding
> 	 * subroutine code sequences (mostly corresponding to try finally blocks). The generated code will thus
>-	 * get bigger, but will load faster on virtual machines since the verification process is then much simpler.
>-	 * This mode is anticipating support for the Java Specification Request 202.
>+	 * get bigger, but will load faster on virtual machines since the verification process is then much simpler.
>+	 * This mode is anticipating support for the Java Specification Request 202.
> 	 * Note that JSR inlining is optional only for target platform lesser than 1.5. From 1.5 on, the JSR
>-	 * inlining is mandatory (also see related setting {@link #COMPILER_CODEGEN_TARGET_PLATFORM}).
>+	 * inlining is mandatory (also see related setting {@link #COMPILER_CODEGEN_TARGET_PLATFORM}).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.codegen.inlineJsrBytecode"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -301,7 +301,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: 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.
>+	 * DOM AST Javadoc node will be only a flat text instead of having structured tag elements.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.doc.comment.support"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -329,7 +329,7 @@ public final class JavaCore extends Plugin {
> 	 * Attempting to override a package visible method from another package
> 	 * introduces a new method that is unrelated to the original one. When
> 	 * enabling this option, the compiler will signal such situations as an
>-	 * error or a warning.
>+	 * error or a warning.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.overridingPackageDefaultMethod"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -342,7 +342,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Reporting Method With Constructor Name.
> 	 * Naming a method with a constructor name is generally considered poor
> 	 * style programming. When enabling this option, the compiler will signal such
>-	 * scenarii either as an error or a warning.
>+	 * scenario either as an error or a warning.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.methodWithConstructorName"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -354,7 +354,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Deprecation.
> 	 * When enabled, the compiler will signal use of deprecated API either as an
>-	 * error or a warning.
>+	 * error or a warning.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.deprecation"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -365,8 +365,8 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_DEPRECATION = PLUGIN_ID + ".compiler.problem.deprecation"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Reporting Deprecation Inside Deprecated Code.
>-	 * When enabled, the compiler will signal use of deprecated API inside deprecated code.
>-	 * The severity of the problem is controlled with option {@link #COMPILER_PB_DEPRECATION}.
>+	 * When enabled, the compiler will signal use of deprecated API inside deprecated code.
>+	 * The severity of the problem is controlled with option {@link #COMPILER_PB_DEPRECATION}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.deprecationInDeprecatedCode"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -378,8 +378,8 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_DEPRECATION_IN_DEPRECATED_CODE = PLUGIN_ID + ".compiler.problem.deprecationInDeprecatedCode"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Reporting Deprecation When Overriding Deprecated Method.
>-	 * When enabled, the compiler will signal the declaration of a method overriding a deprecated one.
>-	 * The severity of the problem is controlled with option {@link #COMPILER_PB_DEPRECATION}.
>+	 * When enabled, the compiler will signal the declaration of a method overriding a deprecated one.
>+	 * The severity of the problem is controlled with option {@link #COMPILER_PB_DEPRECATION}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.deprecationWhenOverridingDeprecatedMethod"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -391,14 +391,14 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_DEPRECATION_WHEN_OVERRIDING_DEPRECATED_METHOD = "org.eclipse.jdt.core.compiler.problem.deprecationWhenOverridingDeprecatedMethod"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Reporting Hidden Catch Block.
>-	 * Locally to a try statement, some catch blocks may hide others. For example,
>+	 * Locally to a try statement, some catch blocks may hide others. For example,
> 	 * <pre>
> 	 * try { throw new java.io.CharConversionException();
> 	 * } catch (java.io.CharConversionException e) {
> 	 * } catch (java.io.IOException e) {}.
> 	 * </pre>
>-	 * When enabling this option, the compiler will issue an error or a warning for hidden
>-	 * catch blocks corresponding to checked exceptions.
>+	 * When enabling this option, the compiler will issue an error or a warning for hidden
>+	 * catch blocks corresponding to checked exceptions.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.hiddenCatchBlock"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -410,7 +410,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Unused Local.
> 	 * When enabled, the compiler will issue an error or a warning for unused local
>-	 * variables (that is, variables never read from).
>+	 * variables (that is, variables never read from).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unusedLocal"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -422,7 +422,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Unused Parameter.
> 	 * When enabled, the compiler will issue an error or a warning for unused method
>-	 * parameters (that is, parameters never read from).
>+	 * parameters (that is, parameters never read from).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unusedParameter"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -433,8 +433,8 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_UNUSED_PARAMETER = PLUGIN_ID + ".compiler.problem.unusedParameter"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Reporting Unused Parameter if Implementing Abstract Method.
>-	 * When enabled, the compiler will signal unused parameters in abstract method implementations.
>-	 * The severity of the problem is controlled with option {@link #COMPILER_PB_UNUSED_PARAMETER}.
>+	 * When enabled, the compiler will signal unused parameters in abstract method implementations.
>+	 * The severity of the problem is controlled with option {@link #COMPILER_PB_UNUSED_PARAMETER}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unusedParameterWhenImplementingAbstract"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -446,8 +446,8 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_UNUSED_PARAMETER_WHEN_IMPLEMENTING_ABSTRACT = PLUGIN_ID + ".compiler.problem.unusedParameterWhenImplementingAbstract"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Reporting Unused Parameter if Overriding Concrete Method.
>-	 * When enabled, the compiler will signal unused parameters in methods overriding concrete ones.
>-	 * The severity of the problem is controlled with option {@link #COMPILER_PB_UNUSED_PARAMETER}.
>+	 * When enabled, the compiler will signal unused parameters in methods overriding concrete ones.
>+	 * The severity of the problem is controlled with option {@link #COMPILER_PB_UNUSED_PARAMETER}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unusedParameterWhenOverridingConcrete"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -460,10 +460,10 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Consider Reference in Doc Comment for Unused Parameter Check.
> 	 * When enabled, the compiler will consider doc comment references to parameters (i.e. <code>@param</code> clauses) for the unused
>-	 * parameter check. Thus, documented parameters will be considered as mandated as per doc contract.
>-	 * The severity of the unused parameter problem is controlled with option {@link #COMPILER_PB_UNUSED_PARAMETER}.
>+	 * parameter check. Thus, documented parameters will be considered as mandated as per doc contract.
>+	 * The severity of the unused parameter problem is controlled with option {@link #COMPILER_PB_UNUSED_PARAMETER}.
> 	 * Note: this option has no effect until the doc comment support is enabled according to the
>-	 * option {@link #COMPILER_DOC_COMMENT_SUPPORT}.
>+	 * option {@link #COMPILER_DOC_COMMENT_SUPPORT}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unusedParameterIncludeDocCommentReference"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -476,7 +476,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Unused Import.
> 	 * When enabled, the compiler will issue an error or a warning for unused import
>-	 * reference.
>+	 * reference.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unusedImport"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -490,7 +490,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Reporting Presence of Type Arguments for a Non-Generic Method Invocation.
> 	 * When enabled, the compiler will issue an error or a warning whenever type arguments are encountered for a
> 	 * non-generic method invocation. Note that prior to compliance level is <code>"1.7"</code>, this situation would automatically result
>-	 * in an error. From Java7 on, unused type arguments are being tolerated, and optionally warned against.
>+	 * in an error. From Java7 on, unused type arguments are being tolerated, and optionally warned against.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unusedTypeArgumentsForMethodInvocation"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -504,7 +504,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Reporting Synthetic Access Emulation.
> 	 * When enabled, the compiler will issue an error or a warning whenever it emulates
> 	 * access to a non-accessible member of an enclosing type. Such access can have
>-	 * performance implications.
>+	 * performance implications.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.syntheticAccessEmulation"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -516,7 +516,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Non-Externalized String Literal.
> 	 * When enabled, the compiler will issue an error or a warning for non externalized
>-	 * String literal (that is, not tagged with <code>//$NON-NLS-&lt;n&gt;$</code>).
>+	 * String literal (that is, not tagged with <code>//$NON-NLS-&lt;n&gt;$</code>).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.nonExternalizedStringLiteral"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -529,7 +529,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Usage of <code>'assert'</code> Identifier.
> 	 * When enabled, the compiler will issue an error or a warning whenever <code>'assert'</code> is
>-	 * used as an identifier (reserved keyword in 1.4).
>+	 * used as an identifier (reserved keyword in 1.4).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.assertIdentifier"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -542,7 +542,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Usage of <code>'enum'</code> Identifier.
> 	 * When enabled, the compiler will issue an error or a warning whenever <code>'enum'</code> is
>-	 * used as an identifier (reserved keyword in 1.5).
>+	 * used as an identifier (reserved keyword in 1.5).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.enumIdentifier"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -556,7 +556,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Reporting Non-Static Reference to a Static Member.
> 	 * When enabled, the compiler will issue an error or a warning whenever a static field
> 	 * or method is accessed with an expression receiver. A reference to a static member should
>-	 * be qualified with a type name.
>+	 * be qualified with a type name.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.staticAccessReceiver"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -570,7 +570,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Reporting Indirect Reference to a Static Member.
> 	 * When enabled, the compiler will issue an error or a warning whenever a static field
> 	 * or method is accessed in an indirect way. A reference to a static member should
>-	 * preferably be qualified with its declaring type name.
>+	 * preferably be qualified with its declaring type name.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.indirectStaticAccess"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -583,7 +583,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Assignment with no Effect.
> 	 * When enabled, the compiler will issue an error or a warning whenever an assignment
>-	 * has no effect (e.g <code>'x = x'</code>).
>+	 * has no effect (e.g <code>'x = x'</code>).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.noEffectAssignment"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -597,7 +597,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Reporting Interface Method not Compatible with non-Inherited Methods.
> 	 * When enabled, the compiler will issue an error or a warning whenever an interface
> 	 * defines a method incompatible with a non-inherited <code>Object</code> method. Until this conflict
>-	 * is resolved, such an interface cannot be implemented, For example,
>+	 * is resolved, such an interface cannot be implemented. For example,
> 	 * <pre>
> 	 * interface I {
> 	 * int clone();
>@@ -615,7 +615,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Unused Private Members.
> 	 * When enabled, the compiler will issue an error or a warning whenever a private
>-	 * method or field is declared but never used within the same unit.
>+	 * method or field is declared but never used within the same unit.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unusedPrivateMember"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -628,7 +628,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Local Variable Declaration Hiding another Variable.
> 	 * When enabled, the compiler will issue an error or a warning whenever a local variable
>-	 * declaration is hiding some field or local variable (either locally, inherited or defined in enclosing type).
>+	 * declaration is hiding some field or local variable (either locally, inherited or defined in enclosing type).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.localVariableHiding"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -641,8 +641,8 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Special Parameter Hiding another Field.
> 	 * When enabled, the compiler will signal cases where a constructor or setter method parameter declaration
>-	 * is hiding some field (either locally, inherited or defined in enclosing type).
>-	 * The severity of the problem is controlled with option {@link #COMPILER_PB_LOCAL_VARIABLE_HIDING}.
>+	 * is hiding some field (either locally, inherited or defined in enclosing type).
>+	 * The severity of the problem is controlled with option {@link #COMPILER_PB_LOCAL_VARIABLE_HIDING}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.specialParameterHidingField"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -655,7 +655,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Field Declaration Hiding another Variable.
> 	 * When enabled, the compiler will issue an error or a warning whenever a field
>-	 * declaration is hiding some field or local variable (either locally, inherited or defined in enclosing type).
>+	 * declaration is hiding some field or local variable (either locally, inherited or defined in enclosing type).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.fieldHiding"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -669,7 +669,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Reporting Type Declaration Hiding another Type.
> 	 * When enabled, the compiler will issue an error or a warning in situations where a type parameter
> 	 * declaration is hiding some type, when a nested type is hiding some type parameter, or when
>-	 * a nested type is hiding another nested type defined in same unit.
>+	 * a nested type is hiding another nested type defined in same unit.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.typeParameterHiding"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -682,7 +682,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Possible Accidental Boolean Assignment.
> 	 * When enabled, the compiler will issue an error or a warning if a boolean assignment is acting as the condition
>-	 * of a control statement (where it probably was meant to be a boolean comparison).
>+	 * of a control statement (where it probably was meant to be a boolean comparison).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.possibleAccidentalBooleanAssignment"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -695,7 +695,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Switch Fall-Through Case.
> 	 * When enabled, the compiler will issue an error or a warning if a case may be
>-	 * entered by falling through previous case. Empty cases are allowed.
>+	 * entered by falling through previous case. Empty cases are allowed.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.fallthroughCase"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -708,7 +708,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Empty Statements and Unnecessary Semicolons.
> 	 * When enabled, the compiler will issue an error or a warning if an empty statement or a
>-	 * unnecessary semicolon is encountered.
>+	 * unnecessary semicolon is encountered.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.emptyStatement"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -733,7 +733,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Unnecessary Type Check.
> 	 * When enabled, the compiler will issue an error or a warning when a cast or an <code>instanceof</code> operation
>-	 * is unnecessary.
>+	 * is unnecessary.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unnecessaryTypeCheck"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -746,7 +746,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Unnecessary Else.
> 	 * When enabled, the compiler will issue an error or a warning when a statement is unnecessarily
>-	 * nested within an <code>else</code> clause (in situation where then clause is not completing normally).
>+	 * nested within an <code>else</code> clause (in situation where then clause is not completing normally).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unnecessaryElse"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -759,7 +759,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Undocumented Empty Block.
> 	 * When enabled, the compiler will issue an error or a warning when an empty block is detected and it is not
>-	 * documented with any comment.
>+	 * documented with any comment.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.undocumentedEmptyBlock"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -771,7 +771,7 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_UNDOCUMENTED_EMPTY_BLOCK = PLUGIN_ID + ".compiler.problem.undocumentedEmptyBlock"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Reporting Finally Blocks Not Completing Normally.
>-	 * When enabled, the compiler will issue an error or a warning when a finally block does not complete normally.
>+	 * When enabled, the compiler will issue an error or a warning when a finally block does not complete normally.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.finallyBlockNotCompletingNormally"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -786,11 +786,11 @@ public final class JavaCore extends Plugin {
> 	 * When enabled, the compiler will issue an error or a warning when a
> 	 * method or a constructor is declaring a checked exception as thrown,
> 	 * but its body actually raises neither that exception, nor any other
>-	 * exception extending it.
>+	 * exception extending it.
> 	 * This diagnostic is further tuned by options
> 	 * {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION_INCLUDE_DOC_COMMENT_REFERENCE},
> 	 * {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION_EXEMPT_EXCEPTION_AND_THROWABLE},
>-	 * and {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION_WHEN_OVERRIDING}.
>+	 * and {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION_WHEN_OVERRIDING}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownException"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -803,12 +803,12 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Unused Declared Thrown Exception in Overriding Method.
> 	 * When disabled, the compiler will report unused declared thrown
>-	 * exceptions neither on overriding methods nor on implementing methods.
>+	 * exceptions neither on overriding methods nor on implementing methods.
> 	 * The severity of the unused declared thrown exception problem is
>-	 * controlled with option {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION}.
>+	 * controlled with option {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION}.
> 	 * This diagnostic is further tuned by options
> 	 * {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION_INCLUDE_DOC_COMMENT_REFERENCE} and
>-	 * {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION_EXEMPT_EXCEPTION_AND_THROWABLE}.
>+	 * {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION_EXEMPT_EXCEPTION_AND_THROWABLE}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownExceptionWhenOverriding"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -823,13 +823,13 @@ public final class JavaCore extends Plugin {
> 	 * When enabled, the compiler will consider doc comment references to
> 	 * exceptions (i.e. <code>@throws</code> clauses) for the unused
> 	 * declared thrown exception check. Thus, documented exceptions will be
>-	 * considered as mandated as per doc contract.
>-	 * The severity of the unused declared thrown exception problem is controlled with option {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION}.
>+	 * considered as mandated as per doc contract.
>+	 * The severity of the unused declared thrown exception problem is controlled with option {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION}.
> 	 * Note: this option has no effect until the doc comment support is enabled according to the
>-	 * option {@link #COMPILER_DOC_COMMENT_SUPPORT}.
>+	 * option {@link #COMPILER_DOC_COMMENT_SUPPORT}.
> 	 * This diagnostic is further tuned by options
> 	 * {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION_EXEMPT_EXCEPTION_AND_THROWABLE}
>-	 * and {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION_WHEN_OVERRIDING}.
>+	 * and {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION_WHEN_OVERRIDING}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownExceptionIncludeDocCommentReference"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -849,13 +849,13 @@ public final class JavaCore extends Plugin {
> 	 * error or a warning when a method or a constructor is declaring a
> 	 * checked exception (including {@link java.lang.Throwable} and
> 	 * {@link java.lang.Exception}) as thrown, but its body actually raises
>-	 * neither that exception, nor any other exception extending it.
>+	 * neither that exception, nor any other exception extending it.
> 	 * The severity of the unused declared thrown exception problem is
> 	 * controlled with option
>-	 * {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION}.
>+	 * {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION}.
> 	 * This diagnostic is further tuned by options
> 	 * {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION_INCLUDE_DOC_COMMENT_REFERENCE}
>-	 * and {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION_WHEN_OVERRIDING}.
>+	 * and {@link #COMPILER_PB_UNUSED_DECLARED_THROWN_EXCEPTION_WHEN_OVERRIDING}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownExceptionExemptExceptionAndThrowable"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -868,7 +868,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Unqualified Access to Field.
> 	 * When enabled, the compiler will issue an error or a warning when a field is access without any qualification.
>-	 * In order to improve code readability, it should be qualified, e.g. <code>'x'</code> should rather be written <code>'this.x'</code>.
>+	 * In order to improve code readability, it should be qualified, e.g. <code>'x'</code> should rather be written <code>'this.x'</code>.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unqualifiedFieldAccess"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -887,7 +887,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Unchecked Type Operation.
> 	 * When enabled, the compiler will issue an error or a warning whenever an operation involves generic types, and potentially
>-	 * invalidates type safety since involving raw types (e.g. invoking <code>#foo(X&lt;String&gt;)</code> with arguments <code>(X)</code>).
>+	 * invalidates type safety since involving raw types (e.g. invoking <code>#foo(X&lt;String&gt;)</code> with arguments <code>(X)</code>).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.uncheckedTypeOperation"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -901,7 +901,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Reporting Raw Type Reference.
> 	 * When enabled, the compiler will issue an error or a warning when detecting references to raw types. Raw types are
> 	 * discouraged, and are intended to help interfacing with legacy code. In the future, the language specification may
>-	 * reject raw references to generic types.
>+	 * reject raw references to generic types.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.rawTypeReference"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -916,7 +916,7 @@ public final class JavaCore extends Plugin {
> 	 * When enabled, the compiler will issue an error or warning even when it detects a generic type problem
> 	 * that could not have been avoided by the programmer. As an example, a type may be forced to use raw types
> 	 * in its method signatures and return types because the methods it overrides from a super type are declared to
>-	 * use raw types in the first place. 
>+	 * use raw types in the first place.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unavoidableGenericTypeProblems"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -930,7 +930,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting final Bound for Type Parameter.
> 	 * When enabled, the compiler will issue an error or a warning whenever a generic type parameter is associated with a
>-	 * bound corresponding to a final type; since final types cannot be further extended, the parameter is pretty useless.
>+	 * bound corresponding to a final type; since final types cannot be further extended, the parameter is pretty useless.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.finalParameterBound"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -943,7 +943,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Missing Declaration of serialVersionUID Field on Serializable Class.
> 	 * When enabled, the compiler will issue an error or a warning whenever a serializable class is missing a local declaration
>-	 * of a <code>serialVersionUID</code> field. This field must be declared as static final and be of type <code>long</code>.
>+	 * of a <code>serialVersionUID</code> field. This field must be declared as static final and be of type <code>long</code>.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.missingSerialVersion"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -957,7 +957,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Reporting Varargs Argument Needing a Cast in Method/Constructor Invocation.
> 	 * When enabled, the compiler will issue an error or a warning whenever a varargs arguments should be cast
> 	 * when passed to a method/constructor invocation. (e.g. <code>Class.getMethod(String name, Class ... args )</code>
>-	 * invoked with arguments <code>("foo", null)</code>).
>+	 * invoked with arguments <code>("foo", null)</code>).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.varargsArgumentNeedCast"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -970,7 +970,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Boxing/Unboxing Conversion.
> 	 * When enabled, the compiler will issue an error or a warning whenever a boxing or an unboxing
>-	 * conversion is performed.
>+	 * conversion is performed.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.autoboxing"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -983,7 +983,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Use of Annotation Type as Super Interface.
> 	 * When enabled, the compiler will issue an error or a warning whenever an annotation type is used
>-	 * as a super-interface. Though legal, this is discouraged.
>+	 * as a super-interface. Though legal, this is discouraged.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.annotationSuperInterface"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -996,7 +996,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Missing <code>@Override</code> Annotation.
> 	 * When enabled, the compiler will issue an error or a warning whenever encountering a method
>-	 * declaration which overrides a superclass method but has no <code>@Override</code> annotation.
>+	 * declaration which overrides a superclass method but has no <code>@Override</code> annotation.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.missingOverrideAnnotation"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1024,7 +1024,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Missing <code>@Deprecated</code> Annotation.
> 	 * When enabled, the compiler will issue an error or a warning whenever encountering a declaration
>-	 * carrying a <code>@deprecated</code> doc tag but having no corresponding <code>@Deprecated</code> annotation.
>+	 * carrying a <code>@deprecated</code> doc tag but having no corresponding <code>@Deprecated</code> annotation.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.missingDeprecatedAnnotation"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1037,7 +1037,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Missing HashCode Method.
> 	 * When enabled, the compiler will issue an error or a warning if a type
>-	 * overrides Object.equals(Object) but does not override hashCode().
>+	 * overrides Object.equals(Object) but does not override hashCode().
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.missingHashCodeMethod"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1051,7 +1051,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Reporting Dead Code.
> 	 * When enabled, the compiler will issue an error or a warning if some non fatal dead code is detected. For instance, <code>if (false) foo();</code>
> 	 * is not reported as truly unreachable code by the Java Language Specification. If this diagnostic is enabled, then the invocation of <code>foo()</code> is
>-	 * going to be signaled as being dead code.
>+	 * going to be signaled as being dead code.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.deadCode"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1063,8 +1063,8 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_DEAD_CODE = PLUGIN_ID + ".compiler.problem.deadCode"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Reporting Dead Code Inside Trivial If Statement.
>-	 * When enabled, the compiler will signal presence of dead code inside trivial IF statement, e.g. <code>if (DEBUG)...</code>..
>-	 * The severity of the problem is controlled with option {@link #COMPILER_PB_DEAD_CODE}.
>+	 * When enabled, the compiler will signal presence of dead code inside trivial IF statement, e.g. <code>if (DEBUG)...</code>.
>+	 * The severity of the problem is controlled with option {@link #COMPILER_PB_DEAD_CODE}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.deadCodeInTrivialIfStatement"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -1078,7 +1078,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Reporting Incomplete Enum Switch.
> 	 * When enabled, the compiler will issue an error or a warning
> 	 * 		regarding each enum constant for which a corresponding case label is lacking.
>-	 * 		Reporting is further controlled by the option {@link #COMPILER_PB_MISSING_ENUM_CASE_DESPITE_DEFAULT}.
>+	 * 		Reporting is further controlled by the option {@link #COMPILER_PB_MISSING_ENUM_CASE_DESPITE_DEFAULT}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.incompleteEnumSwitch"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1090,7 +1090,7 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_INCOMPLETE_ENUM_SWITCH = PLUGIN_ID + ".compiler.problem.incompleteEnumSwitch"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Reporting Missing Enum Case In Switch Despite An Existing Default Case.
>-	 * This option further controls the option {@link #COMPILER_PB_INCOMPLETE_ENUM_SWITCH}:
>+	 * This option further controls the option {@link #COMPILER_PB_INCOMPLETE_ENUM_SWITCH}:
> 	 * 	<ul>
> 	 * 	<li>If enabled the compiler will report problems about missing enum constants even if a default case exists
> 	 * 		in the same switch statement.</li>
>@@ -1109,7 +1109,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Missing Default Case In Switch.
> 	 * When enabled, the compiler will issue an error or a warning 
>-	 * 		against each switch statement that lacks a default case.
>+	 * 		against each switch statement that lacks a default case.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.missingDefaultCase"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1129,7 +1129,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Reporting Unreferenced Label.
> 	 * When enabled, the compiler will issue an error or a warning when encountering a labeled statement which label
> 	 * is never explicitly referenced. A label is considered to be referenced if its name explicitly appears behind a break
>-	 * or continue statement; for instance the following label would be considered unreferenced:
>+	 * or continue statement; for instance the following label would be considered unreferenced:
> 	 * <code>LABEL: { break; }</code>
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unusedLabel"</code></dd>
>@@ -1143,7 +1143,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Invalid Javadoc Comment.
> 	 * This is the generic control for the severity of Javadoc problems.
>-	 * When enabled, the compiler will issue an error or a warning for a problem in Javadoc.
>+	 * When enabled, the compiler will issue an error or a warning for a problem in Javadoc.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.invalidJavadoc"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1156,9 +1156,9 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Invalid Javadoc Tags.
> 	 * When enabled, the compiler will signal unbound or unexpected reference tags in Javadoc.
>-	 * A <code>@throws</code> tag referencing an undeclared exception would be considered as unexpected.
>+	 * A <code>@throws</code> tag referencing an undeclared exception would be considered as unexpected.
> 	 * Note that this diagnosis can be enabled based on the visibility of the construct associated with the Javadoc;
>-	 * also see the setting {@link #COMPILER_PB_INVALID_JAVADOC_TAGS_VISIBILITY}.
>+	 * also see the setting {@link #COMPILER_PB_INVALID_JAVADOC_TAGS_VISIBILITY}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.invalidJavadocTags"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -1170,9 +1170,9 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_INVALID_JAVADOC_TAGS = PLUGIN_ID + ".compiler.problem.invalidJavadocTags"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Reporting Invalid Javadoc Tags with Deprecated References.
>-	 * Specify whether the compiler will report deprecated references used in Javadoc tags.
>+	 * Specify whether the compiler will report deprecated references used in Javadoc tags.
> 	 * Note that this diagnosis can be enabled based on the visibility of the construct associated with the Javadoc;
>-	 * also see the setting {@link #COMPILER_PB_INVALID_JAVADOC_TAGS_VISIBILITY}.
>+	 * also see the setting {@link #COMPILER_PB_INVALID_JAVADOC_TAGS_VISIBILITY}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsDeprecatedRef"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -1184,9 +1184,9 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_INVALID_JAVADOC_TAGS__DEPRECATED_REF = PLUGIN_ID + ".compiler.problem.invalidJavadocTagsDeprecatedRef"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Reporting Invalid Javadoc Tags with Not Visible References.
>-	 * Specify whether the compiler will report non-visible references used in Javadoc tags.
>+	 * Specify whether the compiler will report non-visible references used in Javadoc tags.
> 	 * Note that this diagnosis can be enabled based on the visibility of the construct associated with the Javadoc;
>-	 * also see the setting {@link #COMPILER_PB_INVALID_JAVADOC_TAGS_VISIBILITY}.
>+	 * also see the setting {@link #COMPILER_PB_INVALID_JAVADOC_TAGS_VISIBILITY}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsNotVisibleRef"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -1198,7 +1198,7 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_INVALID_JAVADOC_TAGS__NOT_VISIBLE_REF = PLUGIN_ID + ".compiler.problem.invalidJavadocTagsNotVisibleRef"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Visibility Level For Invalid Javadoc Tags.
>-	 * Set the minimum visibility level for Javadoc tag problems. Below this level problems will be ignored.
>+	 * Set the minimum visibility level for Javadoc tag problems. Below this level problems will be ignored.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsVisibility"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "public", "protected", "default", "private" }</code></dd>
>@@ -1210,12 +1210,12 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_INVALID_JAVADOC_TAGS_VISIBILITY = PLUGIN_ID + ".compiler.problem.invalidJavadocTagsVisibility"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Reporting missing tag description.
>-	 * When enabled, the compiler will report a warning or an error for any Javadoc tag missing a required description.
>-	 * The severity of the problem is controlled with option {@link #COMPILER_PB_INVALID_JAVADOC}.
>-	 * It does not depend on option {@link #COMPILER_PB_INVALID_JAVADOC_TAGS}.
>+	 * When enabled, the compiler will report a warning or an error for any Javadoc tag missing a required description.
>+	 * The severity of the problem is controlled with option {@link #COMPILER_PB_INVALID_JAVADOC}.
>+	 * It does not depend on option {@link #COMPILER_PB_INVALID_JAVADOC_TAGS}.
> 	 * When this option is valued to {@link #COMPILER_PB_MISSING_JAVADOC_TAG_DESCRIPTION_ALL_STANDARD_TAGS},
> 	 * a subset of the standard <a href="http://download.oracle.com/javase/6/docs/technotes/tools/windows/javadoc.html#javadoctags">Javadoc tags</a>
>-	 * that have a description, text or label are checked. While this set may grow in the future, note that user-defined tags are not and will not be checked.
>+	 * that have a description, text or label are checked. While this set may grow in the future, note that user-defined tags are not and will not be checked.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.missingJavadocTagDescription"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "return_tag", "all_standard_tags", "no_tag" }</code></dd>
>@@ -1228,9 +1228,9 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Missing Javadoc Tags.
> 	 * This is the generic control for the severity of Javadoc missing tag problems.
>-	 * When enabled, the compiler will issue an error or a warning when tags are missing in Javadoc comments.
>+	 * When enabled, the compiler will issue an error or a warning when tags are missing in Javadoc comments.
> 	 * Note that this diagnosis can be enabled based on the visibility of the construct associated with the Javadoc;
>-	 * also see the setting {@link #COMPILER_PB_MISSING_JAVADOC_TAGS_VISIBILITY}.
>+	 * also see the setting {@link #COMPILER_PB_MISSING_JAVADOC_TAGS_VISIBILITY}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.missingJavadocTags"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1242,7 +1242,7 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_MISSING_JAVADOC_TAGS = PLUGIN_ID + ".compiler.problem.missingJavadocTags"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Visibility Level For Missing Javadoc Tags.
>-	 * Set the minimum visibility level for Javadoc missing tag problems. Below this level problems will be ignored.
>+	 * Set the minimum visibility level for Javadoc missing tag problems. Below this level problems will be ignored.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.missingJavadocTagsVisibility"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "public", "protected", "default", "private" }</code></dd>
>@@ -1254,7 +1254,7 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_MISSING_JAVADOC_TAGS_VISIBILITY = PLUGIN_ID + ".compiler.problem.missingJavadocTagsVisibility"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Reporting Missing Javadoc Tags on Overriding Methods.
>-	 * Specify whether the compiler will verify overriding methods in order to report Javadoc missing tag problems.
>+	 * Specify whether the compiler will verify overriding methods in order to report Javadoc missing tag problems.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.missingJavadocTagsOverriding"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -1282,9 +1282,9 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Missing Javadoc Comments.
> 	 * This is the generic control for the severity of missing Javadoc comment problems.
>-	 * When enabled, the compiler will issue an error or a warning when Javadoc comments are missing.
>+	 * When enabled, the compiler will issue an error or a warning when Javadoc comments are missing.
> 	 * Note that this diagnosis can be enabled based on the visibility of the construct associated with the expected Javadoc;
>-	 * also see the setting {@link #COMPILER_PB_MISSING_JAVADOC_COMMENTS_VISIBILITY}.
>+	 * also see the setting {@link #COMPILER_PB_MISSING_JAVADOC_COMMENTS_VISIBILITY}.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.missingJavadocComments"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1296,7 +1296,7 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_MISSING_JAVADOC_COMMENTS = PLUGIN_ID + ".compiler.problem.missingJavadocComments"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Visibility Level For Missing Javadoc Comments.
>-	 * Set the minimum visibility level for missing Javadoc problems. Below this level problems will be ignored.
>+	 * Set the minimum visibility level for missing Javadoc problems. Below this level problems will be ignored.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.missingJavadocCommentsVisibility"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "public", "protected", "default", "private" }</code></dd>
>@@ -1308,7 +1308,7 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_MISSING_JAVADOC_COMMENTS_VISIBILITY = PLUGIN_ID + ".compiler.problem.missingJavadocCommentsVisibility"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Reporting Missing Javadoc Comments on Overriding Methods.
>-	 * Specify whether the compiler will verify overriding methods in order to report missing Javadoc comment problems.
>+	 * Specify whether the compiler will verify overriding methods in order to report missing Javadoc comment problems.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.missingJavadocCommentsOverriding"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -1321,7 +1321,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Usage of <code>char[]</code> Expressions in String Concatenations.
> 	 * When enabled, the compiler will issue an error or a warning whenever a <code>char[]</code> expression
>-	 * is used in String concatenations (for example, <code>"hello" + new char[]{'w','o','r','l','d'}</code>).
>+	 * is used in String concatenations (for example, <code>"hello" + new char[]{'w','o','r','l','d'}</code>).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.noImplicitStringConversion"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1333,7 +1333,7 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_CHAR_ARRAY_IN_STRING_CONCATENATION = PLUGIN_ID + ".compiler.problem.noImplicitStringConversion"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Maximum Number of Problems Reported per Compilation Unit.
>-	 * Specify the maximum number of problems reported on each compilation unit.
>+	 * Specify the maximum number of problems reported on each compilation unit.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.maxProblemPerUnit"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>"&lt;n&gt;"</code> where <code>&lt;n&gt;</code> is zero or a positive integer (if zero then all problems are reported).</dd>
>@@ -1362,7 +1362,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Parameter Assignment.
> 	 * When enabled, the compiler will issue an error or a warning if a parameter is
>-	 * assigned to.
>+	 * assigned to.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.parameterAssignment"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1375,7 +1375,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting a method that qualifies as static, but not declared static.
> 	 * When enabled, the compiler will issue an error or a warning if a method has
>-	 * not been declared as <code>static</code>, even though it qualifies as one.
>+	 * not been declared as <code>static</code>, even though it qualifies as one.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.reportMethodCanBeStatic"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1389,7 +1389,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Reporting a method that may qualify as static, but not declared static.
> 	 * When enabled, the compiler will issue an error or a warning if a method has
> 	 * not been declared as <code>static</code>, even though it may qualify as one,
>-	 * when another method doesn't override it.
>+	 * when another method doesn't override it.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.reportMethodCanBePotentiallyStatic"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1404,7 +1404,7 @@ public final class JavaCore extends Plugin {
> 	 * When enabled, the compiler will issue an error or a warning if
> 	 * a local variable holds a value of type <code>java.lang.AutoCloseable</code> (compliance>=1.7) 
> 	 * or a value of type <code>java.io.Closeable</code> (compliance<=1.6) and if
>-	 * flow analysis shows that the method <code>close()</code> is not invoked locally on that value.
>+	 * flow analysis shows that the method <code>close()</code> is not invoked locally on that value.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.reportUnclosedCloseable"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1420,7 +1420,7 @@ public final class JavaCore extends Plugin {
> 	 * a local variable holds a value of type <code>java.lang.AutoCloseable</code> (compliance>=1.7) 
> 	 * or a value of type <code>java.io.Closeable</code> (compliance<=1.6) and if
> 	 * flow analysis shows that the method <code>close()</code> is 
>-	 * not invoked locally on that value for all execution paths.
>+	 * not invoked locally on that value for all execution paths.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.reportPotentiallyUnclosedCloseable"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1435,7 +1435,7 @@ public final class JavaCore extends Plugin {
> 	 * When enabled, the compiler will issue an error or a warning if a local variable 
> 	 * 	 holds a value of type <code>java.lang.AutoCloseable</code>, and if the method
> 	 * <code>close()</code> is explicitly invoked on that resource, but the resource is
>-	 * not managed by a try-with-resources block.
>+	 * not managed by a try-with-resources block.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.reportPotentiallyUnclosedCloseable"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1559,7 +1559,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Violations of Null Specifications.
> 	 * Depending on this option, the compiler will issue either an error or a warning
>-	 * whenever one of the following situations is detected:
>+	 * whenever one of the following situations is detected:
> 	 * <ol>
> 	 * <li>A method declared with a nonnull annotation returns a
> 	 * nullable expression.</li>
>@@ -1579,7 +1579,6 @@ public final class JavaCore extends Plugin {
> 	 * In the above an expression is considered as nullable if
> 	 * either it is statically known to evaluate to the value <code>null</code>, or if it is
> 	 * declared with a nullable annotation.
>-	 * 
> 	 * The compiler options {@link #COMPILER_NONNULL_ANNOTATION_NAME} and
> 	 * {@link #COMPILER_NULLABLE_ANNOTATION_NAME} control which annotations the compiler
> 	 * shall interpret as nonnull or nullable annotations, respectively.
>@@ -1597,7 +1596,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting conflicts between declared null annotation and inferred null value 
> 	 * When enabled, the compiler will issue an error or a warning whenever one of the
>-	 * following situations is detected:
>+	 * following situations is detected:
> 	 * <ol>
> 	 * <li>A method declared with a nonnull annotation returns an expression that is
> 	 * statically known to evaluate to a null value on some flow.</li>
>@@ -1607,7 +1606,6 @@ public final class JavaCore extends Plugin {
> 	 * <li>An expression that is statically known to evaluate to a null value on some flow
> 	 * is assigned to a local variable that is declared with a nonnull annotation.</li>
> 	 * </ol>
>-	 * 
> 	 * The compiler options {@link #COMPILER_NONNULL_ANNOTATION_NAME} and
> 	 * {@link #COMPILER_NULLABLE_ANNOTATION_NAME} control which annotations the compiler
> 	 * shall interpret as nonnull or nullable annotations, respectively.
>@@ -1625,7 +1623,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting unchecked conversion from a type with unknown nullness to a null annotated type
> 	 * When enabled, the compiler will issue an error or a warning whenever one of the
>-	 * following situations is detected:
>+	 * following situations is detected:
> 	 * <ol>
> 	 * <li>A method declared with a nonnull annotation returns an expression for which
> 	 * insufficient nullness information is available for statically proving that no
>@@ -1638,9 +1636,8 @@ public final class JavaCore extends Plugin {
> 	 * statically proving that it will never evaluate to a null value at runtime
> 	 * is assigned to a local variable that is declared with a nonnull annotation.</li>
> 	 * </ol>
>-	 * Unchecked null conversion is usually a consequence of using other unannotated
>-	 * variables or methods.
>-	 * 
>+	 * Unchecked null conversion is usually a consequence of using other unannotated
>+	 * variables or methods.
> 	 * The compiler options {@link #COMPILER_NONNULL_ANNOTATION_NAME} and
> 	 * {@link #COMPILER_NULLABLE_ANNOTATION_NAME} control which annotations the compiler
> 	 * shall interpret as nonnull or nullable annotations, respectively.
>@@ -1677,14 +1674,14 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Setting Source Compatibility Mode.
> 	 * Specify whether which source level compatibility is used. From 1.4 on, <code>'assert'</code> is a keyword
> 	 * reserved for assertion support. Also note, than when toggling to 1.4 mode, the target VM
>-	 * level should be set to <code>"1.4"</code> and the compliance mode should be <code>"1.4"</code>.
>+	 * level should be set to <code>"1.4"</code> and the compliance mode should be <code>"1.4"</code>.
> 	 * Source level 1.5 is necessary to enable generics, autoboxing, covariance, annotations, enumerations
> 	 * enhanced for loop, static imports and varargs. Once toggled, the target VM level should be set to <code>"1.5"</code>
>-	 * and the compliance mode should be <code>"1.5"</code>.
>+	 * and the compliance mode should be <code>"1.5"</code>.
> 	 * Source level 1.6 is necessary to enable the computation of stack map tables. Once toggled, the target
>-	 * VM level should be set to <code>"1.6"</code> and the compliance mode should be <code>"1.6"</code>.
>+	 * VM level should be set to <code>"1.6"</code> and the compliance mode should be <code>"1.6"</code>.
> 	 * Once the source level 1.7 is toggled, the target VM level should be set to <code>"1.7"</code> and the compliance mode
>-	 * should be <code>"1.7"</code>.
>+	 * should be <code>"1.7"</code>.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.source"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "1.3", "1.4", "1.5", "1.6", "1.7" }</code></dd>
>@@ -1697,7 +1694,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Setting Compliance Level.
> 	 * Select the compliance level for the compiler. In <code>"1.3"</code> mode, source and target settings
>-	 * should not go beyond <code>"1.3"</code> level.
>+	 * should not go beyond <code>"1.3"</code> level.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.compliance"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "1.3", "1.4", "1.5", "1.6", "1.7" }</code></dd>
>@@ -1727,7 +1724,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Defining the Automatic Task Tags.
> 	 * When the tag list is not empty, the compiler will issue a task marker whenever it encounters
>-	 * one of the corresponding tags inside any comment in Java source code.
>+	 * one of the corresponding tags inside any comment in Java source code.
> 	 * Generated task messages will start with the tag, and range until the next line separator,
> 	 * comment ending, or tag.
> 	 * When a given line of code bears multiple tags, each tag will be reported separately.
>@@ -1752,7 +1749,7 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_TASK_TAGS = PLUGIN_ID + ".compiler.taskTags"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Determining whether task tags are case-sensitive.
>-	 * When enabled, task tags are considered in a case-sensitive way.
>+	 * When enabled, task tags are considered in a case-sensitive way.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.taskCaseSensitive"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -1765,7 +1762,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Forbidden Reference to Type with Restricted Access.
> 	 * When enabled, the compiler will issue an error or a warning when referring to a type that is non accessible, as defined according
>-	 * to the access rule specifications.
>+	 * to the access rule specifications.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.forbiddenReference"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1778,7 +1775,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Discouraged Reference to Type with Restricted Access.
> 	 * When enabled, the compiler will issue an error or a warning when referring to a type with discouraged access, as defined according
>-	 * to the access rule specifications.
>+	 * to the access rule specifications.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.discouragedReference"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1790,8 +1787,8 @@ public final class JavaCore extends Plugin {
> 	public static final String COMPILER_PB_DISCOURAGED_REFERENCE = PLUGIN_ID + ".compiler.problem.discouragedReference"; //$NON-NLS-1$
> 	/**
> 	 * Compiler option ID: Determining Effect of <code>@SuppressWarnings</code>.
>-	 * When enabled, the <code>@SuppressWarnings</code> annotation can be used to suppress some compiler warnings.
>-	 * When disabled, all <code>@SupressWarnings</code> annotations are ignored; i.e., warnings are reported.
>+	 * When enabled, the <code>@SuppressWarnings</code> annotation can be used to suppress some compiler warnings.
>+	 * When disabled, all <code>@SupressWarnings</code> annotations are ignored; i.e., warnings are reported.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.suppressWarnings"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -1820,8 +1817,8 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Further Determining the Effect of <code>@SuppressWarnings</code> if also
> 	 * {@link #COMPILER_PB_SUPPRESS_WARNINGS} is enabled.
> 	 * When enabled, the <code>@SuppressWarnings</code> annotation can additionally be used to suppress 
>-	 * optional compiler diagnostics that have been configured as {@link #ERROR}.
>-	 * When disabled, all <code>@SuppressWarnings</code> annotations only affects warnings.
>+	 * optional compiler diagnostics that have been configured as {@link #ERROR}.
>+	 * When disabled, all <code>@SuppressWarnings</code> annotations only affects warnings.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.suppressOptionalErrors"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -1834,7 +1831,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Unhandled Warning Token for <code>@SuppressWarnings</code>.
> 	 * When enabled, the compiler will issue an error or a warning when encountering a token
>-	 * it cannot handle inside a <code>@SuppressWarnings</code> annotation.
>+	 * it cannot handle inside a <code>@SuppressWarnings</code> annotation.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unhandledWarningToken"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1849,7 +1846,7 @@ public final class JavaCore extends Plugin {
> 	 * When enabled, the compiler will issue an error or a warning when encountering <code>@SuppressWarnings</code> annotation
> 	 * for which no corresponding warning got detected in the code. This diagnostic is provided to help developers to get
> 	 * rid of transient <code>@SuppressWarnings</code> no longer needed. Note that <code>@SuppressWarnings("all")</code> is still
>-	 * silencing the warning for unnecessary <code>@SuppressWarnings</code>, as it is the master switch to silence ALL warnings.
>+	 * silencing the warning for unnecessary <code>@SuppressWarnings</code>, as it is the master switch to silence ALL warnings.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unusedWarningToken"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1911,7 +1908,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Overriding method that doesn't call the super method invocation.
> 	 * When enabled, the compiler will issue an error or a warning if a method is overriding a method without calling
>-	 * the super invocation.
>+	 * the super invocation.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.overridingMethodWithoutSuperInvocation"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1925,7 +1922,7 @@ public final class JavaCore extends Plugin {
> 	 * Compiler option ID: Reporting Redundant Superinterface.
> 	 * When enabled, the compiler will issue an error or a warning if a type
> 	 * explicitly implements an interface that is already implemented by any
>-	 * of its supertypes.
>+	 * of its supertypes.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.redundantSuperinterface"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1938,7 +1935,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Comparison of Identical Expressions.
> 	 * When enabled, the compiler will issue an error or a warning if a comparison
>-	 * is involving identical operands (e.g <code>'x == x'</code>).
>+	 * is involving identical operands (e.g <code>'x == x'</code>).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.comparingIdentical"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1951,7 +1948,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Missing Synchronized Modifier On Inherited Method.
> 	 * When enabled, the compiler will issue an error or a warning if a method
>-	 * overrides a synchronized method without having a synchronized modifier.
>+	 * overrides a synchronized method without having a synchronized modifier.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.missingSynchronizedOnInheritedMethod"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1964,7 +1961,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting Allocation of an Unused Object.
> 	 * When enabled, the compiler will issue an error or a warning if an object is allocated but never used,
>-	 * neither by holding a reference nor by invoking one of the object's methods.
>+	 * neither by holding a reference nor by invoking one of the object's methods.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.unusedObjectAllocation"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -1977,7 +1974,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Compiler option ID: Reporting redundant specification of type arguments in class instance creation expressions.
> 	 * When enabled, the compiler will issue an error or a warning if type arguments are used in a class instance creation,
>-	 * when the '<>' operator can be used instead.
>+	 * when the '&lt;&gt;' operator can be used instead.
> 	 * This option only has an effect if the compiler compliance is 1.7 or greater.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.compiler.problem.redundantSpecificationOfTypeArguments"</code></dd>
>@@ -1992,7 +1989,7 @@ public final class JavaCore extends Plugin {
> 	 * Core option ID: Computing Project Build Order.
> 	 * Indicate whether JavaCore should enforce the project build order to be based on
> 	 * the classpath prerequisite chain. When requesting to compute, this takes over
>-	 * the platform default order (based on project references).
>+	 * the platform default order (based on project references).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.computeJavaBuildOrder"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "compute", "ignore" }</code></dd>
>@@ -2003,7 +2000,7 @@ public final class JavaCore extends Plugin {
> 	public static final String CORE_JAVA_BUILD_ORDER = PLUGIN_ID + ".computeJavaBuildOrder"; //$NON-NLS-1$
> 	/**
> 	 * Core option ID: Specifying Filters for Resource Copying Control.
>-	 * Allow to specify some filters to control the resource copy process.
>+	 * Allow to specify some filters to control the resource copy process.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.builder.resourceCopyExclusionFilter"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "&lt;name&gt;[,&lt;name&gt;]* }</code> where <code>&lt;name&gt;</code> is a file name pattern (* and ? wild-cards allowed)
>@@ -2017,7 +2014,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Core option ID: Reporting Duplicate Resources.
> 	 * Indicate the severity of the problem reported when more than one occurrence
>-	 * of a resource is to be copied into the output location.
>+	 * of a resource is to be copied into the output location.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.builder.duplicateResourceTask"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning" }</code></dd>
>@@ -2030,7 +2027,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Core option ID: Cleaning Output Folder(s).
> 	 * Indicate whether the JavaBuilder is allowed to clean the output folders
>-	 * when performing full build operations.
>+	 * when performing full build operations.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.builder.cleanOutputFolder"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "clean", "ignore" }</code></dd>
>@@ -2046,7 +2043,7 @@ public final class JavaCore extends Plugin {
> 	 * in the output folders while performing incremental build operations. If changes
> 	 * are detected to managed .class files, then a full build is performed, otherwise
> 	 * the changes are left as is. Tools further altering generated .class files, like optimizers,
>-	 * should ensure this option remains set in its default state of ignore.
>+	 * should ensure this option remains set in its default state of ignore.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.builder.recreateModifiedClassFileInOutputFolder"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "ignore" }</code></dd>
>@@ -2059,7 +2056,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Core option ID: Reporting Incomplete Classpath.
> 	 * Indicate the severity of the problem reported when an entry on the classpath does not exist,
>-	 * is not legite or is not visible (for example, a referenced project is closed).
>+	 * is not legitimate or is not visible (for example, a referenced project is closed).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.incompleteClasspath"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning"}</code></dd>
>@@ -2071,7 +2068,7 @@ public final class JavaCore extends Plugin {
> 	public static final String CORE_INCOMPLETE_CLASSPATH = PLUGIN_ID + ".incompleteClasspath"; //$NON-NLS-1$
> 	/**
> 	 * Core option ID: Reporting Classpath Cycle.
>-	 * Indicate the severity of the problem reported when a project is involved in a cycle.
>+	 * Indicate the severity of the problem reported when a project is involved in a cycle.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.circularClasspath"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning" }</code></dd>
>@@ -2084,7 +2081,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Core option ID: Reporting Incompatible JDK Level for Required Binaries.
> 	 * Indicate the severity of the problem reported when a project prerequisites another project
>-	 * or library with an incompatible target JDK level (e.g. project targeting 1.1 vm, but compiled against 1.4 libraries).
>+	 * or library with an incompatible target JDK level (e.g. project targeting 1.1 vm, but compiled against 1.4 libraries).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.incompatibleJDKLevel"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "error", "warning", "ignore" }</code></dd>
>@@ -2096,7 +2093,7 @@ public final class JavaCore extends Plugin {
> 	public static final String CORE_INCOMPATIBLE_JDK_LEVEL = PLUGIN_ID + ".incompatibleJDKLevel"; //$NON-NLS-1$
> 	/**
> 	 * Core option ID: Abort if Invalid Classpath.
>-	 * Allow to toggle the builder to abort if the classpath is invalid.
>+	 * Allow to toggle the builder to abort if the classpath is invalid.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.builder.invalidClasspath"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "abort", "ignore" }</code></dd>
>@@ -2109,8 +2106,8 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Core option ID: Default Source Encoding Format.
> 	 * Get the default encoding format of source files. This value is
>-	 * immutable and preset to the result of <code>ResourcesPlugin.getEncoding()</code>.
>-	 * It is offered as a convenience shortcut only.
>+	 * immutable and preset to the result of <code>ResourcesPlugin.getEncoding()</code>.
>+	 * It is offered as a convenience shortcut only.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.encoding"</code></dd>
> 	 * <dt>value:</dt><dd><code>&lt;immutable, platform default value&gt;</code></dd>
>@@ -2122,7 +2119,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Core option ID: Enabling Usage of Classpath Exclusion Patterns.
> 	 * When disabled, no entry on a project classpath can be associated with
>-	 * an exclusion pattern.
>+	 * an exclusion pattern.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.classpath.exclusionPatterns"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -2135,7 +2132,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Core option ID: Enabling Usage of Classpath Multiple Output Locations.
> 	 * When disabled, no entry on a project classpath can be associated with
>-	 * a specific output location, preventing thus usage of multiple output locations.
>+	 * a specific output location, preventing thus usage of multiple output locations.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.classpath.multipleOutputLocations"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -2148,7 +2145,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Core option ID: Reporting an output location overlapping another source location.
> 	 * Indicate the severity of the problem reported when a source entry's output location overlaps another
>-	 * source entry. 
>+	 * source entry.
> 	 * 
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.classpath.outputOverlappingAnotherSource"</code></dd>
>@@ -2160,8 +2157,8 @@ public final class JavaCore extends Plugin {
> 	public static final String CORE_OUTPUT_LOCATION_OVERLAPPING_ANOTHER_SOURCE = PLUGIN_ID + ".classpath.outputOverlappingAnotherSource"; //$NON-NLS-1$
> 	/**
> 	 * Core option ID: Set the timeout value for retrieving the method's parameter names from javadoc.
>-	 * Timeout in milliseconds to retrieve the method's parameter names from javadoc.
>-	 * If the value is <code>0</code>, the parameter names are not fetched and the raw names are returned.
>+	 * Timeout in milliseconds to retrieve the method's parameter names from javadoc.
>+	 * If the value is <code>0</code>, the parameter names are not fetched and the raw names are returned.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.timeoutForParameterNameFromAttachedJavadoc"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>"&lt;n&gt;"</code>, where <code>n</code> is an integer greater than or equal to <code>0</code></dd>
>@@ -2243,7 +2240,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Activate Visibility Sensitive Completion.
> 	 * When active, completion doesn't show that you can not see
>-	 * (for example, you can not see private methods of a super class).
>+	 * (for example, you can not see private methods of a super class).
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.visibilityCheck"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -2255,7 +2252,7 @@ public final class JavaCore extends Plugin {
> 	public static final String CODEASSIST_VISIBILITY_CHECK = PLUGIN_ID + ".codeComplete.visibilityCheck"; //$NON-NLS-1$
> 	/**
> 	 * Code assist option ID: Activate Deprecation Sensitive Completion.
>-	 * When enabled, completion doesn't propose deprecated members and types.
>+	 * When enabled, completion doesn't propose deprecated members and types.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.deprecationCheck"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -2268,7 +2265,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Activate Camel Case Sensitive Completion.
> 	 * When enabled, completion shows proposals whose name match the CamelCase
>-	 * pattern.
>+	 * pattern.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.camelCaseMatch"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -2281,7 +2278,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Automatic Qualification of Implicit Members.
> 	 * When active, completion automatically qualifies completion on implicit
>-	 * field references and message expressions.
>+	 * field references and message expressions.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.forceImplicitQualification"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -2294,7 +2291,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Define the Prefixes for Field Name.
> 	 * When the prefixes is non empty, completion for field name will begin with
>-	 * one of the proposed prefixes.
>+	 * one of the proposed prefixes.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.fieldPrefixes"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "&lt;prefix&gt;[,&lt;prefix&gt;]*" }</code> where <code>&lt;prefix&gt;</code> is a String without any wild-card</dd>
>@@ -2307,7 +2304,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Define the Prefixes for Static Field Name.
> 	 * When the prefixes is non empty, completion for static field name will begin with
>-	 * one of the proposed prefixes.
>+	 * one of the proposed prefixes.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.staticFieldPrefixes"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "&lt;prefix&gt;[,&lt;prefix&gt;]*" }</code> where <code>&lt;prefix&gt;</code> is a String without any wild-card</dd>
>@@ -2320,7 +2317,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Define the Prefixes for Static Final Field Name.
> 	 * When the prefixes is non empty, completion for static final field name will begin with
>-	 * one of the proposed prefixes.
>+	 * one of the proposed prefixes.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.staticFinalFieldPrefixes"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "&lt;prefix&gt;[,&lt;prefix&gt;]*" }</code> where <code>&lt;prefix&gt;</code> is a String without any wild-card</dd>
>@@ -2333,7 +2330,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Define the Prefixes for Local Variable Name.
> 	 * When the prefixes is non empty, completion for local variable name will begin with
>-	 * one of the proposed prefixes.
>+	 * one of the proposed prefixes.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.localPrefixes"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "&lt;prefix&gt;[,&lt;prefix&gt;]*" }</code> where <code>&lt;prefix&gt;</code> is a String without any wild-card</dd>
>@@ -2346,7 +2343,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Define the Prefixes for Argument Name.
> 	 * When the prefixes is non empty, completion for argument name will begin with
>-	 * one of the proposed prefixes.
>+	 * one of the proposed prefixes.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.argumentPrefixes"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "&lt;prefix&gt;[,&lt;prefix&gt;]*" }</code> where <code>&lt;prefix&gt;</code> is a String without any wild-card</dd>
>@@ -2359,7 +2356,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Define the Suffixes for Field Name.
> 	 * When the suffixes is non empty, completion for field name will end with
>-	 * one of the proposed suffixes.
>+	 * one of the proposed suffixes.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.fieldSuffixes"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "&lt;suffix&gt;[,&lt;suffix&gt;]*" }</code> where <code>&lt;suffix&gt;</code> is a String without any wild-card</dd>
>@@ -2372,7 +2369,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Define the Suffixes for Static Field Name.
> 	 * When the suffixes is non empty, completion for static field name will end with
>-	 * one of the proposed suffixes.
>+	 * one of the proposed suffixes.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.staticFieldSuffixes"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "&lt;suffix&gt;[,&lt;suffix&gt;]*" }</code>< where <code>&lt;suffix&gt;</code> is a String without any wild-card</dd>
>@@ -2385,7 +2382,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Define the Suffixes for Static Final Field Name.
> 	 * When the suffixes is non empty, completion for static final field name will end with
>-	 * one of the proposed suffixes.
>+	 * one of the proposed suffixes.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.staticFinalFieldSuffixes"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "&lt;suffix&gt;[,&lt;suffix&gt;]*" }</code>< where <code>&lt;suffix&gt;</code> is a String without any wild-card</dd>
>@@ -2398,7 +2395,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Define the Suffixes for Local Variable Name.
> 	 * When the suffixes is non empty, completion for local variable name will end with
>-	 * one of the proposed suffixes.
>+	 * one of the proposed suffixes.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.localSuffixes"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "&lt;suffix&gt;[,&lt;suffix&gt;]*" }</code> where <code>&lt;suffix&gt;</code> is a String without any wild-card</dd>
>@@ -2411,7 +2408,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Define the Suffixes for Argument Name.
> 	 * When the suffixes is non empty, completion for argument name will end with
>-	 * one of the proposed suffixes.
>+	 * one of the proposed suffixes.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.argumentSuffixes"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "&lt;suffix&gt;[,&lt;suffix&gt;]*" }</code> where <code>&lt;suffix&gt;</code> is a String without any wild-card</dd>
>@@ -2424,7 +2421,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Activate Forbidden Reference Sensitive Completion.
> 	 * When enabled, completion doesn't propose elements which match a
>- 	 * forbidden reference rule.
>+	 * forbidden reference rule.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.forbiddenReferenceCheck"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -2437,7 +2434,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Activate Discouraged Reference Sensitive Completion.
> 	 * When enabled, completion doesn't propose elements which match a
>- 	 * discouraged reference rule.
>+	 * discouraged reference rule.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.discouragedReferenceCheck"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -2450,7 +2447,7 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Code assist option ID: Activate Suggestion of Static Import.
> 	 * When enabled, completion proposals can contain static import
>-	 * pattern.
>+	 * pattern.
> 	 * <dl>
> 	 * <dt>Option id:</dt><dd><code>"org.eclipse.jdt.core.codeComplete.suggestStaticImports"</code></dd>
> 	 * <dt>Possible values:</dt><dd><code>{ "enabled", "disabled" }</code></dd>
>@@ -2739,11 +2736,14 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Adds the given listener for changes to Java elements.
> 	 * Has no effect if an identical listener is already registered.
>-	 *
>+	 * 
> 	 * This listener will only be notified during the POST_CHANGE resource change notification
> 	 * and any reconcile operation (POST_RECONCILE).
>+	 * 
>+	 * 
> 	 * For finer control of the notification, use <code>addElementChangedListener(IElementChangedListener,int)</code>,
> 	 * which allows to specify a different eventMask.
>+	 * 
> 	 *
> 	 * @param listener the listener
> 	 * @see ElementChangedEvent
>@@ -2854,6 +2854,7 @@ public final class JavaCore extends Plugin {
> 	 * 
> 	 * 
> 	 * Supported event types are:
>+	 * 
> 	 * <ul>
> 	 * <li>{@link IResourceChangeEvent#PRE_BUILD}</li>
> 	 * <li>{@link IResourceChangeEvent#POST_BUILD}</li>
>@@ -2862,7 +2863,6 @@ public final class JavaCore extends Plugin {
> 	 * <li>{@link IResourceChangeEvent#PRE_CLOSE}</li>
> 	 * </ul>
> 	 * This list may increase in the future.
>-	 * 
> 	 *
> 	 * @param listener the listener
> 	 * @param eventMask the bit-wise OR of all event types of interest to the
>@@ -2933,7 +2933,8 @@ public final class JavaCore extends Plugin {
> 	 * <code>null</code> if unable to associate the given file
> 	 * with a Java element.
> 	 *
>-	 * The file must be one of:<ul>
>+	 * The file must be one of:
>+	 *	<ul>
> 	 *	<li>a file with one of the {@link JavaCore#getJavaLikeExtensions()
> 	 * Java-like extensions} - the element returned is the corresponding <code>ICompilationUnit</code></li>
> 	 *	<li>a <code>.class</code> file - the element returned is the corresponding <code>IClassFile</code></li>
>@@ -2942,6 +2943,7 @@ public final class JavaCore extends Plugin {
> 	 * 
> 	 * Creating a Java element has the side effect of creating and opening all of the
> 	 * element's parents if they are not yet open.
>+	 * 
> 	 *
> 	 * @param file the given file
> 	 * @return the Java element corresponding to the given file, or
>@@ -2956,9 +2958,11 @@ public final class JavaCore extends Plugin {
> 	 * <code>null</code> if unable to associate the given folder with a Java element.
> 	 * 
> 	 * Note that a package fragment root is returned rather than a default package.
>+	 * 
> 	 * 
> 	 * Creating a Java element has the side effect of creating and opening all of the
> 	 * element's parents if they are not yet open.
>+	 * 
> 	 *
> 	 * @param folder the given folder
> 	 * @return the package fragment or package fragment root corresponding to the given folder, or
>@@ -2972,8 +2976,10 @@ public final class JavaCore extends Plugin {
> 	 * 
> 	 * Creating a Java Project has the side effect of creating and opening all of the
> 	 * project's parents if they are not yet open.
>+	 * 
> 	 * 
> 	 * Note that no check is done at this time on the existence or the java nature of this project.
>+	 * 
> 	 *
> 	 * @param project the given project
> 	 * @return the Java project corresponding to the given project, null if the given project is null
>@@ -2990,7 +2996,9 @@ public final class JavaCore extends Plugin {
> 	 * <code>null</code> if unable to associate the given resource
> 	 * with a Java element.
> 	 * 
>-	 * The resource must be one of:<ul>
>+	 * The resource must be one of:
>+	 * 
>+	 *	<ul>
> 	 *	<li>a project - the element returned is the corresponding <code>IJavaProject</code></li>
> 	 *	<li>a file with one of the {@link JavaCore#getJavaLikeExtensions()
> 	 * Java-like extensions} - the element returned is the corresponding <code>ICompilationUnit</code></li>
>@@ -3003,6 +3011,7 @@ public final class JavaCore extends Plugin {
> 	 * 
> 	 * Creating a Java element has the side effect of creating and opening all of the
> 	 * element's parents if they are not yet open.
>+	 * 
> 	 *
> 	 * @param resource the given resource
> 	 * @return the Java element corresponding to the given resource, or
>@@ -3016,8 +3025,10 @@ public final class JavaCore extends Plugin {
> 	 * Returns the Java element corresponding to the given file, its project being the given
> 	 * project. Returns <code>null</code> if unable to associate the given resource
> 	 * with a Java element.
>-	 *
>-	 * The resource must be one of:<ul>
>+	 * 
>+	 * The resource must be one of:
>+	 * 
>+	 *	<ul>
> 	 *	<li>a project - the element returned is the corresponding <code>IJavaProject</code></li>
> 	 *	<li>a file with one of the {@link JavaCore#getJavaLikeExtensions()
> 	 * Java-like extensions} - the element returned is the corresponding <code>ICompilationUnit</code></li>
>@@ -3030,6 +3041,7 @@ public final class JavaCore extends Plugin {
> 	 * 
> 	 * Creating a Java element has the side effect of creating and opening all of the
> 	 * element's parents if they are not yet open.
>+	 * 
> 	 *
> 	 * @param resource the given resource
> 	 * @return the Java element corresponding to the given file, or
>@@ -3100,16 +3112,19 @@ public final class JavaCore extends Plugin {
> 	 * onto this project (using <code>setClasspathContainer</code>, then a
> 	 * <code>ClasspathContainerInitializer</code> will be activated if any was registered for this container
> 	 * ID onto the extension point "org.eclipse.jdt.core.classpathContainerInitializer".
>+	 * 
> 	 * 
> 	 * There is no assumption that the returned container must answer the exact same containerPath
> 	 * when requested <code>IClasspathContainer#getPath</code>.
> 	 * Indeed, the containerPath is just an indication for resolving it to an actual container object.
>+	 * 
> 	 * 
> 	 * Classpath container values are persisted locally to the workspace, but
> 	 * are not preserved from a session to another. It is thus highly recommended to register a
> 	 * <code>ClasspathContainerInitializer</code> for each referenced container
> 	 * (through the extension point "org.eclipse.jdt.core.ClasspathContainerInitializer").
>-	 * 
>+	 * 
>+	 *
> 	 * @param containerPath the name of the container, which needs to be resolved
> 	 * @param project a specific project in which the container is being resolved
> 	 * @return the corresponding classpath container or <code>null</code> if unable to find one.
>@@ -3124,10 +3139,10 @@ public final class JavaCore extends Plugin {
> 	 */
> 	public static IClasspathContainer getClasspathContainer(IPath containerPath, IJavaProject project) throws JavaModelException {
> 
>-	 JavaModelManager manager = JavaModelManager.getJavaModelManager();
>+		JavaModelManager manager = JavaModelManager.getJavaModelManager();
> 		IClasspathContainer container = manager.getClasspathContainer(containerPath, project);
> 		if (container == JavaModelManager.CONTAINER_INITIALIZATION_IN_PROGRESS) {
>-		 return manager.getPreviousSessionContainer(containerPath, project);
>+			return manager.getPreviousSessionContainer(containerPath, project);
> 		}
> 		return container;
> 	}
>@@ -3138,7 +3153,7 @@ public final class JavaCore extends Plugin {
> 	 * the extension point "org.eclipse.jdt.core.classpathContainerInitializer".
> 	 * 
> 	 * A containerID is the first segment of any container path, used to identify the registered container initializer.
>-	 * 
>+	 * 
> 	 * @param containerID - a containerID identifying a registered initializer
> 	 * @return ClasspathContainerInitializer - the registered classpath container initializer or <code>null</code> if
> 	 * none was found.
>@@ -3211,12 +3226,14 @@ public final class JavaCore extends Plugin {
> 	 * 
> 	 * Classpath variable values are persisted locally to the workspace, and
> 	 * are preserved from session to session.
>+	 * 
> 	 * 
> 	 * Note that classpath variables can be contributed registered initializers for,
> 	 * using the extension point "org.eclipse.jdt.core.classpathVariableInitializer".
> 	 * If an initializer is registered for a variable, its persisted value will be ignored:
> 	 * its initializer will thus get the opportunity to rebind the variable differently on
> 	 * each session.
>+	 * 
> 	 *
> 	 * @param variableName the name of the classpath variable
> 	 * @return the path, or <code>null</code> if none
>@@ -3224,10 +3241,10 @@ public final class JavaCore extends Plugin {
> 	 */
> 	public static IPath getClasspathVariable(final String variableName) {
> 
>-	 JavaModelManager manager = JavaModelManager.getJavaModelManager();
>+		JavaModelManager manager = JavaModelManager.getJavaModelManager();
> 		IPath variablePath = manager.variableGet(variableName);
> 		if (variablePath == JavaModelManager.VARIABLE_INITIALIZATION_IN_PROGRESS){
>-		 return manager.getPreviousSessionVariable(variableName);
>+			return manager.getPreviousSessionVariable(variableName);
> 		}
> 
> 		if (variablePath != null) {
>@@ -3309,15 +3326,15 @@ public final class JavaCore extends Plugin {
> 	 * @since 3.3
> 	 */
> 	public static String getClasspathVariableDeprecationMessage(String variableName) {
>-	 JavaModelManager manager = JavaModelManager.getJavaModelManager();
>+		JavaModelManager manager = JavaModelManager.getJavaModelManager();
> 
> 		// Returns the stored deprecation message
> 		String message = (String) manager.deprecatedVariables.get(variableName);
> 		if (message != null) {
>-		 return message;
>+			return message;
> 		}
> 
>-	 // If the variable has been already initialized, then there's no deprecation message
>+		// If the variable has been already initialized, then there's no deprecation message
> 		IPath variablePath = manager.variableGet(variableName);
> 		if (variablePath != null && variablePath != JavaModelManager.VARIABLE_INITIALIZATION_IN_PROGRESS) {
> 			return null;
>@@ -3351,7 +3368,7 @@ public final class JavaCore extends Plugin {
> 	 * Helper method finding the classpath variable initializer registered for a given classpath variable name
> 	 * or <code>null</code> if none was found while iterating over the contributions to extension point to
> 	 * the extension point "org.eclipse.jdt.core.classpathVariableInitializer".
>-	 * 
>+	 *
> 	 * @param variable the given variable
> 	 * @return ClasspathVariableInitializer - the registered classpath variable initializer or <code>null</code> if
> 	 * none was found.
>@@ -3421,7 +3438,7 @@ public final class JavaCore extends Plugin {
> 	 * 
> 	 * Classpath variable values are persisted locally to the workspace, and
> 	 * are preserved from session to session.
>-	 * 
>+	 * 
> 	 *
> 	 * @return the list of classpath variable names
> 	 * @see #setClasspathVariable(String, IPath)
>@@ -3440,8 +3457,10 @@ public final class JavaCore extends Plugin {
> 	 * (categorized in Code assist option ID, Compiler option ID and Core option ID)
> 	 * and some of their acceptable values (categorized in Option value). Some
> 	 * options accept open value sets beyond the documented constant values.
>+	 * 
> 	 * 
> 	 * Note: each release may add new options.
>+	 * 
> 	 *
> 	 * @return a table of all known configurable options with their default values
> 	 */
>@@ -3676,8 +3695,10 @@ public final class JavaCore extends Plugin {
> 	 * Returns the list of known Java-like extensions.
> 	 * Java like extension are defined in the {@link org.eclipse.core.runtime.Platform#getContentTypeManager()
> 	 * content type manager} for the {@link #JAVA_SOURCE_CONTENT_TYPE}.
>+	 * 
> 	 * Note that a Java-like extension doesn't include the leading dot ('.').
> 	 * Also note that the "java" extension is always defined as a Java-like extension.
>+	 * 
> 	 *
> 	 * @return the list of known Java-like extensions.
> 	 * @since 3.2
>@@ -3694,8 +3715,10 @@ public final class JavaCore extends Plugin {
> 	 * (categorized in Code assist option ID, Compiler option ID and Core option ID)
> 	 * and some of their acceptable values (categorized in Option value). Some
> 	 * options accept open value sets beyond the documented constant values.
>+	 * 
> 	 * 
> 	 * Note: each release may add new options.
>+	 * 
> 	 *
> 	 * @param optionName the name of an option
> 	 * @return the String value of a given option
>@@ -3734,8 +3757,10 @@ public final class JavaCore extends Plugin {
> 	 * (categorized in Code assist option ID, Compiler option ID and Core option ID)
> 	 * and some of their acceptable values (categorized in Option value). Some
> 	 * options accept open value sets beyond the documented constant values.
>+	 * 
> 	 * 
> 	 * Note: each release may add new options.
>+	 * 
> 	 * Returns a default set of options even if the platform is not running.
> 	 *
> 	 * @return table of current settings of all options
>@@ -3769,10 +3794,11 @@ public final class JavaCore extends Plugin {
> 	 * </ul>
> 	 * 
> 	 * Variable source attachment path and root path are also resolved and recorded in the resulting classpath entry.
>+	 * 
> 	 * 
> 	 * NOTE: This helper method does not handle classpath containers, for which should rather be used
> 	 * <code>JavaCore#getClasspathContainer(IPath, IJavaProject)</code>.
>-	 * 
>+	 * 
> 	 *
> 	 * @param entry the given variable entry
> 	 * @return the resolved library or project classpath entry, or <code>null</code>
>@@ -3850,7 +3876,7 @@ public final class JavaCore extends Plugin {
> 	 * overhead on user actions, if it can be performed before at some
> 	 * appropriate moment.
> 	 * 
>-	 * This initialization runs accross all Java projects in the workspace. Thus the
>+	 * This initialization runs across all Java projects in the workspace. Thus the
> 	 * workspace root scheduling rule is used during this operation.
> 	 * 
> 	 * This method may return before the initialization is complete. The
>@@ -3950,7 +3976,7 @@ public final class JavaCore extends Plugin {
> 			// initialize delta state
> 			if (monitor != null)
> 				monitor.subTask(Messages.javamodel_initializing_delta_state);
>-			manager.deltaState.rootsAreStale = true; // in case it was already initialized before we cleaned up the source attachment proprties
>+			manager.deltaState.rootsAreStale = true; // in case it was already initialized before we cleaned up the source attachment properties
> 			manager.deltaState.initializeRoots(true/*initAfteLoad*/);
> 
> 			// dummy query for waiting until the indexes are ready
>@@ -4196,7 +4222,7 @@ public final class JavaCore extends Plugin {
> 	 * for the given path. This method is fully equivalent to calling
> 	 * {@link #newContainerEntry(IPath, IAccessRule[], IClasspathAttribute[], boolean)
> 	 * newContainerEntry(containerPath, new IAccessRule[0], new IClasspathAttribute[0], false)}.
>-	 * 
>+	 *
> 	 * @param containerPath the path identifying the container, it must be formed of two
> 	 * 	segments
> 	 * @return a new container classpath entry
>@@ -4245,11 +4271,15 @@ public final class JavaCore extends Plugin {
> 	 * which can be interpreted differently for each Java project where it is used.
> 	 * A classpath container entry can be resolved using <code>JavaCore.getResolvedClasspathContainer</code>,
> 	 * and updated with <code>JavaCore.classpathContainerChanged</code>
>+	 * 
> 	 * 
> 	 * A container is exclusively resolved by a <code>ClasspathContainerInitializer</code> registered onto the
> 	 * extension point "org.eclipse.jdt.core.classpathContainerInitializer".
>+	 * 
> 	 * 
>-	 * A container path must be formed of at least one segment, where: <ul>
>+	 * A container path must be formed of at least one segment, where:
>+	 * 
>+	 * <ul>
> 	 * <li> the first segment is a unique ID identifying the target container, there must be a container initializer registered
> 	 * 	onto this ID through the extension point "org.eclipse.jdt.core.classpathContainerInitializer". </li>
> 	 * <li> the remaining segments will be passed onto the initializer, and can be used as additional
>@@ -4257,6 +4287,7 @@ public final class JavaCore extends Plugin {
> 	 * </ul>
> 	 * 
> 	 * Example of an ClasspathContainerInitializer for a classpath container denoting a default JDK container:
>+	 * 
> 	 * <pre>
> 	 * containerEntry = JavaCore.newContainerEntry(new Path("MyProvidedJDK/default"));
> 	 *
>@@ -4348,7 +4379,7 @@ public final class JavaCore extends Plugin {
> 	 * 
> 	 * Note that if a working copy is empty, it will be as if the original compilation
> 	 * unit had been deleted.
>-	 * 
>+	 * 
> 	 *
> 	 * @param monitor the given progress monitor
> 	 * @param region the given region
>@@ -4407,9 +4438,11 @@ public final class JavaCore extends Plugin {
> 	 * Creates and returns a new classpath entry of kind <code>CPE_LIBRARY</code> for the JAR or folder
> 	 * identified by the given absolute path. This specifies that all package fragments within the root
> 	 * will have children of type <code>IClassFile</code>.
>+	 * 
> 	 * This method is fully equivalent to calling
> 	 * {@link #newLibraryEntry(IPath, IPath, IPath, IAccessRule[], IClasspathAttribute[], boolean)
> 	 * newLibraryEntry(path, sourceAttachmentPath, sourceAttachmentRootPath, new IAccessRule[0], new IClasspathAttribute[0], isExported)}.
>+	 * 
> 	 *
> 	 * @param path the path to the library
> 	 * @param sourceAttachmentPath the absolute path of the corresponding source archive or folder,
>@@ -4449,13 +4482,16 @@ public final class JavaCore extends Plugin {
> 	 * The target root folder can also be defined internally to the workspace (absolute path relative
> 	 * to the workspace root), or - since 3.4 - externally to the workspace (absolute path in the file system).
> 	 * Since 3.5, the path to the library can also be relative to the project using ".." as the first segment. 
>+	 * 
> 	 * 
>-	 * e.g. Here are some examples of binary path usage<ul>
>+	 * e.g. Here are some examples of binary path usage
>+	 * 
>+	 *	<ul>
> 	 *	<li><code> "c:\jdk1.2.2\jre\lib\rt.jar" </code> - reference to an external JAR on Windows</li>
> 	 *	<li><code> "/Project/someLib.jar" </code> - reference to an internal JAR on Windows or Linux</li>
> 	 *	<li><code> "/Project/classes/" </code> - reference to an internal binary folder on Windows or Linux</li>
> 	 *	<li><code> "/home/usr/classes" </code> - reference to an external binary folder on Linux</li>
>-	 *	<li><code> "../../lib/someLib.jar" </code> - reference to an external JAR that is a sibbling of the workspace on either platform</li>
>+	 *	<li><code> "../../lib/someLib.jar" </code> - reference to an external JAR that is a sibling of the workspace on either platform</li>
> 	 * </ul>
> 	 * Note that on non-Windows platform, a path <code>"/some/lib.jar"</code> is ambiguous.
> 	 * It can be a path to an external JAR (its file system path being <code>"/some/lib.jar"</code>)
>@@ -4485,7 +4521,7 @@ public final class JavaCore extends Plugin {
> 	 * with the non accessible files patterns of the project.
> 	 * 
> 	 * 
>-	 * Since 3.5, if the libray is a ZIP archive, the "Class-Path" clause (if any) in the "META-INF/MANIFEST.MF" is read
>+	 * Since 3.5, if the library is a ZIP archive, the "Class-Path" clause (if any) in the "META-INF/MANIFEST.MF" is read
> 	 * and referenced ZIP archives are added to the {@link IJavaProject#getResolvedClasspath(boolean) resolved classpath}.
> 	 * 
> 	 *
>@@ -4547,9 +4583,11 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Creates and returns a new non-exported classpath entry of kind <code>CPE_PROJECT</code>
> 	 * for the project identified by the given absolute path.
>+	 * 
> 	 * This method is fully equivalent to calling
> 	 * {@link #newProjectEntry(IPath, IAccessRule[], boolean, IClasspathAttribute[], boolean)
> 	 * newProjectEntry(path, new IAccessRule[0], true, new IClasspathAttribute[0], false)}.
>+	 * 
> 	 *
> 	 * @param path the absolute path of the binary archive
> 	 * @return a new project classpath entry
>@@ -4561,9 +4599,11 @@ public final class JavaCore extends Plugin {
> 	/**
> 	 * Creates and returns a new classpath entry of kind <code>CPE_PROJECT</code>
> 	 * for the project identified by the given absolute path.
>+	 * 
> 	 * This method is fully equivalent to calling
> 	 * {@link #newProjectEntry(IPath, IAccessRule[], boolean, IClasspathAttribute[], boolean)
> 	 * newProjectEntry(path, new IAccessRule[0], true, new IClasspathAttribute[0], isExported)}.
>+	 * 
> 	 *
> 	 * @param path the absolute path of the prerequisite project
> 	 * @param isExported indicates whether this entry is contributed to dependent
>@@ -4675,10 +4715,10 @@ public final class JavaCore extends Plugin {
> 	 * absolute workspace-relative path.
> 	 * 
> 	 * The convenience method is fully equivalent to:
>+	 * 
> 	 * <pre>
> 	 * newSourceEntry(path, new IPath[] {}, new IPath[] {}, null);
> 	 * </pre>
>-	 * 
> 	 *
> 	 * @param path the absolute workspace-relative path of a source folder
> 	 * @return a new source classpath entry
>@@ -4696,10 +4736,10 @@ public final class JavaCore extends Plugin {
> 	 * matching any of the given patterns.
> 	 * 
> 	 * The convenience method is fully equivalent to:
>+	 * 
> 	 * <pre>
> 	 * newSourceEntry(path, new IPath[] {}, exclusionPatterns, null);
> 	 * </pre>
>-	 * 
> 	 *
> 	 * @param path the absolute workspace-relative path of a source folder
> 	 * @param exclusionPatterns the possibly empty list of exclusion patterns
>@@ -4721,22 +4761,22 @@ public final class JavaCore extends Plugin {
> 	 * (that is, ".class" files are not going to the project default output location).
> 	 * 
> 	 * The convenience method is fully equivalent to:
>+	 * 
> 	 * <pre>
> 	 * newSourceEntry(path, new IPath[] {}, exclusionPatterns, specificOutputLocation);
> 	 * </pre>
>-	 * 
> 	 *
> 	 * @param path the absolute workspace-relative path of a source folder
> 	 * @param exclusionPatterns the possibly empty list of exclusion patterns
> 	 * represented as relative paths
>-	 * @param specificOutputLocation the specific output location for this source entry (<code>null</code> if using project default ouput location)
>+	 * @param specificOutputLocation the specific output location for this source entry (<code>null</code> if using project default output location)
> 	 * @return a new source classpath entry
> 	 * @see #newSourceEntry(IPath, IPath[], IPath[], IPath)
> 	 * @since 2.1
> 	 */
> 	public static IClasspathEntry newSourceEntry(IPath path, IPath[] exclusionPatterns, IPath specificOutputLocation) {
> 
>-	 return newSourceEntry(path, ClasspathEntry.INCLUDE_ALL, exclusionPatterns, specificOutputLocation);
>+		return newSourceEntry(path, ClasspathEntry.INCLUDE_ALL, exclusionPatterns, specificOutputLocation);
> 	}
> 
> 	/**
>@@ -4747,17 +4787,17 @@ public final class JavaCore extends Plugin {
> 	 * (that is, ".class" files are not going to the project default output location).
> 	 * 
> 	 * The convenience method is fully equivalent to:
>+	 * 
> 	 * <pre>
> 	 * newSourceEntry(path, new IPath[] {}, exclusionPatterns, specificOutputLocation, new IClasspathAttribute[] {});
> 	 * </pre>
>-	 * 
> 	 *
> 	 * @param path the absolute workspace-relative path of a source folder
> 	 * @param inclusionPatterns the possibly empty list of inclusion patterns
> 	 * represented as relative paths
> 	 * @param exclusionPatterns the possibly empty list of exclusion patterns
> 	 * represented as relative paths
>-	 * @param specificOutputLocation the specific output location for this source entry (<code>null</code> if using project default ouput location)
>+	 * @param specificOutputLocation the specific output location for this source entry (<code>null</code> if using project default output location)
> 	 * @return a new source classpath entry
> 	 * @see #newSourceEntry(IPath, IPath[], IPath[], IPath, IClasspathAttribute[])
> 	 * @since 3.0
>@@ -4783,7 +4823,7 @@ public final class JavaCore extends Plugin {
> 	 * The inclusion patterns determines the initial set of source files that
> 	 * are to be included; the exclusion patterns are then used to reduce this
> 	 * set. When no inclusion patterns are specified, the initial file set
>-	 * includes all relevent files in the resource tree rooted at the source
>+	 * includes all relevant files in the resource tree rooted at the source
> 	 * entry's path. On the other hand, specifying one or more inclusion
> 	 * patterns means that all and only files matching at least one of
> 	 * the specified patterns are to be included. If exclusion patterns are
>@@ -4936,12 +4976,16 @@ public final class JavaCore extends Plugin {
> 	 * 
> 	 * A variable entry allows to express indirect references on a classpath to other projects or libraries,
> 	 * depending on what the classpath variable is referring.
>+	 * 
> 	 * 
>-	 *	It is possible to register an automatic initializer (<code>ClasspathVariableInitializer</code>),
>+	 * It is possible to register an automatic initializer (<code>ClasspathVariableInitializer</code>),
> 	 * which will be invoked through the extension point "org.eclipse.jdt.core.classpathVariableInitializer".
> 	 * After resolution, a classpath variable entry may either correspond to a project or a library entry.
>+	 * 
> 	 * 
>-	 * e.g. Here are some examples of variable path usage<ul>
>+	 * e.g. Here are some examples of variable path usage
>+	 * 
>+	 * <ul>
> 	 * <li> "JDTCORE" where variable <code>JDTCORE</code> is
> 	 *		bound to "c:/jars/jdtcore.jar". The resolved classpath entry is denoting the library "c:\jars\jdtcore.jar"</li>
> 	 * <li> "JDTCORE" where variable <code>JDTCORE</code> is
>@@ -5040,7 +5084,7 @@ public final class JavaCore extends Plugin {
> 	 * 
> 	 * @param libraryEntry the library entry whose referenced entries are sought 
> 	 * @param project project where the persisted referenced entries to be retrieved from. If <code>null</code>
>-	 * 			persisted attributes are not attempted to be retrived.
>+	 * 			persisted attributes are not attempted to be retrieved.
> 	 * @return an array of classpath entries that are referenced directly or indirectly by the given entry. 
> 	 * 			If not applicable, returns an empty array.
> 	 * @since 3.6
>@@ -5049,16 +5093,17 @@ public final class JavaCore extends Plugin {
> 		JavaModelManager manager = JavaModelManager.getJavaModelManager();
> 		return manager.getReferencedClasspathEntries(libraryEntry, project);
> 	}
>-	
>+
> 	/**
> 	 * Removed the given classpath variable. Does nothing if no value was
> 	 * set for this classpath variable.
> 	 * 
> 	 * This functionality cannot be used while the resource tree is locked.
>+	 * 
> 	 * 
> 	 * Classpath variable values are persisted locally to the workspace, and
> 	 * are preserved from session to session.
>-	 * 
>+	 * 
> 	 *
> 	 * @param variableName the name of the classpath variable
> 	 * @see #setClasspathVariable(String, IPath)
>@@ -5074,10 +5119,11 @@ public final class JavaCore extends Plugin {
> 	 * set for this classpath variable.
> 	 * 
> 	 * This functionality cannot be used while the resource tree is locked.
>+	 * 
> 	 * 
> 	 * Classpath variable values are persisted locally to the workspace, and
> 	 * are preserved from session to session.
>-	 * 
>+	 * 
> 	 *
> 	 * @param variableName the name of the classpath variable
> 	 * @param monitor the progress monitor to report progress
>@@ -5119,6 +5165,7 @@ public final class JavaCore extends Plugin {
> 	 * Removes the given pre-processing resource changed listener.
> 	 * 
> 	 * Has no effect if an identical listener is not registered.
>+	 * 
> 	 *
> 	 * @param listener the listener
> 	 * @since 3.0
>@@ -5215,6 +5262,7 @@ public final class JavaCore extends Plugin {
> 	 * is formed by a first ID segment followed with extra segments, which can be used as additional hints
> 	 * for the resolution. The container ID is used to identify a <code>ClasspathContainerInitializer</code>
> 	 * registered on the extension point "org.eclipse.jdt.core.classpathContainerInitializer".
>+	 * 
> 	 * 
> 	 * There is no assumption that each individual container value passed in argument
> 	 * (<code>respectiveContainers</code>) must answer the exact same path when requested
>@@ -5222,24 +5270,28 @@ public final class JavaCore extends Plugin {
> 	 * Indeed, the containerPath is just an indication for resolving it to an actual container object. It can be
> 	 * delegated to a <code>ClasspathContainerInitializer</code>, which can be activated through the extension
> 	 * point "org.eclipse.jdt.core.ClasspathContainerInitializer").
>+	 * 
> 	 * 
> 	 * In reaction to changing container values, the JavaModel will be updated to reflect the new
> 	 * state of the updated container. A combined Java element delta will be notified to describe the corresponding
> 	 * classpath changes resulting from the container update. This operation is batched, and automatically eliminates
> 	 * unnecessary updates (new container is same as old one). This operation acquires a lock on the workspace's root.
>+	 * 
> 	 * 
> 	 * This functionality cannot be used while the workspace is locked, since
> 	 * it may create/remove some resource markers.
>+	 * 
> 	 * 
> 	 * Classpath container values are persisted locally to the workspace, but
> 	 * are not preserved from a session to another. It is thus highly recommended to register a
> 	 * <code>ClasspathContainerInitializer</code> for each referenced container
> 	 * (through the extension point "org.eclipse.jdt.core.ClasspathContainerInitializer").
>+	 * 
> 	 * 
> 	 * Note: setting a container to <code>null</code> will cause it to be lazily resolved again whenever
> 	 * its value is required. In particular, this will cause a registered initializer to be invoked
> 	 * again.
>-	 * 
>+	 * 
> 	 * @param containerPath - the name of the container reference, which is being updated
> 	 * @param affectedProjects - the set of projects for which this container is being bound
> 	 * @param respectiveContainers - the set of respective containers for the affected projects
>@@ -5274,10 +5326,11 @@ public final class JavaCore extends Plugin {
> 	 * The path must have at least one segment.
> 	 * 
> 	 * This functionality cannot be used while the resource tree is locked.
>+	 * 
> 	 * 
> 	 * Classpath variable values are persisted locally to the workspace, and
> 	 * are preserved from session to session.
>-	 * 
>+	 * 
> 	 *
> 	 * @param variableName the name of the classpath variable
> 	 * @param path the path
>@@ -5298,11 +5351,14 @@ public final class JavaCore extends Plugin {
> 	 * Since 3.5, the path to a library can also be relative to the project using ".." as the first segment. 
> 	 * 
> 	 * This functionality cannot be used while the resource tree is locked.
>+	 * 
> 	 * 
> 	 * Classpath variable values are persisted locally to the workspace, and
> 	 * are preserved from session to session.
>+	 * 
> 	 * 
> 	 * Updating a variable with the same value has no effect.
>+	 * 
> 	 *
> 	 * @param variableName the name of the classpath variable
> 	 * @param path the path
>@@ -5329,14 +5385,18 @@ public final class JavaCore extends Plugin {
> 	 * classpath changes resulting from the variables update. This operation is batched,
> 	 * and automatically eliminates unnecessary updates (new variable is same as old one).
> 	 * This operation acquires a lock on the workspace's root.
>+	 * 
> 	 * 
> 	 * This functionality cannot be used while the workspace is locked, since
> 	 * it may create/remove some resource markers.
>+	 * 
> 	 * 
> 	 * Classpath variable values are persisted locally to the workspace, and
> 	 * are preserved from session to session.
>+	 * 
> 	 * 
> 	 * Updating a variable with the same value has no effect.
>+	 * 
> 	 *
> 	 * @param variableNames an array of names for the updated classpath variables
> 	 * @param paths an array of path updates for the modified classpath variables (null
>@@ -5362,7 +5422,7 @@ public final class JavaCore extends Plugin {
> 	 * to the given compliance.
> 	 *
> 	 * The given compliance must be one of those supported by the compiler,
>-	 * that is one of the acceptable values for option {@link #COMPILER_COMPLIANCE}.
>+	 * that is one of the acceptable values for option {@link #COMPILER_COMPLIANCE}.
> 	 *
> 	 * The list of modified options is currently:
> 	 * <ul>
>@@ -5431,7 +5491,7 @@ public final class JavaCore extends Plugin {
> 	 * (categorized in Code assist option ID, Compiler option ID and Core option ID)
> 	 * and some of their acceptable values (categorized in Option value). Some
> 	 * options accept open value sets beyond the documented constant values.
>-	 * 
>+	 * 
> 	 * Note: each release may add new options.
> 	 *
> 	 * @param newOptions
>@@ -5449,7 +5509,7 @@ public final class JavaCore extends Plugin {
> 	 * Shutdown the JavaCore plug-in.
> 	 * 
> 	 * De-registers the JavaModelManager as a resource changed listener and save participant.
>-	 * 
>+	 * 
> 	 * @see org.eclipse.core.runtime.Plugin#stop(BundleContext)
> 	 */
> 	public void stop(BundleContext context) throws Exception {
>@@ -5466,7 +5526,7 @@ public final class JavaCore extends Plugin {
> 	 * 
> 	 * Registers the JavaModelManager as a resource changed listener and save participant.
> 	 * Starts the background indexing, and restore saved classpath variable values.
>-	 * 
>+	 * 
> 	 * @throws Exception
> 	 * @see org.eclipse.core.runtime.Plugin#start(BundleContext)
> 	 */

Actions: View | Diff

Attachments on bug 326514: 218860