API tags for org.eclipse.cdt.core.model + language, bug 260830.

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/language/ProjectLanguageConfiguration.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2007, 2008 IBM Corporation and others.
+ * Copyright (c) 2007, 2009 IBM Corporation 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
@@ -30,6 +30,8 @@ import org.eclipse.core.resources.IFile;
  * </p>
  * 
  * @since 4.0
+ * @noextend This class is not intended to be subclassed by clients.
+ * @noinstantiate This class is not intended to be instantiated by clients.
  */
 public class ProjectLanguageConfiguration {
 	private static final String ALL_CONFIGURATIONS = ""; //$NON-NLS-1$

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/language/WorkspaceLanguageConfiguration.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2007, 2008 IBM Corporation and others.
+ * Copyright (c) 2007, 2009 IBM Corporation 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
@@ -16,6 +16,9 @@ import java.util.TreeMap;
 
 /**
  * Provides programmatic access to language mappings for the workspace. 
+ * 
+ * @noextend This class is not intended to be subclassed by clients.
+ * @noinstantiate This class is not intended to be instantiated by clients.
  */
 public class WorkspaceLanguageConfiguration {
 	

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/BufferChangedEvent.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2002, 2006 IBM Corporation and others.
+ * Copyright (c) 2002, 2009 IBM Corporation 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
@@ -38,7 +38,8 @@ import java.util.EventObject;
  * is 0, and <code>getText</code> is <code>null</code>.
  * </p>
  * <p>
- * This class is not intended to be instantiated or subclassed by clients.
+ * @noextend This class is not intended to be subclassed by clients.
+ * 
  * Instances of this class are automatically created by the C model.
  * </p>
  *

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/CModelException.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -66,7 +66,7 @@ public class CModelException extends CoreException {
 	/**
 	 * Returns the underlying <code>Throwable</code> that caused the failure.
 	 *
-	 * @return the wrappered <code>Throwable</code>, or <code>null</code> if the
+	 * @return the wrapped <code>Throwable</code>, or <code>null</code> if the
 	 *   direct case of the failure was at the C model layer
 	 */
 	public Throwable getException() {

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/CoreModel.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2008 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -59,6 +59,10 @@ import org.eclipse.core.runtime.Plugin;
 import org.eclipse.core.runtime.content.IContentType;
 import org.eclipse.core.runtime.jobs.ISchedulingRule;
 
+/**
+ * @noextend This class is not intended to be subclassed by clients.
+ * @noinstantiate This class is not intended to be instantiated by clients.
+ */
 public class CoreModel {
 	private static CoreModel cmodel = null;
 	private static CModelManager manager = CModelManager.getDefault();

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/CoreModelUtil.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2002, 2008 QNX Software Systems and others.
+ * Copyright (c) 2002, 2009 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
@@ -10,7 +10,6 @@
  *    Markus Schorn (Wind River Systems)
  *    IBM Corporation - EFS support
  *******************************************************************************/
-
 package org.eclipse.cdt.core.model;
 
 import java.net.URI;
@@ -32,6 +31,10 @@ import org.eclipse.core.resources.IWorkspaceRoot;
 import org.eclipse.core.resources.ResourcesPlugin;
 import org.eclipse.core.runtime.IPath;
 
+/**
+ * @noextend This class is not intended to be subclassed by clients.
+ * @noinstantiate This class is not intended to be instantiated by clients.
+ */
 public class CoreModelUtil {
 
 	/*

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ElementChangedEvent.java

@@ -1,7 +1,5 @@
-package org.eclipse.cdt.core.model;
-
 /*******************************************************************************
- * Copyright (c) 2001, 2008 IBM Corporation and others.
+ * Copyright (c) 2001, 2009 IBM Corporation 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
@@ -10,6 +8,8 @@ package org.eclipse.cdt.core.model;
  * Contributors:
  * IBM - Initial API and implementation
  *******************************************************************************/
+package org.eclipse.cdt.core.model;
+
 import java.util.EventObject;
 
 import org.eclipse.cdt.internal.core.model.CShiftData;
@@ -21,6 +21,9 @@ import org.eclipse.cdt.internal.core.model.CShiftData;
  *
  * @see IElementChangedListener
  * @see ICElementDelta
+ * 
+ * @noextend This class is not intended to be subclassed by clients.
+ * @noinstantiate This class is not intended to be instantiated by clients.
  */
 public class ElementChangedEvent extends EventObject {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/Flags.java

@@ -1,7 +1,5 @@
-package org.eclipse.cdt.core.model;
-
 /*******************************************************************************
- * Copyright (c) 2000, 2006 IBM Corporation and others.
+ * Copyright (c) 2000, 2009 IBM Corporation 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
@@ -10,16 +8,14 @@ package org.eclipse.cdt.core.model;
  * Contributors:
  * IBM - Initial API and implementation
  *******************************************************************************/
- 
+package org.eclipse.cdt.core.model;
+
 import org.eclipse.cdt.internal.core.model.IConstants;
 
 /**
  * Utility class for decoding modifier flags in C elements.
- * <p>
+ * 
- * This class provides static methods only; it is not intended to be
+ * @noinstantiate This class is not intended to be instantiated by clients.
- * instantiated or subclassed by clients.
- * </p>
- *
  */
 public final class Flags {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IArchive.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -13,7 +13,10 @@ package org.eclipse.cdt.core.model;
 
 /**
  * An IArchive represents a group of files combined  into  a
- * single file(the Archive), for example libxx.a.
+ * single file(the Archive), for example 'libXX.a'.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IArchive extends ICElement, IParent, IOpenable {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IArchiveContainer.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -14,6 +14,9 @@ package org.eclipse.cdt.core.model;
 /**
  * Represents a container of all the IArchive's found in the project
  * while inspecting the project.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IArchiveContainer extends ICElement, IParent, IOpenable {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IAsmLabel.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2007 Wind River Systems, Inc. and others.
+ * Copyright (c) 2007, 2009 Wind River Systems, Inc. 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
@@ -14,6 +14,8 @@ package org.eclipse.cdt.core.model;
  * Represents a label in assembly code.
  *
  * @since 5.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 IAsmLabel extends ICElement, ISourceManipulation, ISourceReference {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IBinary.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2007 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -16,9 +16,8 @@ package org.eclipse.cdt.core.model;
  * Represents a Binary file, for example an ELF executable.
  * An ELF parser will inspect the binary.
  * 
- * <p> 
+ * @noextend This interface is not intended to be extended by clients.
- * This interface is not intended to be implemented by clients. 
+ * @noimplement This interface is not intended to be implemented by clients.
- * </p>
  */
 public interface IBinary extends ICElement, IParent, IOpenable {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IBinaryContainer.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -14,6 +14,9 @@ package org.eclipse.cdt.core.model;
 /**
  * Represents a container of all the IBinary's found in the project
  * while inspecting the project.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IBinaryContainer extends ICElement, IParent, IOpenable {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IBinaryElement.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -14,6 +14,8 @@ import org.eclipse.cdt.core.IAddress;
 
 
 /**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IBinaryElement extends ICElement {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IBinaryFunction.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -13,6 +13,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Represents a function.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IBinaryFunction extends IFunction, IBinaryElement {
 }

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IBinaryModule.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -12,6 +12,8 @@ package org.eclipse.cdt.core.model;
 
 
 /**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IBinaryModule extends IParent, IBinaryElement {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IBinaryVariable.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2002, 2005 QNX Software Systems and others.
+ * Copyright (c) 2002, 2009 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
@@ -13,6 +13,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Represents a global variable.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IBinaryVariable extends IVariable , IBinaryElement {
 }

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IBuffer.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2002, 2006 IBM Corporation and others.
+ * Copyright (c) 2002, 2009 IBM Corporation 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
@@ -22,8 +22,9 @@ import org.eclipse.core.runtime.IProgressMonitor;
  * saving the buffer has no effect. Buffers can be read-only.
  * <p>
  * This interface is similar to the JDT IBuffer interface.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
  */
-
 public interface IBuffer {
 
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ICContainer.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -10,11 +10,11 @@
  *******************************************************************************/
 package org.eclipse.cdt.core.model;
 
-
-
-
 /**
  * A C Folder Resource.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ICContainer extends ICElement, IParent, IOpenable {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ICElement.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2008 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -12,7 +12,6 @@
  *******************************************************************************/
 package org.eclipse.cdt.core.model;
 
- 
 import java.net.URI;
 
 import org.eclipse.core.resources.IResource;
@@ -22,6 +21,9 @@ import org.eclipse.core.runtime.IPath;
 
 /**
  * Common protocol for all elements provided by the C model.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ICElement extends IAdaptable {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ICElementDelta.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2005 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -43,6 +43,9 @@ import org.eclipse.core.resources.IResourceDelta;
  * <p>
  * Note that the move change flags only describe the changes to a single element, they
  * do not imply anything about the parent or children of the element.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ICElementDelta {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ICModel.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2005 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -26,6 +26,9 @@ import org.eclipse.core.runtime.IProgressMonitor;
  * </p>
  *
  * @see CoreModel#create(org.eclipse.core.resources.IWorkspaceRoot)
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ICModel extends ICElement, IParent, IOpenable {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ICModelMarker.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2007 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -16,10 +16,9 @@ import org.eclipse.cdt.core.CCorePlugin;
 
 /**
  * Markers used by the C model.
- * <p>
+ * 
- * This interface declares constants only; it is not intended to be implemented
+ * @noextend This interface is not intended to be extended by clients.
- * or extended.
+ * @noimplement This interface is not intended to be implemented by clients.
- * </p>
  */
 public interface ICModelMarker {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ICModelStatus.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -30,12 +30,11 @@ import org.eclipse.core.runtime.IStatus;
  *   <li>elements - optional handles to C elements associated with the failure</li>
  *   <li>string - optional string associated with the failure</li>
  * </ul>
- * <p>
- * This interface is not intended to be implemented by clients.
- * </p>
- *
  * @see org.eclipse.core.runtime.IStatus
  * @see ICModelStatusConstants
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ICModelStatus extends IStatus {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ICModelStatusConstants.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -13,13 +13,12 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Status codes used with C model status objects.
- * <p>
- * This interface declares constants only; it is not intended to be implemented
- * or extended.
- * </p>
  *
  * @see ICModelStatus
  * @see org.eclipse.core.runtime.IStatus#getCode
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ICModelStatusConstants {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ICProject.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2007 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -26,6 +26,9 @@ import org.eclipse.core.runtime.IProgressMonitor;
  * </p>
  *
  * @see CoreModel#create(org.eclipse.core.resources.IProject)
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ICProject extends IParent, IOpenable, ICElement {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IConfiguration.java

@@ -1,32 +0,0 @@
-/*******************************************************************************
- * Copyright (c) 2008 Wind River 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:
- *   Doug Schaefer (Wind River Systems)
- *******************************************************************************/
-package org.eclipse.cdt.core.model;
-
-import org.eclipse.cdt.core.parser.IScannerInfo;
-import org.eclipse.core.resources.IResource;
-
-/**
- * Represents a build configuration.
- * 
- * @author Doug Schaefer
- * @since 5.1
- */
-public interface IConfiguration {
-
-	/**
-	 * Get the scanner info for the given resource in this configuration.
-	 * 
-	 * @param resource
-	 * @return scanner info for this resource in this configuration
-	 */
-	IScannerInfo getScannerInfo(IResource resource);
-
-}

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IContainerEntry.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -10,7 +10,10 @@
  *******************************************************************************/
 package org.eclipse.cdt.core.model;
 
-
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface IContainerEntry extends IPathEntry {
 
 }

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IDeclaration.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2002, 2005 IBM Corporation and others.
+ * Copyright (c) 2002, 2009 IBM Corporation 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
@@ -13,6 +13,9 @@ package org.eclipse.cdt.core.model;
 /**
  * IDeclaration is a base interface for any C Model element that could be
  * considered a 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 IDeclaration extends ICElement, ISourceManipulation, ISourceReference {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IEnumeration.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -13,6 +13,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * An Enumeration type.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IEnumeration extends IParent, IDeclaration {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IEnumerator.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2002, 2007 IBM Corporation and others.
+ * Copyright (c) 2002, 2009 IBM Corporation 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
@@ -10,6 +10,10 @@
  *******************************************************************************/
 package org.eclipse.cdt.core.model;
 
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface IEnumerator extends ICElement, ISourceManipulation, ISourceReference {
 
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IField.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2005 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -12,6 +12,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Represents a field(variable) declared in an IStructure(struct, class, union).
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IField extends IMember, IVariableDeclaration {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IFunction.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -13,6 +13,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Represents a function definition.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IFunction extends IFunctionDeclaration {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IFunctionDeclaration.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2008 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -13,6 +13,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Represents a function
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IFunctionDeclaration extends IDeclaration {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IFunctionTemplate.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005 QnX Software Systems and others.
+ * Copyright (c) 2005, 2009 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
@@ -13,9 +13,10 @@ package org.eclipse.cdt.core.model;
 
 
 /**
- * 
  * Function template definition.
- *
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IFunctionTemplate extends IFunctionTemplateDeclaration, IFunction {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IFunctionTemplateDeclaration.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005 QnX Software Systems and others.
+ * Copyright (c) 2005, 2009 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
@@ -12,9 +12,10 @@
 package org.eclipse.cdt.core.model;
 
 /**
- * 
  * Function template 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 IFunctionTemplateDeclaration extends ITemplate, IFunctionDeclaration {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IInclude.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2007 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -13,6 +13,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Represents an include declaration in a C translation unit.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IInclude extends ICElement, ISourceReference, ISourceManipulation {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IIncludeEntry.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -12,6 +12,10 @@ package org.eclipse.cdt.core.model;
 
 import org.eclipse.core.runtime.IPath;
 
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface IIncludeEntry extends IPathEntry {
 
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IIncludeFileEntry.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2005 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -13,6 +13,10 @@ package org.eclipse.cdt.core.model;
 
 import org.eclipse.core.runtime.IPath;
 
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface IIncludeFileEntry extends IPathEntry {
 
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IIncludeReference.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2002, 2006 QNX Software Systems and others.
+ * Copyright (c) 2002, 2009 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
@@ -14,7 +14,8 @@ package org.eclipse.cdt.core.model;
 import org.eclipse.core.runtime.IPath;
 
 /**
- * IIncludeReference
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IIncludeReference extends IParent, ICElement {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IInheritance.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -15,6 +15,9 @@ import org.eclipse.cdt.core.parser.ast.ASTAccessVisibility;
 
 /**
  * Place holder of the inherited class from struct or class(IStructure).
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IInheritance {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ILanguageDescriptor.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2007 Intel Corporation and others.
+ * Copyright (c) 2007, 2009 Intel Corporation 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
@@ -13,6 +13,10 @@ package org.eclipse.cdt.core.model;
 import org.eclipse.cdt.core.ICExtensionDescriptor;
 import org.eclipse.core.runtime.content.IContentType;
 
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface ILanguageDescriptor extends ICExtensionDescriptor {
 	ILanguage getLanguage();
 	

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ILanguageMappingChangeEvent.java

@@ -1,12 +1,12 @@
 /*******************************************************************************
- * Copyright (c) 2007, 2008 IBM Corporation and others.
+ * Copyright (c) 2007, 2009 IBM Corporation 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:
- *     IBM Corporation - initial API and implementation
+ *     Chris Recoskie (IBM Corporation) - initial API and implementation
  *******************************************************************************/
 package org.eclipse.cdt.core.model;
 
@@ -19,8 +19,10 @@ import org.eclipse.core.runtime.content.IContentType;
  * Contains the details of changes that occurred as a result of modifying
  * language mappings. 
  * 
- * @author crecoskie
  * @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 ILanguageMappingChangeEvent {
 	

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ILibraryEntry.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -12,6 +12,10 @@ package org.eclipse.cdt.core.model;
 
 import org.eclipse.core.runtime.IPath;
 
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface ILibraryEntry extends IPathEntry {
 
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ILibraryReference.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -12,6 +12,8 @@ package org.eclipse.cdt.core.model;
 
 
 /**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ILibraryReference extends IParent, ICElement {
 	

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IMacro.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2002, 2005 IBM Corporation and others.
+ * Copyright (c) 2002, 2009 IBM Corporation 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
@@ -13,6 +13,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Represents a field declared in a type.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IMacro extends ICElement, ISourceManipulation, ISourceReference {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IMacroEntry.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -12,6 +12,10 @@ package org.eclipse.cdt.core.model;
 
 import org.eclipse.core.runtime.IPath;
 
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface IMacroEntry extends IPathEntry {
 
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IMacroFileEntry.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2005 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -13,6 +13,10 @@ package org.eclipse.cdt.core.model;
 
 import org.eclipse.core.runtime.IPath;
 
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface IMacroFileEntry extends IPathEntry {
 
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IMember.java

@@ -1,5 +1,5 @@
 /**********************************************************************
- * Copyright (c) 2002, 2005 IBM Corporation and others.
+ * Copyright (c) 2002, 2009 IBM Corporation 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
@@ -16,6 +16,9 @@ import org.eclipse.cdt.core.parser.ast.ASTAccessVisibility;
  * Common protocol for C elements that can be members of types.
  * This set consists of <code>IType</code>, <code>IMethod</code>, 
  * <code>IField</code>.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IMember extends IDeclaration {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IMethod.java

@@ -1,5 +1,5 @@
 /**********************************************************************
- * Copyright (c) 2002, 2005 IBM Corporation and others.
+ * Copyright (c) 2002, 2009 IBM Corporation 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
@@ -12,6 +12,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Represents the definition method of a class.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IMethod extends IMethodDeclaration {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IMethodDeclaration.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -13,6 +13,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Represents the declaration method of a class
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IMethodDeclaration extends IMember, IFunctionDeclaration {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IMethodTemplate.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005 QnX Software Systems and others.
+ * Copyright (c) 2005, 2009 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
@@ -13,8 +13,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Member template definition.
- * IMethodTemplate
  *
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IMethodTemplate extends IMethodTemplateDeclaration, IMethod {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IMethodTemplateDeclaration.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005 QnX Software Systems and others.
+ * Copyright (c) 2005, 2009 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
@@ -13,8 +13,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Member template declaration.
- * IMethodTemplateDeclaration
+ * 
- *
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IMethodTemplateDeclaration extends ITemplate, IMethodDeclaration {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/INamespace.java

@@ -1,5 +1,5 @@
 /**********************************************************************
- * Copyright (c) 2002, 2005 IBM Corporation and others.
+ * Copyright (c) 2002, 2009 IBM Corporation 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
@@ -12,6 +12,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Represents a package declaration in a C translation unit.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface INamespace extends ICElement, IParent, ISourceManipulation, ISourceReference {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IOpenable.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2002, 2006 IBM Corporation and others.
+ * Copyright (c) 2002, 2009 IBM Corporation 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
@@ -16,6 +16,9 @@ import org.eclipse.core.runtime.IProgressMonitor;
 /**
  * An openable is an element that can be opened, saved, and closed.
  * An openable might or might not have an associated buffer.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IOpenable extends IBufferChangedListener{
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IOutputEntry.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -15,7 +15,8 @@ import org.eclipse.core.runtime.IPath;
 
 
 /**
- * IOuputEntry
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IOutputEntry extends IPathEntry {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IPathEntryContainer.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -14,7 +14,8 @@ package org.eclipse.cdt.core.model;
 import org.eclipse.core.runtime.IPath;
 
 /**
- * @author alain
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients. 
  */
 public interface IPathEntryContainer {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IPathEntryContainerExtension.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2005 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -14,7 +14,8 @@ package org.eclipse.cdt.core.model;
 import org.eclipse.core.runtime.IPath;
 
 /**
- * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IPathEntryContainerExtension extends IPathEntryContainer {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IProjectEntry.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -11,7 +11,10 @@
 package org.eclipse.cdt.core.model;
 
 
-
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface IProjectEntry extends IPathEntry {
 
 }

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IRegion.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2002, 2005 QNX Software Systems and others.
+ * Copyright (c) 2002, 2009 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
@@ -24,9 +24,8 @@ package org.eclipse.cdt.core.model;
  * are considered to be included. Children of an included element 
  * <b>cannot</b> be selectively excluded.
  * </p>
- * <p>
+ * @noextend This interface is not intended to be extended by clients.
- * This interface is not intended to be implemented by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
- * </p>
  */
 public interface IRegion {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ISourceEntry.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -12,6 +12,10 @@ package org.eclipse.cdt.core.model;
 
 import org.eclipse.core.runtime.IPath;
 
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface ISourceEntry extends IPathEntry {
 
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ISourceManipulation.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -16,6 +16,9 @@ import org.eclipse.core.runtime.IProgressMonitor;
 /**
  * Common protocol for C elements that support source code manipulations such
  * as copy, move, rename, and delete.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ISourceManipulation {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ISourceRange.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -13,6 +13,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * A source range defines an element's source coordinates
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ISourceRange {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ISourceReference.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -17,6 +17,8 @@ package org.eclipse.cdt.core.model;
  * derived from a binary type, the implementation returns source iff the
  * element has attached source code and debuging information.
  *
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 
 public interface ISourceReference {

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ISourceRoot.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -15,7 +15,8 @@ import org.eclipse.core.resources.IResource;
 import org.eclipse.core.runtime.IPath;
 
 /**
- * ISourceRoot
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ISourceRoot extends ICContainer {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IStructure.java

@@ -1,5 +1,5 @@
 /**********************************************************************
- * Copyright (c) 2002, 2005 IBM Corporation and others.
+ * Copyright (c) 2002, 2009 IBM Corporation 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
@@ -13,6 +13,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Represent struct(ure), class or union.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IStructure extends IInheritance, IParent, IStructureDeclaration {
 	public IField getField(String name);

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IStructureDeclaration.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2002, 2005 QNX Software Systems and others.
+ * Copyright (c) 2002, 2009 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
@@ -12,7 +12,8 @@
 package org.eclipse.cdt.core.model;
 
 /**
- * IStructureDeclaration
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IStructureDeclaration extends IDeclaration {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IStructureTemplate.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005 QnX Software Systems and others.
+ * Copyright (c) 2005, 2009 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
@@ -13,8 +13,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Class template definition.
- * IStructureTemplate
  *
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IStructureTemplate extends IStructureTemplateDeclaration, IStructure {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IStructureTemplateDeclaration.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005 QnX Software Systems and others.
+ * Copyright (c) 2005, 2009 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
@@ -13,9 +13,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Class template declaration.
- * 
- * IStructureTemplateDeclaration
  *
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IStructureTemplateDeclaration extends ITemplate, IStructureDeclaration {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ITemplate.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2001, 2005 IBM Corporation and others.
+ * Copyright (c) 2001, 2009 IBM Corporation 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
@@ -9,6 +9,11 @@
  *     Rational Software - initial implementation
  *******************************************************************************/
 package org.eclipse.cdt.core.model;
+
+/**
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
 public interface ITemplate {
 	/**
 	 * Returns the template parameter types.

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ITypeDef.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2007 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -12,6 +12,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Represents a field declared in a type.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ITypeDef extends ICElement, ISourceManipulation, ISourceReference {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IUsing.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2005 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -12,6 +12,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Represents a "using" declaration in C  translation unit.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IUsing extends ICElement, ISourceManipulation, ISourceReference {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IVariable.java

@@ -1,5 +1,5 @@
 /**********************************************************************
- * Copyright (c) 2002, 2005 IBM Corporation and others.
+ * Copyright (c) 2002, 2009 IBM Corporation 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
@@ -12,6 +12,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Represents a global variable.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IVariable extends IVariableDeclaration {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IVariableDeclaration.java

@@ -1,5 +1,5 @@
 /**********************************************************************
- * Copyright (c) 2002, 2005 IBM Corporation and others.
+ * Copyright (c) 2002, 2009 IBM Corporation 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
@@ -12,6 +12,9 @@ package org.eclipse.cdt.core.model;
 
 /**
  * Represents the declaration of a variable.
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface IVariableDeclaration extends IDeclaration {
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IWorkingCopy.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2002, 2006 IBM Corporation and others.
+ * Copyright (c) 2002, 2009 IBM Corporation 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
@@ -46,6 +46,8 @@ import org.eclipse.core.runtime.IProgressMonitor;
  * A working copy cannot be created from another working copy.
  * Calling <code>getWorkingCopy</code> on a working copy returns the receiver.
  * </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 IWorkingCopy extends ITranslationUnit{
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/LanguageManager.java

@@ -1,12 +1,12 @@
 /*******************************************************************************
- * Copyright (c) 2005, 2008 QNX Software Systems and others.
+ * Copyright (c) 2005, 2009 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 - Initial API and implementation
+ *     Doug Schaefer (QNX) - Initial API and implementation
  *     Markus Schorn (Wind River Systems)
  *     IBM Corporation
  *     		- Language managment feature (see Bugzilla 151850)
@@ -50,8 +50,8 @@ import org.eclipse.core.runtime.content.IContentType;
 import org.eclipse.core.runtime.content.IContentTypeManager;
 
 /**
- * @author Doug Schaefer
+ * @noextend This interface is not intended to be extended by clients.
- *
+ * @noinstantiate This class is not intended to be instantiated by clients.
  */
 public class LanguageManager {
 	private static final String NAMESPACE_SEPARATOR = "."; //$NON-NLS-1$
@@ -288,6 +288,11 @@ public class LanguageManager {
 		return contentTypeId != null && getLanguageForContentTypeID(contentTypeId) != null;
 	}
 	
+	/**
+	 * @deprecated use {@link #getContributedModelBuilderFor(ITranslationUnit)}, instead.
+	 * @noreference This method is not intended to be referenced by clients.
+	 */
+	@Deprecated
 	public IContributedModelBuilder getContributedModelBuilderFor(TranslationUnit tu) {
 		try {
 			ILanguage lang = tu.getLanguage();
@@ -296,7 +301,19 @@ public class LanguageManager {
 			return null;
 		}
 	}
-	
+
+	/**
+	 * @since 5.1
+	 */
+	public IContributedModelBuilder getContributedModelBuilderFor(ITranslationUnit tu) {
+		try {
+			ILanguage lang = tu.getLanguage();
+			return lang == null ? null : lang.createModelBuilder(tu);
+		} catch (CoreException e) {
+			return null;
+		}
+	}
+
 	/**
 	 * Returns mappings between IDs and IPDOMLinkageFactory. The IDs are defined in {@link ILinkage}. 
 	 * @return a map.
@@ -407,7 +424,7 @@ public class LanguageManager {
 		
 		// Notify listeners that the language mappings have changed.
 		LanguageMappingChangeEvent event = new LanguageMappingChangeEvent();
-		event.setType(LanguageMappingChangeEvent.TYPE_WORKSPACE);
+		event.setType(ILanguageMappingChangeEvent.TYPE_WORKSPACE);
 		event.setAffectedContentTypes(affectedContentTypes);
 		notifyLanguageChangeListeners(event);
 	}
@@ -451,7 +468,7 @@ public class LanguageManager {
 		
 		// Notify listeners that the language mappings have changed.
 		LanguageMappingChangeEvent event = new LanguageMappingChangeEvent();
-		event.setType(LanguageMappingChangeEvent.TYPE_PROJECT);
+		event.setType(ILanguageMappingChangeEvent.TYPE_PROJECT);
 		event.setProject(project);
 		event.setAffectedContentTypes(affectedContentTypes);
 		notifyLanguageChangeListeners(event);
@@ -620,7 +637,7 @@ public class LanguageManager {
 		
 		// Notify listeners that the language mappings have changed.
 		LanguageMappingChangeEvent event = new LanguageMappingChangeEvent();
-		event.setType(LanguageMappingChangeEvent.TYPE_FILE);
+		event.setType(ILanguageMappingChangeEvent.TYPE_FILE);
 		event.setProject(project);
 		event.setFile(file);
 		notifyLanguageChangeListeners(event);

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/LanguageMappingChangeEvent.java

@@ -1,12 +1,12 @@
 /*******************************************************************************
- * Copyright (c) 2007, 2008 IBM Corporation and others.
+ * Copyright (c) 2007, 2009 IBM Corporation 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:
- *     IBM Corporation - initial API and implementation
+ *     Chris Recoskie (IBM Corporation) - initial API and implementation
  *******************************************************************************/
 package org.eclipse.cdt.core.model;
 
@@ -20,7 +20,8 @@ import org.eclipse.core.runtime.content.IContentType;
 /**
  * A minimal implementation of ILanguageMappingsChangeEvent.
  * 
- * @author crecoskie
+ * @noextend This interface is not intended to be extended by clients.
+ * @noinstantiate This class is not intended to be instantiated by clients. 
  */
 public class LanguageMappingChangeEvent implements ILanguageMappingChangeEvent {
 

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/PathEntryContainerChanged.java

@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2005 QNX Software Systems and others.
+ * Copyright (c) 2000, 2009 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
@@ -14,6 +14,8 @@ package org.eclipse.cdt.core.model;
 import org.eclipse.core.runtime.IPath;
 
 /**
+ * @noextend This class is not intended to be subclassed by clients.
+ * @noinstantiate This class is not intended to be instantiated by clients.
  */
 public class PathEntryContainerChanged  {
 

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

@@ -17,6 +17,9 @@ 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;