Bug 279740: API restrictions

16 files changed, 37 insertions, 9 deletions

diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/AbstractChecker.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/AbstractChecker.java
index ddd24f62f96..c958351512d 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/AbstractChecker.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/AbstractChecker.java
@@ -19,7 +19,6 @@ import org.eclipse.core.resources.IResource;
  * Convenience implementation of IChecker interface. Has a default
  * implementation for common methods.
  * 
- * Clients may extend this class.
  */
 public abstract class AbstractChecker implements IChecker {
 	protected String name;
diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/CodanSeverity.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/CodanSeverity.java
index 72bd866c674..19c23bf2cc3 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/CodanSeverity.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/CodanSeverity.java
@@ -15,11 +15,7 @@ import org.eclipse.core.resources.IMarker;
 /**
  * 
  * Represents Severity of the codan problem. It is directly mapped to markers
- * severity,
- * therefore not intended to be extended.
- * 
- * @noextend This class is not intended to be extended by clients.
- * @noinstantiate This class is not intended to be instantiated by clients.
+ * severity.
  * 
  */
 public enum CodanSeverity {
diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/IProblemReporterPersistent.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/IProblemReporterPersistent.java
index 26c79912405..7b2840faabf 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/IProblemReporterPersistent.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/IProblemReporterPersistent.java
@@ -16,7 +16,6 @@ import org.eclipse.core.resources.IResource;
  * IProblemReporterPersistent - interface to report problems, which are
  * persistent, ex. markers
  * 
- * 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
diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/IProblemWorkingCopy.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/IProblemWorkingCopy.java
index 2059964bc36..66cfee2f135 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/IProblemWorkingCopy.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/IProblemWorkingCopy.java
@@ -15,12 +15,15 @@ import org.eclipse.cdt.codan.core.param.IProblemPreference;
 /**
  * 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>
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IProblemWorkingCopy extends IProblem {
 	/**
diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IBasicBlock.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IBasicBlock.java
index fc261610ea0..1f8a6c9ea6d 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IBasicBlock.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IBasicBlock.java
@@ -4,6 +4,9 @@ package org.eclipse.cdt.codan.core.model.cfg;
  * Control flow graph's basic block node - super interface of all nodes.
  * It has set on incoming nodes and outgoing nodes.
  * <p/>
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IBasicBlock {
 	/**
diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IBranchNode.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IBranchNode.java
index 4d88c55376a..284327a9bca 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IBranchNode.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IBranchNode.java
@@ -12,6 +12,9 @@ package org.eclipse.cdt.codan.core.model.cfg;
 
 /**
  * Node that represent empty operator with label, such as case branch or label
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IBranchNode extends IBasicBlock, ISingleIncoming,
 		ISingleOutgoing {
diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IConnectorNode.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IConnectorNode.java
index 16981c392df..e7e3a81a2c6 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IConnectorNode.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IConnectorNode.java
@@ -3,6 +3,9 @@ package org.eclipse.cdt.codan.core.model.cfg;
 /**
  * Connector node has multiple incoming branches and single outgoing.
  * Incoming nodes are usually instance of {@link IJumpNode}
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IConnectorNode extends IBasicBlock, ISingleOutgoing {
 	/**
diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IControlFlowGraph.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IControlFlowGraph.java
index 151bd3854fe..e27e36c0bdf 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IControlFlowGraph.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IControlFlowGraph.java
@@ -29,6 +29,9 @@ import java.util.Iterator;
  * change of control direction
  * <li> {@link IBranchNode} - usually node where decision node connect to,
  * labels represent a way where controls goes to
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IControlFlowGraph {
 	/**
diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IDecisionNode.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IDecisionNode.java
index eda008cea0c..57c0de603cb 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IDecisionNode.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IDecisionNode.java
@@ -5,6 +5,9 @@ package org.eclipse.cdt.codan.core.model.cfg;
  * Interface for decision node. This node represent condition node in the graph,
  * it has one incoming arc and many outgoing, each of outgoing node should be
  * IBranchNode
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IDecisionNode extends IBasicBlock, ISingleIncoming {
 	/**
diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IExitNode.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IExitNode.java
index 2ceeda9be0f..4b4da059e7a 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IExitNode.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IExitNode.java
@@ -14,6 +14,8 @@ package org.eclipse.cdt.codan.core.model.cfg;
  * Exit node of the graph. Usually return from the function, can also be throw
  * or abort, such at exit(0) call.
  * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IExitNode extends IBasicBlock, ISingleIncoming {
 	/**
diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IJumpNode.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IJumpNode.java
index 3511647022c..9897f985db0 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IJumpNode.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IJumpNode.java
@@ -4,6 +4,9 @@ package org.eclipse.cdt.codan.core.model.cfg;
  * Node that changes the control of the graph, i.e. passes control to non-next
  * statement. Can be used to implement gotos, break, continue, end of branches.
  * Outgoing node is always {@link IConnectorNode}
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IJumpNode extends IBasicBlock, ISingleOutgoing {
 	/**
diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/INodeFactory.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/INodeFactory.java
index 643588df2c1..84424d3e68a 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/INodeFactory.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/INodeFactory.java
@@ -12,6 +12,8 @@ package org.eclipse.cdt.codan.core.model.cfg;
 
 /**
  * Control Flow Graph Node factory
+ * 
+ * @noextend This interface is not intended to be extended by clients.
  */
 public interface INodeFactory {
 	/**
diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IPlainNode.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IPlainNode.java
index 83b117f4e4e..059bf66ffe6 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IPlainNode.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IPlainNode.java
@@ -3,6 +3,9 @@ package org.eclipse.cdt.codan.core.model.cfg;
 /**
  * Has one incoming, one outgoing connection. Usually expression statement or
  * declaration.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IPlainNode extends IBasicBlock, ISingleOutgoing,
 		ISingleIncoming {
diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/ISingleIncoming.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/ISingleIncoming.java
index 9ac7f3000aa..d6962a49919 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/ISingleIncoming.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/ISingleIncoming.java
@@ -2,6 +2,8 @@ package org.eclipse.cdt.codan.core.model.cfg;
 
 /**
  * Node with one incoming arc
+ * 
+ * @noextend This interface is not intended to be extended by clients.
  */
 public interface ISingleIncoming {
 	/**
diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/ISingleOutgoing.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/ISingleOutgoing.java
index c95c2d29363..d66cadbd507 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/ISingleOutgoing.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/ISingleOutgoing.java
@@ -2,6 +2,8 @@ package org.eclipse.cdt.codan.core.model.cfg;
 
 /**
  * Node with one outgoing arc
+ * 
+ * @noextend This interface is not intended to be extended by clients.
  */
 public interface ISingleOutgoing {
 	/**
diff --git a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IStartNode.java b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IStartNode.java
index 9e5194aad8b..2092638f138 100644
--- a/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IStartNode.java
+++ b/codan/org.eclipse.cdt.codan.core/src/org/eclipse/cdt/codan/core/model/cfg/IStartNode.java
@@ -1,10 +1,12 @@
 package org.eclipse.cdt.codan.core.model.cfg;
 
-
 /**
  * Start node of the control flow graph. Each graph has only one start node. It
  * has no incoming arcs and one outgoing arc. It also contains iterator for
  * function exit nodes.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IStartNode extends IBasicBlock, ISingleOutgoing {
 }