API tags for org.eclipse.cdt.core, bug 260830.

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/util/CDTListComparator.java

@@ -17,9 +17,6 @@ import org.eclipse.cdt.core.settings.model.ICConfigurationDescription;
 import org.eclipse.cdt.core.settings.model.ICLanguageSetting;
 import org.eclipse.cdt.core.settings.model.ICLanguageSettingEntry;
 
-/**
- * @noextend This class is not intended to be subclassed by clients.
- */
 public class CDTListComparator implements Comparator<Object> {
 	private static Comparator<Object> comparator = null;
 

core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/IPDOMNode.java

@@ -17,6 +17,8 @@ import org.eclipse.core.runtime.CoreException;
 
 /**
  * Interface for all nodes that can be visited by a {@link IPDOMVisitor}.
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IPDOMNode {
 
@@ -28,6 +30,7 @@ public interface IPDOMNode {
 	/**
 	 * Frees memory allocated by this node, the node may no longer be used.
 	 * @param linkage the linkage the node belongs to.
+	 * @noreference This method is not intended to be referenced by clients.
 	 */
 	public void delete(PDOMLinkage linkage) throws CoreException;
 }

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/AbstractCExtension.java

@@ -10,23 +10,39 @@
  *******************************************************************************/
 package org.eclipse.cdt.core;
 
-import org.eclipse.cdt.internal.core.InternalCExtension;
 import org.eclipse.core.resources.IProject;
+import org.eclipse.core.runtime.PlatformObject;
 
