- added provisional comments to classes

codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/CodanRuntime.java

@@ -24,6 +24,12 @@ import org.eclipse.cdt.codan.internal.core.model.ProblemLocationFactory;
  * Runtime singleton class to get access to Codan framework parts
  * 
  * Clients may extend this class to override default framework parts.
+ * 
+ * <p>
+ * <strong>EXPERIMENTAL</strong>. This class or interface has been added as
+ * part of a work in progress. There is no guarantee that this API will
+ * work or that it will remain the same.
+ * </p>
  */
 public class CodanRuntime {
 	private static CodanRuntime instance = new CodanRuntime();

codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/PreferenceConstants.java

@@ -12,6 +12,11 @@ package org.eclipse.cdt.codan.core;
 
 /**
  * Constant definitions for plug-in preferences
+ * <p>
+ * <strong>EXPERIMENTAL</strong>. This class or interface has been added as
+ * part of a work in progress. There is no guarantee that this API will
+ * work or that it will remain the same.
+ * </p>
  */
 public class PreferenceConstants {
 	public static final String P_RUN_ON_BUILD = "booleanPreference"; //$NON-NLS-1$

codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/AbstractProblemLocation.java

@@ -16,22 +16,27 @@ import org.eclipse.core.resources.IFile;
  * Abstract Implementation of IProblemLocation
  * 
  * Clients may extend this class.
+ * <p>
+ * <strong>EXPERIMENTAL</strong>. This class or interface has been added as
+ * part of a work in progress. There is no guarantee that this API will
+ * work or that it will remain the same.
+ * </p>
  */
-public abstract class ProblemLocation implements IProblemLocation {
+public abstract class AbstractProblemLocation implements IProblemLocation {
 	protected IFile file;
 	protected int line;
 	protected int posStart;
 	protected int posEnd;
 	protected Object extra;
 
-	protected ProblemLocation(IFile file, int line) {
+	protected AbstractProblemLocation(IFile file, int line) {
 		this.file = file;
 		this.line = line;
 		this.posStart = -1;
 		this.posEnd = -1;
 	}
 
-	protected ProblemLocation(IFile file, int startChar, int endChar) {
+	protected AbstractProblemLocation(IFile file, int startChar, int endChar) {
 		this.file = file;
 		this.line = -1;
 		this.posStart = startChar;

codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/ICAstChecker.java

@@ -17,6 +17,12 @@ import org.eclipse.cdt.core.dom.ast.IASTTranslationUnit;
  * Default implementation {@link AbstractIndexAstChecker}
  * 
  * Clients may implement and extend this interface.
+ * 
+ * <p>
+ * <strong>EXPERIMENTAL</strong>. This class or interface has been added as
+ * part of a work in progress. There is no guarantee that this API will
+ * work or that it will remain the same.
+ * </p>
  */
 public interface ICAstChecker extends IChecker {
 	/**

codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/ICIndexChecker.java

@@ -17,6 +17,11 @@ import org.eclipse.cdt.core.model.ITranslationUnit;
  * Default implementation {@link AbstractCIndexChecker}
  * 
  * Client may implement this interface.
+ * <p>
+ * <strong>EXPERIMENTAL</strong>. This class or interface has been added as
+ * part of a work in progress. There is no guarantee that this API will
+ * work or that it will remain the same.
+ * </p>
  */
 public interface ICIndexChecker extends IChecker {
 	/**

codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/IChecker.java

@@ -16,6 +16,15 @@ import org.eclipse.core.resources.IResource;
  * Interface that checker must implement. CDT Checker must be able to process a resource.
  * 
  * Clients may implement and extend this interface.
+ * 
+ * <p>
+ * <strong>EXPERIMENTAL</strong>. This class or interface has been added as
+ * part of a work in progress. There is no guarantee that this API will
+ * work or that it will remain the same.
+ * </p>
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients. Extend AbstractChecker class instead.
  */
 public interface IChecker {
 	/**

codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/ICheckerWithParameters.java

@@ -15,6 +15,8 @@ package org.eclipse.cdt.codan.core.model;
  * interface method would be called on initialization so checker has
  * a chance to set default values for its parameters
  * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ICheckerWithParameters {
 	/**

codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/ICheckersRegistry.java

@@ -18,6 +18,9 @@ import org.eclipse.core.resources.IResource;
  * This interface an API to add/remove checker and problems programmatically,
  * get problem profiles and change problem default settings
  * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ * 
  */
 public interface ICheckersRegistry extends Iterable<IChecker> {
 	/**

codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/IProblem.java

@@ -18,6 +18,11 @@ package org.eclipse.cdt.codan.core.model;
  * be created (i.e. one for error and one for warning).
  *   
  * Clients may implement and extend this interface.
+ * <p>
+* <strong>EXPERIMENTAL</strong>. This class or interface has been added as
+* part of a work in progress. There is no guarantee that this API will
+* work or that it will remain the same.
+* </p>
  * 
  */
 public interface IProblem extends IProblemElement {

codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/IProblemCategory.java

@@ -12,7 +12,11 @@ package org.eclipse.cdt.codan.core.model;
 
 /**
  * Problem category.
- * 
+ * <p>
+* <strong>EXPERIMENTAL</strong>. This class or interface has been added as
+* part of a work in progress. There is no guarantee that this API will
+* work or that it will remain the same.
+* </p>
  * Clients may extend and implement this interface.
  */
 public interface IProblemCategory extends IProblemElement {

codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/IProblemLocationFactory.java

@@ -16,6 +16,11 @@ import org.eclipse.core.resources.IFile;
  * Factory interface that allows to create problem locations.
  *
  * Clients may implement and extend this interface.
+ * <p>
+ * <strong>EXPERIMENTAL</strong>. This class or interface has been added as
+ * part of a work in progress. There is no guarantee that this API will
+ * work or that it will remain the same.
+ * </p>
  */
 public interface IProblemLocationFactory {
 

codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/IProblemReporter.java

@@ -14,6 +14,11 @@ package org.eclipse.cdt.codan.core.model;
  * IProblemReporter - interface to report problems
  * 
  * Clients may implement and extend this interface
+ * <p>
+ * <strong>EXPERIMENTAL</strong>. This class or interface has been added as
+ * part of a work in progress. There is no guarantee that this API will
+ * work or that it will remain the same.
+ * </p>
  */
 public interface IProblemReporter {
 	public static final String GENERIC_CODE_ANALYSIS_MARKER_TYPE = "org.eclipse.cdt.codan.core.codanProblem"; //$NON-NLS-1$

codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/IProblemWorkingCopy.java

@@ -11,9 +11,14 @@
 package org.eclipse.cdt.codan.core.model;
 
 /**
- * Modifiable problem
+ * Modifiable problem.
  * 
  * Clients may extend and implement this interface
+ * <p>
+ * <strong>EXPERIMENTAL</strong>. This class or interface has been added as
+ * part of a work in progress. There is no guarantee that this API will
+ * work or that it will remain the same.
+ * </p>
  */
 public interface IProblemWorkingCopy extends IProblem {
 	/**

codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/internal/core/model/CodanProblemLocation.java

@@ -10,14 +10,14 @@
  *******************************************************************************/
 package org.eclipse.cdt.codan.internal.core.model;
 
-import org.eclipse.cdt.codan.core.model.ProblemLocation;
+import org.eclipse.cdt.codan.core.model.AbstractProblemLocation;
 import org.eclipse.core.resources.IFile;
 
 /**
  * Codan Problem Location, so far same as abstract class
  *
  */
-public class CodanProblemLocation extends ProblemLocation {
+public class CodanProblemLocation extends AbstractProblemLocation {
 
 	public CodanProblemLocation(IFile file, int startChar, int endChar) {
 		super(file, startChar, endChar);