-public abstract class AbstractCExtension extends InternalCExtension implements ICExtension {
+public abstract class AbstractCExtension extends PlatformObject implements ICExtension {
+	private IProject fProject;
+	private ICExtensionReference extensionRef;
 
 	/**
 	 * Returns the project for which this extrension is defined.
 	 *	
 	 * @return the project
 	 */
-	@Override
 	public final IProject getProject() {
-		return super.getProject();
+		return fProject;
 	}
 	
-	@Override
 	public final ICExtensionReference getExtensionReference() {
-		return super.getExtensionReference();
+		return extensionRef;
+	}
+	
+
+    // internal stuff
+	/**
+	 * @noreference This method is not intended to be referenced by clients.
+	 */
+	public void setProject(IProject project) {
+		fProject = project;
+	}
+
+	/**
+	 * @noreference This method is not intended to be referenced by clients.
+	 */
+	public void setExtensionReference(ICExtensionReference extReference) {
+		extensionRef = extReference;
 	}
 }

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/CCProjectNature.java

@@ -17,6 +17,10 @@ import org.eclipse.core.runtime.IProgressMonitor;
 import org.eclipse.core.runtime.IStatus;
 import org.eclipse.core.runtime.Status;
 
+/**
+ * @noextend This class is not intended to be subclassed by clients.
+ * @noinstantiate This class is not intended to be instantiated by clients.
+ */
 public class CCProjectNature extends CProjectNature {
 
 	public static final String CC_NATURE_ID= CCorePlugin.PLUGIN_ID + ".ccnature"; //$NON-NLS-1$

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/CConventions.java

@@ -26,7 +26,8 @@ import org.eclipse.core.runtime.Status;
 import org.eclipse.osgi.util.NLS;
 
 /**
- * @author hamer
+ * @noextend This interface is not intended to be extended by clients.
+ * @noinstantiate This class is not intended to be instantiated by clients.
  */
 public class CConventions {
 	private final static String scopeResolutionOperator= "::"; //$NON-NLS-1$

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/CCorePreferenceConstants.java

@@ -12,7 +12,10 @@
  *******************************************************************************/
 package org.eclipse.cdt.core;
 
-
+/**
+ * @noextend This class is not intended to be subclassed by clients.
+ * @noinstantiate This class is not intended to be instantiated by clients.
+ */
 public class CCorePreferenceConstants {
 
 	/**

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/CDescriptorEvent.java

@@ -12,6 +12,10 @@ package org.eclipse.cdt.core;
 
 import java.util.EventObject;
 
+/**
+ * @noextend This class is not intended to be subclassed by clients.
+ * @noinstantiate This class is not intended to be instantiated by clients.
+ */
 public class CDescriptorEvent extends EventObject {
 
 	/**

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/CProjectNature.java

@@ -22,6 +22,10 @@ import org.eclipse.core.runtime.CoreException;
 import org.eclipse.core.runtime.IProgressMonitor;
 import org.eclipse.core.runtime.NullProgressMonitor;
 
+/**
+ * @noextend This class is not intended to be subclassed by clients.
+ * @noinstantiate This class is not intended to be instantiated by clients.
+ */
 public class CProjectNature implements IProjectNature {
 
 	public static final String C_NATURE_ID = CCorePlugin.PLUGIN_ID + ".cnature"; //$NON-NLS-1$

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/CommandLauncher.java

@@ -10,10 +10,6 @@
  *******************************************************************************/
 package org.eclipse.cdt.core;
 
-/*
- * (c) Copyright IBM Corp. 2000, 2001. All Rights Reserved.
- */
-
 import java.io.File;
 import java.io.IOException;
 import java.io.OutputStream;
@@ -25,6 +21,9 @@ import org.eclipse.cdt.utils.spawner.ProcessFactory;
 import org.eclipse.core.runtime.IPath;
 import org.eclipse.core.runtime.IProgressMonitor;
 
+/**
+ * @noextend This class is not intended to be subclassed by clients.
+ */
 public class CommandLauncher {
 
 	public final static int COMMAND_CANCELED = 1;

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ConsoleOutputStream.java

@@ -17,6 +17,8 @@ import java.io.OutputStream;
 
 /**
  * Output stream which storing the console output
+ * 
+ * @noinstantiate This class is not intended to be instantiated by clients.
  */
 public class ConsoleOutputStream extends OutputStream {
 	

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ErrorParserManager.java

@@ -37,6 +37,9 @@ import org.eclipse.core.runtime.CoreException;
 import org.eclipse.core.runtime.IPath;
 import org.eclipse.core.runtime.Path;
 
+/**
+ * @noextend This class is not intended to be subclassed by clients.
+ */
 public class ErrorParserManager extends OutputStream {
 
 	private int nOpens;

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptorManager.java

@@ -16,6 +16,10 @@ import org.eclipse.core.resources.IProject;
 import org.eclipse.core.runtime.CoreException;
 import org.eclipse.core.runtime.IProgressMonitor;
 
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface ICDescriptorManager {
 
 	public void configure(IProject project, String id) throws CoreException;

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptorOperation.java

@@ -15,6 +15,10 @@ import org.eclipse.core.resources.IProject;
 import org.eclipse.core.runtime.CoreException;
 import org.eclipse.core.runtime.IProgressMonitor;
 
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface ICDescriptorOperation {
 	
 	/**

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICExtension.java

@@ -14,6 +14,8 @@ import org.eclipse.core.resources.IProject;
 
 /**
  * This represents an executable extension in the cmodel hierarchy
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ICExtension {
 	public IProject getProject();

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICExtensionDescriptor.java

@@ -10,6 +10,10 @@
  *******************************************************************************/
 package org.eclipse.cdt.core;
 
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface ICExtensionDescriptor {
 	String getName();
 

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICExtensionReference.java

@@ -24,6 +24,9 @@ import org.eclipse.core.runtime.IConfigurationElement;
  * @see ICConfigExtensionReference
  * @see ICExtension
  * @see ICDescriptor
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ICExtensionReference {
 

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICLogConstants.java

@@ -14,6 +14,8 @@ package org.eclipse.cdt.core;
 
 /**
  * @author bgheorgh
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ICLogConstants {
     public class LogConst {

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICOwner.java

@@ -12,6 +12,10 @@ package org.eclipse.cdt.core;
 
 import org.eclipse.core.runtime.CoreException;
 
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface ICOwner {
 	public void configure(ICDescriptor cproject) throws CoreException;
 	public void update(ICDescriptor cproject, String extensionID) throws CoreException;

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICOwnerInfo.java

@@ -10,6 +10,10 @@
  *******************************************************************************/
 package org.eclipse.cdt.core;
 
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface ICOwnerInfo {
 	public String getID();	
 	public String getName();

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IConsoleParser.java

@@ -14,6 +14,8 @@ package org.eclipse.cdt.core;
  * A basic interface for console parsers
  * 
  * @author vhirsl
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IConsoleParser {
 	/**

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IMarkerGenerator.java

@@ -14,6 +14,7 @@ import org.eclipse.core.resources.IResource;
 
 /**
  * @author sam.robb
+ * @noextend This interface is not intended to be extended by clients.
  */
 public interface IMarkerGenerator {
 	int SEVERITY_INFO = 0;

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IPositionConverter.java

@@ -30,16 +30,10 @@ import org.eclipse.jface.text.IRegion;
  * An deletion followed by an insertion without saving the file inbetween, will cancel
  * the deletion as far as possible.
  * 
- * <p> This interface is not intended to be implemented by clients. </p>
- * 
- * <p>
- * <strong>EXPERIMENTAL</strong>. This 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. Please do not use this API without
- * consulting with the CDT team.
- * </p>
- * 
  * @since 4.0
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 
 public interface IPositionConverter {

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IProcessInfo.java

@@ -10,6 +10,10 @@
  *******************************************************************************/
 package org.eclipse.cdt.core;
 
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface IProcessInfo {
 	public int getPid();
 	public String getName();

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IProcessList.java

@@ -10,6 +10,10 @@
  *******************************************************************************/
 package org.eclipse.cdt.core;
 
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface IProcessList {
 	public IProcessInfo[] getProcessList();
 }

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ISymbolReader.java

@@ -15,6 +15,8 @@ package org.eclipse.cdt.core;
  * 
  * This initial version only returns a list of source files.
  * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ISymbolReader {
 

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ProblemMarkerInfo.java

@@ -14,6 +14,9 @@ package org.eclipse.cdt.core;
 import org.eclipse.core.resources.IResource;
 import org.eclipse.core.runtime.IPath;
 
+/**
+ * @noextend This class is not intended to be subclassed by clients.
+ */
 public  class ProblemMarkerInfo {
 		
 		public IResource file;

core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ToolFactory.java

@@ -24,6 +24,8 @@ import org.eclipse.core.runtime.IExtensionPoint;
 import org.eclipse.core.runtime.Platform;
 
 /**
+ * @noextend This class is not intended to be subclassed by clients.
+ * @noinstantiate This class is not intended to be instantiated by clients.
  */
 public class ToolFactory {
 

core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/CConfigBasedDescriptor.java

@@ -20,6 +20,7 @@ import java.util.HashMap;
 import java.util.LinkedHashSet;
 import java.util.Map;
 
+import org.eclipse.cdt.core.AbstractCExtension;
 import org.eclipse.cdt.core.CCorePlugin;
 import org.eclipse.cdt.core.CDescriptorEvent;
 import org.eclipse.cdt.core.ICDescriptor;
@@ -155,12 +156,12 @@ final public class CConfigBasedDescriptor implements ICDescriptor {
 		}
 
 		public ICExtension createExtension() throws CoreException {
-			InternalCExtension cExtension = null;
+			AbstractCExtension cExtension = null;
 			IConfigurationElement el = CExtensionUtil.getFirstConfigurationElement(fCfgExtRef, CEXTENSION_NAME, false);
-			cExtension = (InternalCExtension)el.createExecutableExtension("run"); //$NON-NLS-1$
+			cExtension = (AbstractCExtension)el.createExecutableExtension("run"); //$NON-NLS-1$
 			cExtension.setExtensionReference(this);
 			cExtension.setProject(getProject());
-			return (ICExtension)cExtension;
+			return cExtension;
 		}
 
 		public ICDescriptor getCDescriptor() {

core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/InternalCExtension.java

@@ -1,37 +0,0 @@
-/*******************************************************************************
- * Copyright (c) 2000, 2005 QNX Software Systems and others.
- * All rights reserved. This program and the accompanying materials
- * are made available under the terms of the Eclipse Public License v1.0
- * which accompanies this distribution, and is available at
- * http://www.eclipse.org/legal/epl-v10.html
- *
- * Contributors:
- *     QNX Software Systems - Initial API and implementation
- *******************************************************************************/
-package org.eclipse.cdt.internal.core;
-
-import org.eclipse.cdt.core.ICExtensionReference;
-import org.eclipse.core.resources.IProject;
-import org.eclipse.core.runtime.PlatformObject;
-
-public abstract class InternalCExtension extends PlatformObject {
-
-	private IProject fProject;
-	private ICExtensionReference extensionRef;
-		
-	protected void setProject(IProject project) {
-		fProject = project;
-	}
-
-	void setExtensionReference(ICExtensionReference extReference) {
-		extensionRef = extReference;
-	}
-		
-	protected IProject getProject() {
-		return fProject;
-	}
-
-	protected ICExtensionReference getExtensionReference() {
-		return extensionRef;
-	}
-}