diff --git a/core/org.eclipse.cdt.core/browser/org/eclipse/cdt/core/browser/ITypeInfo.java b/core/org.eclipse.cdt.core/browser/org/eclipse/cdt/core/browser/ITypeInfo.java index f497895d19c..8de00e7e6bc 100644 --- a/core/org.eclipse.cdt.core/browser/org/eclipse/cdt/core/browser/ITypeInfo.java +++ b/core/org.eclipse.cdt.core/browser/org/eclipse/cdt/core/browser/ITypeInfo.java @@ -30,31 +30,31 @@ public interface ITypeInfo { }; /** - * Gets the CElement type. + * Returns the CElement type. * @return ICElement.C_NAMESPACE, C_CLASS, C_STRUCT, C_UNION, C_ENUMERATION, or C_TYPEDEF, * or zero if unknown type. */ public int getCElementType(); /** - * Gets the type name. + * Returns the type name. */ public String getName(); /** - * Gets the qualified type name. + * Returns the qualified type name. */ public IQualifiedTypeName getQualifiedTypeName(); /** - * Gets the originating locations where this type was declared. + * Returns the originating locations where this type was declared. * @return all known source references, or an empty * array if none found. */ public ITypeReference[] getReferences(); /** - * Gets the real location where type was declared. + * Returns the real location where type was declared. * * @return the parsed source reference (with offset and length), * or null if not found. @@ -62,7 +62,7 @@ public interface ITypeInfo { public ITypeReference getResolvedReference(); /** - * Gets the enclosing project. + * Returns the enclosing project. */ public ICProject getEnclosingProject(); diff --git a/core/org.eclipse.cdt.core/browser/org/eclipse/cdt/core/browser/ITypeInfoVisitor.java b/core/org.eclipse.cdt.core/browser/org/eclipse/cdt/core/browser/ITypeInfoVisitor.java index d202fbb2903..5c331c9e582 100644 --- a/core/org.eclipse.cdt.core/browser/org/eclipse/cdt/core/browser/ITypeInfoVisitor.java +++ b/core/org.eclipse.cdt.core/browser/org/eclipse/cdt/core/browser/ITypeInfoVisitor.java @@ -12,12 +12,10 @@ package org.eclipse.cdt.core.browser; /** * @deprecated not used anywhere - * @noimplement This interface is not intended to be implemented by clients. - * @noextend This interface is not intended to be extended by clients. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface ITypeInfoVisitor { - public boolean visit(ITypeInfo info); public boolean shouldContinue(); diff --git a/core/org.eclipse.cdt.core/browser/org/eclipse/cdt/core/browser/IWorkingCopyProvider.java b/core/org.eclipse.cdt.core/browser/org/eclipse/cdt/core/browser/IWorkingCopyProvider.java index c78f6ff373e..f5baa6fdfa7 100644 --- a/core/org.eclipse.cdt.core/browser/org/eclipse/cdt/core/browser/IWorkingCopyProvider.java +++ b/core/org.eclipse.cdt.core/browser/org/eclipse/cdt/core/browser/IWorkingCopyProvider.java @@ -14,6 +14,7 @@ import org.eclipse.cdt.core.model.IWorkingCopy; /** * @deprecated use {@link org.eclipse.cdt.core.model.IWorkingCopyProvider}, instead. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface IWorkingCopyProvider { diff --git a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ICElement.java b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ICElement.java index 56a7bc2ff15..1cb99ec7ee5 100644 --- a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ICElement.java +++ b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ICElement.java @@ -241,56 +241,56 @@ public interface ICElement extends IAdaptable { static final int ASM_LABEL= 94; /** - * Modifier indicating a class constructor * @deprecated use {@link IMethodDeclaration#isConstructor()} + * @noreference This field is not intended to be referenced by clients. */ @Deprecated static final int C_CLASS_CTOR = 0x100; /** - * Modifier indicating a class destructor * @deprecated use {@link IMethodDeclaration#isDestructor()} + * @noreference This field is not intended to be referenced by clients. */ @Deprecated static final int C_CLASS_DTOR = 0x200; /** - * Modifier indicating a static storage attribute * @deprecated use {@link IDeclaration#isStatic()} + * @noreference This field is not intended to be referenced by clients. */ @Deprecated static final int C_STORAGE_STATIC = 0x400; /** - * Modifier indicating an extern storage attribute * @deprecated not used anymore + * @noreference This field is not intended to be referenced by clients. */ @Deprecated static final int C_STORAGE_EXTERN = 0x800; /** - * Modifier indicating a private class * @deprecated use {@link IMember#getVisibility()} + * @noreference This field is not intended to be referenced by clients. */ @Deprecated static final int CPP_PRIVATE = 0x1000; /** - * Modifier indicating a public class * @deprecated use {@link IMember#getVisibility()} + * @noreference This field is not intended to be referenced by clients. */ @Deprecated static final int CPP_PUBLIC = 0x2000; /** - * Modifier indicating a protected class * @deprecated use {@link IMember#getVisibility()} + * @noreference This field is not intended to be referenced by clients. */ @Deprecated static final int CPP_PROTECTED = 0x4000; /** - * Modifier indicating a friend class * @deprecated use {@link IMethodDeclaration#isFriend()} + * @noreference This field is not intended to be referenced by clients. */ @Deprecated static final int CPP_FRIEND = 0x8000; diff --git a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IEnumeration.java b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IEnumeration.java index 2bc33a4f92f..939d08827e4 100644 --- a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IEnumeration.java +++ b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IEnumeration.java @@ -18,11 +18,9 @@ package org.eclipse.cdt.core.model; * @noimplement This interface is not intended to be implemented by clients. */ public interface IEnumeration extends IParent, IDeclaration { - /** - * Return "enum" - * @throws CModelException - * @deprecated + * @deprecated Useless method that always returns "enum". + * @noreference This method is not intended to be referenced by clients. */ @Deprecated String getTypeName() throws CModelException; diff --git a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ILanguage.java b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ILanguage.java index 214a39ad059..2f07b1a22fb 100644 --- a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ILanguage.java +++ b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ILanguage.java @@ -34,7 +34,6 @@ import org.eclipse.core.runtime.IAdaptable; * @noextend This interface is not intended to be extended by clients. */ public interface ILanguage extends IAdaptable { - /** * Option for {@link #getASTTranslationUnit(FileContent, IScannerInfo, IncludeFileContentProvider, IIndex, int, IParserLogService)} * Instructs the parser to skip function and method bodies. @@ -43,6 +42,7 @@ public interface ILanguage extends IAdaptable { /** * @deprecated, has no effect. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public final static int OPTION_ADD_COMMENTS= 0x2; @@ -143,12 +143,14 @@ public interface ILanguage extends IAdaptable { /** * @deprecated replaced by {@link IASTTranslationUnit#getNodeSelector(String)}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated IASTName[] getSelectedNames(IASTTranslationUnit ast, int start, int length); /** * @deprecated replaced by {@link #getASTTranslationUnit(FileContent, IScannerInfo, * IncludeFileContentProvider, IIndex, int, IParserLogService)} + * @noreference This method is not intended to be referenced by clients. */ @Deprecated IASTTranslationUnit getASTTranslationUnit(org.eclipse.cdt.core.parser.CodeReader reader, @@ -158,6 +160,7 @@ public interface ILanguage extends IAdaptable { /** * @deprecated replaced by {@link #getASTTranslationUnit(FileContent, IScannerInfo, * IncludeFileContentProvider, IIndex, int, IParserLogService)} + * @noreference This method is not intended to be referenced by clients. */ @Deprecated IASTTranslationUnit getASTTranslationUnit(org.eclipse.cdt.core.parser.CodeReader reader, @@ -167,6 +170,7 @@ public interface ILanguage extends IAdaptable { /** * @deprecated replaced by {@link #getCompletionNode(FileContent, IScannerInfo, * IncludeFileContentProvider, IIndex, IParserLogService, int)}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated IASTCompletionNode getCompletionNode(org.eclipse.cdt.core.parser.CodeReader reader, diff --git a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IStructureDeclaration.java b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IStructureDeclaration.java index 6a05a07017c..a8eccfaefcd 100644 --- a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IStructureDeclaration.java +++ b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/IStructureDeclaration.java @@ -39,8 +39,8 @@ public interface IStructureDeclaration extends IDeclaration { public boolean isStruct() throws CModelException; /** - * Return "class", "struct", "union" * @deprecated use isUnion(), isClass(), isStruct() + * @noreference This method is not intended to be referenced by clients. */ @Deprecated String getTypeName() throws CModelException; diff --git a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ITranslationUnit.java b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ITranslationUnit.java index a53df0c897c..8d7c321bf3f 100644 --- a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ITranslationUnit.java +++ b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/model/ITranslationUnit.java @@ -76,8 +76,9 @@ public interface ITranslationUnit extends ICElement, IParent, IOpenable, ISource public static final int AST_SKIP_IF_NO_BUILD_INFO = 0x8; /** - * @deprecated The option has no effect. * @since 4.0 + * @deprecated The option has no effect. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int AST_CREATE_COMMENT_NODES = 0x10; @@ -498,10 +499,12 @@ public interface ITranslationUnit extends ICElement, IParent, IOpenable, ISource @Deprecated IWorkingCopy getWorkingCopy(IProgressMonitor monitor, IBufferFactory factory) throws CModelException; /** * @deprecated don't use this method. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated Map parse(); /** * @deprecated, use {@link FileContent#create(ITranslationUnit)}, instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated org.eclipse.cdt.core.parser.CodeReader getCodeReader(); diff --git a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICConfigurationDescription.java b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICConfigurationDescription.java index ca61016973b..96a941db88c 100644 --- a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICConfigurationDescription.java +++ b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICConfigurationDescription.java @@ -13,7 +13,6 @@ package org.eclipse.cdt.core.settings.model; import java.util.Map; import org.eclipse.cdt.core.cdtvariables.ICdtVariablesContributor; -import org.eclipse.cdt.core.language.settings.providers.LanguageSettingsManager; import org.eclipse.cdt.core.model.CoreModel; import org.eclipse.cdt.core.settings.model.extension.CConfigurationData; import org.eclipse.cdt.core.settings.model.extension.CConfigurationDataProvider; @@ -371,13 +370,7 @@ public interface ICConfigurationDescription extends ICSettingContainer, ICSettin /** * @deprecated Deprecated as of CDT 8.1. This method returns settings supplied by MBS only. - * For most cases, more generic Language Settings Providers mechanism should be used instead, see - * {@link LanguageSettingsManager#getSettingEntriesByKind(ICConfigurationDescription, org.eclipse.core.resources.IResource, String, int)}. - * - * Convenience method to return a language setting for the file with the specified project-relative path. - * - * @param path - file project relative path - * @return ICLanguageSetting or null if not found + * @noreference This method is not intended to be referenced by clients. */ @Deprecated ICLanguageSetting getLanguageSettingForFile(IPath path, boolean ignoreExludeStatus); diff --git a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICDescriptionDelta.java b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICDescriptionDelta.java index 41edaf68cf2..9ef9441e904 100644 --- a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICDescriptionDelta.java +++ b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICDescriptionDelta.java @@ -54,9 +54,8 @@ public interface ICDescriptionDelta { int SOURCE_CONTENT_TYPE = 1 << 5; /** @since 5.4 */ int SOURCE_EXTENSIONS = 1 << 6; - /** @deprecated Use ICDescriptionDelta.SOURCE_EXTENSIONS */ - @Deprecated - int SOURCE_ENTENSIONS = SOURCE_EXTENSIONS; + /** @deprecated Use ICDescriptionDelta.SOURCE_EXTENSIONS @noreference This field is not intended to be referenced by clients. */ + @Deprecated int SOURCE_ENTENSIONS = SOURCE_EXTENSIONS; // int HEADER_CONTENT_TYPE = 1 << 7; // int HEADER_ENTENSIONS = 1 << 8; int SETTING_ENTRIES = 1 << 9; diff --git a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/internal/core/model/VariableInfo.java b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/internal/core/model/VariableInfo.java index cb1de9ae21c..6205fcb814c 100644 --- a/core/org.eclipse.cdt.core/model/org/eclipse/cdt/internal/core/model/VariableInfo.java +++ b/core/org.eclipse.cdt.core/model/org/eclipse/cdt/internal/core/model/VariableInfo.java @@ -8,11 +8,9 @@ * Contributors: * Rational Software - Initial API and implementation *******************************************************************************/ - package org.eclipse.cdt.internal.core.model; class VariableInfo extends SourceManipulationInfo { - String typeStr = ""; //$NON-NLS-1$ boolean isConst = false; boolean isVolatile = false; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ICodeReaderFactory.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ICodeReaderFactory.java index e6d8651705f..5b2a8f42d6d 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ICodeReaderFactory.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ICodeReaderFactory.java @@ -20,13 +20,11 @@ import org.eclipse.cdt.core.parser.IncludeFileContentProvider; * of a CodeReader. * * @author jcamelon - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. * @deprecated replaced by {@link IncludeFileContentProvider} + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface ICodeReaderFactory { - /** * @return unique identifier as int */ diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ILinkage.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ILinkage.java index e5652abe22c..1b7a064629e 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ILinkage.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ILinkage.java @@ -50,6 +50,7 @@ public interface ILinkage { /** * Additional linkage ids may be added in future. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated final static int MAX_LINKAGE_ID= FORTRAN_LINKAGE_ID; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/IName.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/IName.java index 42a769137b0..69d4eb07b79 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/IName.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/IName.java @@ -37,6 +37,7 @@ public interface IName { * index never contain qualification or template arguments, which is different * for names from the AST. * Use {@link #getSimpleID()}, instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public char[] toCharArray(); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/IPDOMManager.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/IPDOMManager.java index 874147d85d0..c80daa3bae3 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/IPDOMManager.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/IPDOMManager.java @@ -23,6 +23,7 @@ public interface IPDOMManager { public static final String ID_FAST_INDEXER= "org.eclipse.cdt.core.fastIndexer"; //$NON-NLS-1$ /** * @deprecated The full indexer has been removed. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final String ID_FULL_INDEXER= "org.eclipse.cdt.core.domsourceindexer"; //$NON-NLS-1$ diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/IParserConfiguration.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/IParserConfiguration.java index 08668524d87..1d0314d9dd5 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/IParserConfiguration.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/IParserConfiguration.java @@ -13,13 +13,8 @@ package org.eclipse.cdt.core.dom; import org.eclipse.cdt.core.parser.IScannerInfo; /** - * This interface represents a parser configuration as specified by the client - * to the parser service. - * - * @author jcamelon - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. * @deprecated Used only by other deprecated interfaces + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface IParserConfiguration { diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTArraySubscriptExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTArraySubscriptExpression.java index c97df6dd1dd..d20542af084 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTArraySubscriptExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTArraySubscriptExpression.java @@ -51,15 +51,15 @@ public interface IASTArraySubscriptExpression extends IASTExpression { public void setArgument(IASTInitializerClause expression); /** - * Returns the subscript expression, or null. Consider using {@link #getArgument()}. * @deprecated Replaced by {@link #getArgument()} + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IASTExpression getSubscriptExpression(); /** - * Not allowed on frozen ast. * @deprecated Replaced by {@link #setArgument(IASTInitializerClause)} + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void setSubscriptExpression(IASTExpression expression); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTAttributeOwner.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTAttributeOwner.java index bde39560135..279ff1e3927 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTAttributeOwner.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTAttributeOwner.java @@ -21,7 +21,10 @@ public interface IASTAttributeOwner extends IASTNode { /** @since 5.7 */ public static final ASTNodeProperty ATTRIBUTE_SPECIFIER = new ASTNodeProperty("IASTAttributeOwner.ATTRIBUTE_SPECIFIER"); //$NON-NLS-1$ - /** @deprecated Not used. */ + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final ASTNodeProperty ATTRIBUTE = new ASTNodeProperty("IASTAttributeOwner.ATTRIBUTE"); //$NON-NLS-1$ @@ -44,8 +47,9 @@ public interface IASTAttributeOwner extends IASTNode { public IASTAttribute[] getAttributes(); /** - * @deprecated Ignored. Attributes should not be assigned to nodes directly, but have to be - * wrapped by attribute specifiers. + * @deprecated Ignored. Attributes should not be assigned to nodes directly, + * but have to be wrapped by attribute specifiers. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void addAttribute(IASTAttribute attribute); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTAttributeSpecifier.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTAttributeSpecifier.java index 09763c96b4e..00aed867732 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTAttributeSpecifier.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTAttributeSpecifier.java @@ -25,15 +25,15 @@ public interface IASTAttributeSpecifier extends IASTNode { new ASTNodeProperty("IASTAttributeSpecifier.ATTRIBUTE"); //$NON-NLS-1$ /** - * Returns the attributes of the specifier. * @deprecated Use IASTAttributeList.getAttributes() instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public abstract IASTAttribute[] getAttributes(); /** - * Adds an attribute to the specifier. * @deprecated Use IASTAttributeList.addAttribute() instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public abstract void addAttribute(IASTAttribute attribute); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTBinaryExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTBinaryExpression.java index 35b9cb96b32..f2a98dd1e25 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTBinaryExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTBinaryExpression.java @@ -224,7 +224,8 @@ public interface IASTBinaryExpression extends IASTExpression { public static final int op_ellipses= 34; /** - * @deprecated all constants must be defined here, to avoid using the same value twice. + * @deprecated All constants must be defined here, to avoid using the same value twice. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int op_last = op_ellipses; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTDeclSpecifier.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTDeclSpecifier.java index 82253b43d93..ba7bdc8ef15 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTDeclSpecifier.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTDeclSpecifier.java @@ -13,7 +13,7 @@ package org.eclipse.cdt.core.dom.ast; /** * This is the base interface that represents a declaration specifier sequence. - * + * * @noextend This interface is not intended to be extended by clients. * @noimplement This interface is not intended to be implemented by clients. */ @@ -31,12 +31,14 @@ public interface IASTDeclSpecifier extends IASTNode { public static final int sc_mutable = 6; /** - * @since 5.10 + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + * @since 5.10 */ @Deprecated public static final ASTNodeProperty ALIGNMENT_SPECIFIER = new ASTNodeProperty( "IASTDeclSpecifier.ALIGNMENT_SPECIFIER - Alignment specifier"); //$NON-NLS-1$ - + /** * Returns the storage class, which is one of the constants sc_... */ @@ -53,16 +55,16 @@ public interface IASTDeclSpecifier extends IASTNode { // Function specifier public boolean isInline(); - + /** - * Get any alignment-specifiers in this decl-specifier sequence. * @deprecated Use ICASTDeclSpecifier.getAlignmentSpecifiers() for C code. * In C++ code, alignment specifiers are now stored in the attribute specifier sequence. + * @noreference This method is not intended to be referenced by clients. * @since 5.10 */ @Deprecated public IASTAlignmentSpecifier[] getAlignmentSpecifiers(); - + /** * @since 5.1 */ @@ -100,18 +102,19 @@ public interface IASTDeclSpecifier extends IASTNode { * Not allowed on frozen ast. */ public void setInline(boolean value); - + /** - * Not allowed on frozen ast. * @deprecated Use ICASTDeclSpecifier.setAlignmentSpecifiers() for C code. * In C++ code, alignment specifiers are now stored in the attribute specifier sequence. + * @noreference This method is not intended to be referenced by clients. * @since 5.10 */ @Deprecated public void setAlignmentSpecifiers(IASTAlignmentSpecifier[] alignmentSpecifiers); - + /** * @deprecated All constants must be defined in this interface. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int sc_last = sc_register; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTInitializerExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTInitializerExpression.java index ef4b1a0466e..be59ab36bc2 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTInitializerExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTInitializerExpression.java @@ -13,9 +13,8 @@ package org.eclipse.cdt.core.dom.ast; /** * This is an initializer that is simply an expression. * - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. * @deprecated Replaced by {@link IASTEqualsInitializer}. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface IASTInitializerExpression extends IASTEqualsInitializer { diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTInitializerList.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTInitializerList.java index 997e7aa4195..ada10a2872b 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTInitializerList.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTInitializerList.java @@ -58,12 +58,14 @@ public interface IASTInitializerList extends IASTInitializer, IASTInitializerCla /** * @deprecated Replaced by {@link #getClauses()}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IASTInitializer[] getInitializers(); /** * @deprecated Replaced by {@link #addClause(IASTInitializerClause)}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void addInitializer(IASTInitializer initializer); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTLabelStatement.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTLabelStatement.java index 016c3b12b90..7287812a240 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTLabelStatement.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTLabelStatement.java @@ -22,6 +22,7 @@ public interface IASTLabelStatement extends IASTStatement, IASTNameOwner { /** * @since 5.4 * @deprecated use {@link #EMPTY_ARRAY} instead + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final IASTStatement[] EMPTY_LABEL_STATEMENT_ARRAY = {}; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTLiteralExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTLiteralExpression.java index a69e39d9f31..2758d3384ee 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTLiteralExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTLiteralExpression.java @@ -39,8 +39,8 @@ public interface IASTLiteralExpression extends IASTExpression { public static final int lk_string_literal = 3; /** - * A constant defined for subclasses to extend from. - * @deprecated all possible values must be defined in {@link IASTLiteralExpression}. + * @deprecated All possible values must be defined in {@link IASTLiteralExpression}. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int lk_last = lk_string_literal; @@ -113,6 +113,7 @@ public interface IASTLiteralExpression extends IASTExpression { /** * @deprecated Replaced by {@link #setValue(char[])}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void setValue(String value); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTMacroExpansion.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTMacroExpansion.java index 7217e21da01..9c32c8c7fae 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTMacroExpansion.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTMacroExpansion.java @@ -13,6 +13,7 @@ package org.eclipse.cdt.core.dom.ast; /** * @deprecated, use IASTMacroExpansionLocation instead + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface IASTMacroExpansion extends IASTNodeLocation { diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTSimpleDeclSpecifier.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTSimpleDeclSpecifier.java index 8deb193b2a1..fcc2217bb40 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTSimpleDeclSpecifier.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTSimpleDeclSpecifier.java @@ -255,7 +255,8 @@ public interface IASTSimpleDeclSpecifier extends IASTDeclSpecifier { public void setDeclTypeExpression(IASTExpression expression); /** - * @deprecated all constants must be defined in this interface + * @deprecated All constants must be defined in this interface + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int t_last = t_double; // used only in subclasses diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTTranslationUnit.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTTranslationUnit.java index 4624609fef4..b748c474160 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTTranslationUnit.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTTranslationUnit.java @@ -59,6 +59,7 @@ public interface IASTTranslationUnit extends IASTDeclarationListOwner, IFileNomi /** * @deprecated names for macro expansions are nested inside of * {@link IASTPreprocessorMacroExpansion}. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final ASTNodeProperty EXPANSION_NAME = new ASTNodeProperty( @@ -150,6 +151,7 @@ public interface IASTTranslationUnit extends IASTDeclarationListOwner, IFileNomi /** * @deprecated use {@link #getNodeSelector(String)}, instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IASTNode selectNodeForLocation(String path, int offset, int length); @@ -241,7 +243,8 @@ public interface IASTTranslationUnit extends IASTDeclarationListOwner, IFileNomi public String getContainingFilename(int offset); /** - * @deprecated don't use it. + * @deprecated Use {@link #getLinkage()} instead + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public ParserLanguage getParserLanguage(); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTTypeIdExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTTypeIdExpression.java index cfc7a15e574..4189af30eca 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTTypeIdExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTTypeIdExpression.java @@ -167,6 +167,7 @@ public interface IASTTypeIdExpression extends IASTExpression { /** * @deprecated constants should be declared here, to avoid using the same constant in different * interfaces. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int op_last = op_alignof; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTUnaryExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTUnaryExpression.java index f56abc6307e..75ccc9ed2e3 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTUnaryExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IASTUnaryExpression.java @@ -102,6 +102,7 @@ public interface IASTUnaryExpression extends IASTExpression { /** * @deprecated Shall not be used, 'typeof something' is not an expression, it's a declaration specifier. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int op_typeof = 14; @@ -131,8 +132,8 @@ public interface IASTUnaryExpression extends IASTExpression { public static final int op_labelReference = 18; /** - * {@code op_last} is made available for subclasses. - * @deprecated all constants must be defined in this interface + * @deprecated All constants must be defined in this interface. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int op_last = op_alignOf; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IArrayType.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IArrayType.java index 83d0c27bbaa..6b5bbd3ac91 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IArrayType.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IArrayType.java @@ -35,8 +35,8 @@ public interface IArrayType extends IType { boolean hasSize(); /** - * Returns the expression that represents the size of this array - * @throws DOMException + * @deprecated Replaced by {@link #getSize()}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated IASTExpression getArraySizeExpression() throws DOMException; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IBasicType.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IBasicType.java index 8aa62bc2ec6..de3ee87decc 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IBasicType.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IBasicType.java @@ -81,44 +81,52 @@ public interface IBasicType extends IType { public boolean isImaginary(); /** - * @deprecated, use the type-safe version getKind(), instead. + * @deprecated Use the type-safe version getKind(), instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public int getType() throws DOMException; /** - * @deprecated, types don't have values. + * @deprecated Types don't have values. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IASTExpression getValue() throws DOMException; /** - * @deprecated, use the type-safe version getKind(), instead. + * @deprecated Use the type-safe version getKind(), instead. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int t_unspecified = IASTSimpleDeclSpecifier.t_unspecified; /** - * @deprecated, use the type-safe version getKind(), instead. + * @deprecated Use the type-safe version getKind(), instead. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int t_void = IASTSimpleDeclSpecifier.t_void; /** - * @deprecated, use the type-safe version getKind(), instead. + * @deprecated Use the type-safe version getKind(), instead. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int t_char = IASTSimpleDeclSpecifier.t_char; /** - * @deprecated, use the type-safe version getKind(), instead. + * @deprecated Use the type-safe version getKind(), instead. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int t_int = IASTSimpleDeclSpecifier.t_int; /** - * @deprecated, use the type-safe version getKind(), instead. + * @deprecated Use the type-safe version getKind(), instead. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int t_float = IASTSimpleDeclSpecifier.t_float; /** - * @deprecated, use the type-safe version getKind(), instead. + * @deprecated Use the type-safe version getKind(), instead. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int t_double = IASTSimpleDeclSpecifier.t_double; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/ILabel.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/ILabel.java index e8d50ec6e08..a34a8c38d73 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/ILabel.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/ILabel.java @@ -23,6 +23,7 @@ public interface ILabel extends IBinding { /** * @since 5.4 * @deprecated use {@link #EMPTY_ARRAY} instead + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final IBinding[] EMPTY_LABEL_ARRAY = {}; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IProblemBinding.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IProblemBinding.java index f32228839e0..658d6358c86 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IProblemBinding.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IProblemBinding.java @@ -65,6 +65,7 @@ public interface IProblemBinding extends IBinding, IScope, IType, ISemanticProbl /** * @deprecated, there may be additional problems. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int LAST_PROBLEM = 0x00E; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IScope.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IScope.java index f1d1b1ca88e..458a148b189 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IScope.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IScope.java @@ -58,6 +58,7 @@ public interface IScope { /** * @deprecated Use {{@link #find(String, IASTTranslationUnit)} + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IBinding[] find(String name); @@ -88,12 +89,14 @@ public interface IScope { /** * @deprecated Use {@link #getBindings(ScopeLookupData)} instead + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IBinding[] getBindings(IASTName name, boolean resolve, boolean prefixLookup); /** * @deprecated Use {@link #getBindings(ScopeLookupData)} instead + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IBinding[] getBindings(IASTName name, boolean resolve, boolean prefixLookup, diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IValue.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IValue.java index fcb40604109..31107ecce6e 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IValue.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/IValue.java @@ -42,12 +42,14 @@ public interface IValue { /** * @deprecated Returns an empty character array. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated char[] getInternalExpression(); /** * @deprecated Returns an empty array. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated IBinding[] getUnknownBindings(); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/c/ICASTDesignatedInitializer.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/c/ICASTDesignatedInitializer.java index 5f719b1574b..eaa53398e6b 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/c/ICASTDesignatedInitializer.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/c/ICASTDesignatedInitializer.java @@ -67,12 +67,14 @@ public interface ICASTDesignatedInitializer extends IASTInitializer, IASTInitial /** * @deprecated Replaced by {@link #getOperand()}; + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IASTInitializer getOperandInitializer(); /** * @deprecated Replaced by setOperand(); + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void setOperandInitializer(IASTInitializer rhs); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/c/ICASTSimpleDeclSpecifier.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/c/ICASTSimpleDeclSpecifier.java index 9bf4df67fe8..23858a3d351 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/c/ICASTSimpleDeclSpecifier.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/c/ICASTSimpleDeclSpecifier.java @@ -35,12 +35,14 @@ public interface ICASTSimpleDeclSpecifier extends IASTSimpleDeclSpecifier, ICAST /** * @deprecated Replaced by {@link IASTSimpleDeclSpecifier#t_bool}. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int t_Bool = t_bool; /** * @deprecated All constants must be defined in {@link IASTSimpleDeclSpecifier}. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int t_last = t_Bool; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/c/ICBasicType.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/c/ICBasicType.java index d7688b5d0bc..088d0fcbb90 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/c/ICBasicType.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/c/ICBasicType.java @@ -18,7 +18,8 @@ import org.eclipse.cdt.core.dom.ast.IBasicType; */ public interface ICBasicType extends IBasicType { /** - * @deprecated, use the type-safe version getKind(), instead. + * @deprecated Use the type-safe version getKind(), instead. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int t_Bool = ICASTSimpleDeclSpecifier.t_Bool; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTAmbiguousTemplateArgument.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTAmbiguousTemplateArgument.java index 9e523b508c3..0f46716e8f9 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTAmbiguousTemplateArgument.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTAmbiguousTemplateArgument.java @@ -40,12 +40,14 @@ public interface ICPPASTAmbiguousTemplateArgument extends IASTNode { /** * @deprecated Replaced by {@link #addExpression(IASTExpression)}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void addIdExpression(IASTExpression idExpression); /** * @deprecated Replaced by {@link #addIdExpression(IASTExpression)}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void addIdExpression(IASTIdExpression idExpression); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTBinaryExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTBinaryExpression.java index 7641e9b6c75..ab79efc9eb7 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTBinaryExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTBinaryExpression.java @@ -35,6 +35,7 @@ public interface ICPPASTBinaryExpression extends IASTBinaryExpression, ICPPASTEx /** * @deprecated all constants must be defined in {@link IASTBinaryExpression}, to avoid * duplicate usage of the same constant. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int op_last = IASTBinaryExpression.op_last; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTCompositeTypeSpecifier.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTCompositeTypeSpecifier.java index f336ce92549..85f261ec3a5 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTCompositeTypeSpecifier.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTCompositeTypeSpecifier.java @@ -59,9 +59,8 @@ public interface ICPPASTCompositeTypeSpecifier extends IASTCompositeTypeSpecifie public static final ICPPASTBaseSpecifier[] EMPTY_BASESPECIFIER_ARRAY = {}; /** - * Relation between base specifier and its name. - * - * @deprecated Use ICPPASTBaseSpecifier.NAME_SPECIFIER instead. + * @deprecated Use {@link ICPPASTBaseSpecifier#NAME_SPECIFIER} instead. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final ASTNodeProperty NAME = new ASTNodeProperty( @@ -90,9 +89,8 @@ public interface ICPPASTCompositeTypeSpecifier extends IASTCompositeTypeSpecifie public int getVisibility(); /** - * Returns the name of this specifier. - * * @deprecated Use getNameSpecifier() instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IASTName getName(); @@ -117,9 +115,8 @@ public interface ICPPASTCompositeTypeSpecifier extends IASTCompositeTypeSpecifie public ICPPASTBaseSpecifier copy(CopyStyle style); /** - * Sets the name for this specifier, not allowed on frozen AST. - * * @deprecated Use setNameSpecifier() instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void setName(IASTName name); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTConstructorChainInitializer.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTConstructorChainInitializer.java index 843a576fc86..51960ad7189 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTConstructorChainInitializer.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTConstructorChainInitializer.java @@ -74,12 +74,14 @@ public interface ICPPASTConstructorChainInitializer extends IASTInitializer, ICP /** * @deprecated Replaced by {@link #getInitializer()}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IASTExpression getInitializerValue(); /** * @deprecated Replaced by {@link #setInitializer(IASTInitializer)}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void setInitializerValue(IASTExpression expression); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTConstructorInitializer.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTConstructorInitializer.java index a3bc35c4cac..9a793439ee8 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTConstructorInitializer.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTConstructorInitializer.java @@ -58,16 +58,22 @@ public interface ICPPASTConstructorInitializer extends IASTInitializer { /** * @deprecated Replaced by {@link #getArguments()}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IASTExpression getExpression(); /** * @deprecated Replaced by {@link #setArguments(IASTInitializerClause[])}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void setExpression(IASTExpression expression); - + + /** + * @deprecated Use {@link #ARGUMENT} instead. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final ASTNodeProperty EXPRESSION = ARGUMENT; } diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTDeclSpecifier.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTDeclSpecifier.java index cb43c172d96..5b0657ba2b3 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTDeclSpecifier.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTDeclSpecifier.java @@ -110,7 +110,8 @@ public interface ICPPASTDeclSpecifier extends IASTDeclSpecifier, IASTAttributeOw public ICPPASTDeclSpecifier copy(CopyStyle style); /** - * @deprecated All constants must be defined in {@link IASTDeclSpecifier} + * @deprecated All constants must be defined in {@link IASTDeclSpecifier}. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int sc_last = sc_mutable; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTFunctionDeclarator.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTFunctionDeclarator.java index e551a15ece8..f167de18372 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTFunctionDeclarator.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTFunctionDeclarator.java @@ -174,20 +174,6 @@ public interface ICPPASTFunctionDeclarator extends IASTStandardFunctionDeclarato @Override public ICPPFunctionScope getFunctionScope(); - - @Deprecated - public static final ASTNodeProperty CONSTRUCTOR_CHAIN_MEMBER = new ASTNodeProperty( - "ICPPASTFunctionDeclarator.CONSTRUCTOR_CHAIN_MEMBER - Role of a Constructor Chain Initializer"); //$NON-NLS-1$ - - /** - * @deprecated use {@link ICPPASTFunctionDefinition#getMemberInitializers}, instead. - */ - @Deprecated - public ICPPASTConstructorChainInitializer[] getConstructorChain(); - - @Deprecated - public void addConstructorToChain(ICPPASTConstructorChainInitializer initializer); - /** * @since 5.1 */ @@ -207,15 +193,6 @@ public interface ICPPASTFunctionDeclarator extends IASTStandardFunctionDeclarato */ public boolean isOverride(); - /** - * Sets whether this function is declared override. - * - * @since 5.5 - * @deprecated Use addVirtSpecifier() instead. - */ - @Deprecated - public void setOverride(boolean isOverride); - /** * Returns whether this function is declared final. * @@ -223,15 +200,6 @@ public interface ICPPASTFunctionDeclarator extends IASTStandardFunctionDeclarato */ public boolean isFinal(); - /** - * Sets whether this function is declared final. - * - * @since 5.5 - * @deprecated Use addVirtSpecifier() instead. - */ - @Deprecated - public void setFinal(boolean isFinal); - /** * Returns the virt-specifiers of this function. * @since 5.7 @@ -243,4 +211,42 @@ public interface ICPPASTFunctionDeclarator extends IASTStandardFunctionDeclarato * @since 5.7 */ public void addVirtSpecifier(ICPPASTVirtSpecifier virtSpecifier); + + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ + @Deprecated + public static final ASTNodeProperty CONSTRUCTOR_CHAIN_MEMBER = new ASTNodeProperty( + "ICPPASTFunctionDeclarator.CONSTRUCTOR_CHAIN_MEMBER - Role of a Constructor Chain Initializer"); //$NON-NLS-1$ + + /** + * @deprecated Use {@link ICPPASTFunctionDefinition#getMemberInitializers}, instead. + * @noreference This method is not intended to be referenced by clients. + */ + @Deprecated + public ICPPASTConstructorChainInitializer[] getConstructorChain(); + + /** + * @deprecated Use {@link ICPPASTFunctionDefinition#addMemberInitializer(ICPPASTConstructorChainInitializer)}. + * @noreference This method is not intended to be referenced by clients. + */ + @Deprecated + public void addConstructorToChain(ICPPASTConstructorChainInitializer initializer); + + /** + * @since 5.5 + * @deprecated Use {@link #addVirtSpecifier(ICPPASTVirtSpecifier)} instead. + * @noreference This method is not intended to be referenced by clients. + */ + @Deprecated + public void setFinal(boolean isFinal); + + /** + * @since 5.5 + * @deprecated Use {@link #addVirtSpecifier(ICPPASTVirtSpecifier)} instead. + * @noreference This method is not intended to be referenced by clients. + */ + @Deprecated + public void setOverride(boolean isOverride); } diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTFunctionTryBlockDeclarator.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTFunctionTryBlockDeclarator.java index 1effa685b97..4045c6c6446 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTFunctionTryBlockDeclarator.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTFunctionTryBlockDeclarator.java @@ -15,7 +15,7 @@ import org.eclipse.cdt.core.dom.ast.ASTNodeProperty; /** * @deprecated, use {@link ICPPASTFunctionWithTryBlock}, instead. - * @noimplement This interface is not intended to be implemented by clients. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface ICPPASTFunctionTryBlockDeclarator extends ICPPASTFunctionDeclarator { diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTLiteralExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTLiteralExpression.java index 512c5845f39..f96c52f604a 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTLiteralExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTLiteralExpression.java @@ -38,6 +38,7 @@ public interface ICPPASTLiteralExpression extends IASTLiteralExpression, ICPPAST /** * @deprecated All constants must be defined in {@link IASTLiteralExpression}. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int lk_last = lk_false; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTNewExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTNewExpression.java index e0c38e9eba4..d078e76ce21 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTNewExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTNewExpression.java @@ -112,6 +112,7 @@ public interface ICPPASTNewExpression extends ICPPASTExpression, IASTImplicitNam /** * @deprecated the id-expressions are part of the type-id. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final ASTNodeProperty NEW_TYPEID_ARRAY_EXPRESSION = new ASTNodeProperty( @@ -119,36 +120,42 @@ public interface ICPPASTNewExpression extends ICPPASTExpression, IASTImplicitNam /** * @deprecated the id-expressions are part of the type-id. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IASTExpression[] getNewTypeIdArrayExpressions(); /** * @deprecated the id-expressions are part of the type-id + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void addNewTypeIdArrayExpression(IASTExpression expression); /** * @deprecated Replaced by {@link #getPlacementArguments()} + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IASTExpression getNewPlacement(); /** * @deprecated Replaced by {@link #setPlacementArguments(IASTInitializerClause[])} + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void setNewPlacement(IASTExpression expression); /** * @deprecated Replaced by {@link #getInitializer()} + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IASTExpression getNewInitializer(); /** * @deprecated Replaced by {@link #setInitializer(IASTInitializer)} + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void setNewInitializer(IASTExpression expression); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTQualifiedName.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTQualifiedName.java index e1607bea8d0..c6c42aacc93 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTQualifiedName.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTQualifiedName.java @@ -49,15 +49,12 @@ public interface ICPPASTQualifiedName extends ICPPASTName, IASTNameOwner { public void setLastName(ICPPASTName name); /** - * Returns all name segments. - * - * @return IASTName [] - * * @deprecated This cannot represent all qualified names in C++11, * where the first segment of a qualifier name may be a decltype-specifier. * Use {@link #getLastName()} and {@link #getQualifier()} instead. * If called on a name where a segment is a decltype-specifier, * UnsupportedOperationException is thrown. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IASTName[] getNames(); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTSimpleDeclSpecifier.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTSimpleDeclSpecifier.java index 504d19f96c0..986cd3b3abf 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTSimpleDeclSpecifier.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTSimpleDeclSpecifier.java @@ -34,6 +34,7 @@ public interface ICPPASTSimpleDeclSpecifier extends IASTSimpleDeclSpecifier, ICP /** * @deprecated all constants must be defined in {@link IASTSimpleDeclSpecifier}. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int t_last = t_wchar_t; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTSimpleTypeConstructorExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTSimpleTypeConstructorExpression.java index 7792f16bf64..681bebbeee2 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTSimpleTypeConstructorExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTSimpleTypeConstructorExpression.java @@ -73,48 +73,104 @@ public interface ICPPASTSimpleTypeConstructorExpression extends ICPPASTExpressio * @since 5.2 */ public void setInitializer(IASTInitializer initializer); - - + + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int t_unspecified = 0; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int t_void = 1; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int t_char = 2; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int t_int = 3; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int t_float = 4; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int t_double = 5; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int t_bool = 6; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int t_wchar_t = 7; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int t_short = 8; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int t_long = 9; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int t_signed = 10; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int t_unsigned = 11; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int t_last = t_unsigned; /** * @deprecated Replaced by {@link #getDeclSpecifier()}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public int getSimpleType(); /** * @deprecated Replaced by {@link #setDeclSpecifier(ICPPASTDeclSpecifier)} + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void setSimpleType(int value); /** * @deprecated Replaced by {@link #INITIALIZER}. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final ASTNodeProperty INITIALIZER_VALUE = INITIALIZER; /** * @deprecated Replaced by {@link #getInitializer()} + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IASTExpression getInitialValue(); /** * @deprecated Replaced by {@link #setInitializer(IASTInitializer)} + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void setInitialValue(IASTExpression expression); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTemplateDeclaration.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTemplateDeclaration.java index dc30bee4fe4..6c79bc9b40d 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTemplateDeclaration.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTemplateDeclaration.java @@ -68,7 +68,8 @@ public interface ICPPASTTemplateDeclaration extends IASTDeclaration { public void addTemplateParameter(ICPPASTTemplateParameter paramm); /** - * @deprecated Use addTemplateParameter. + * @deprecated Use {@link #addTemplateParameter(ICPPASTTemplateParameter)}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void addTemplateParamter(ICPPASTTemplateParameter paramm); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTemplatedTypeTemplateParameter.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTemplatedTypeTemplateParameter.java index 47a0a5137b5..b6901bae13d 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTemplatedTypeTemplateParameter.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTemplatedTypeTemplateParameter.java @@ -101,7 +101,8 @@ public interface ICPPASTTemplatedTypeTemplateParameter extends ICPPASTTemplatePa public ICPPScope asScope(); /** - * @deprecated Use {@link #addTemplateParameter(ICPPASTTemplateParameter)}; + * @deprecated Use {@link #addTemplateParameter(ICPPASTTemplateParameter)} + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public void addTemplateParamter(ICPPASTTemplateParameter parm); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTranslationUnit.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTranslationUnit.java index 1bc06662816..4ae1f56db9e 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTranslationUnit.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTranslationUnit.java @@ -27,6 +27,7 @@ public interface ICPPASTTranslationUnit extends IASTTranslationUnit { /** * @deprecated Use {@link #getGlobalNamespace()} + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IBinding resolveBinding(); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTypeIdExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTypeIdExpression.java index f353681f655..41050f2f120 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTypeIdExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTypeIdExpression.java @@ -22,6 +22,7 @@ public interface ICPPASTTypeIdExpression extends IASTTypeIdExpression, ICPPASTEx /** * @deprecated all constants should be declared in {@link IASTTypeIdExpression} + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int op_last = IASTTypeIdExpression.op_last; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTypenameExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTypenameExpression.java index 46eb76a4a49..4d653eb87e4 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTypenameExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTTypenameExpression.java @@ -17,13 +17,11 @@ import org.eclipse.cdt.core.dom.ast.IASTName; import org.eclipse.cdt.core.dom.ast.IASTNameOwner; /** - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. * @deprecated Unified with {@link ICPPASTSimpleTypeConstructorExpression}. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface ICPPASTTypenameExpression extends ICPPASTSimpleTypeConstructorExpression, IASTNameOwner { - /** * Was template token consumed? * diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTUnaryExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTUnaryExpression.java index 38d4f254407..621552a01cc 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTUnaryExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPASTUnaryExpression.java @@ -31,7 +31,8 @@ public interface ICPPASTUnaryExpression extends IASTUnaryExpression, ICPPASTExpr public static final int op_typeid = IASTUnaryExpression.op_typeid; /** - * @deprecated all constants to be defined in {@link IASTUnaryExpression} + * @deprecated All constants to be defined in {@link IASTUnaryExpression} + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int op_last = IASTUnaryExpression.op_last; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPBase.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPBase.java index 41a306403a7..3f46543ac0e 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPBase.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPBase.java @@ -46,6 +46,7 @@ public interface ICPPBase extends Cloneable { /** * @deprecated Don't use it, a base class may be specified without the use of a name. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IName getBaseClassSpecifierName(); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPBasicType.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPBasicType.java index f7cb2d7bd8f..3093eaab649 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPBasicType.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPBasicType.java @@ -20,26 +20,29 @@ import org.eclipse.cdt.core.dom.ast.IBasicType; public interface ICPPBasicType extends IBasicType { /** * @deprecated, don't use the constant, more flags may be added for supporting future c++ standards. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int LAST = IS_LONG_LONG; /** - * @return a combination of qualifiers. * @since 4.0 * @deprecated use {@link #getModifiers()}, instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public int getQualifierBits(); /** - * @deprecated, use the type-safe version getKind(), instead. + * @deprecated Use the type-safe version getKind(), instead. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int t_bool = ICPPASTSimpleDeclSpecifier.t_bool; /** - * @deprecated, use the type-safe version getKind(), instead. + * @deprecated Use the type-safe version getKind(), instead. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int t_wchar_t = ICPPASTSimpleDeclSpecifier.t_wchar_t; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPClassSpecialization.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPClassSpecialization.java index 200ed860f39..cd970e2a291 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPClassSpecialization.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPClassSpecialization.java @@ -28,6 +28,7 @@ public interface ICPPClassSpecialization extends ICPPTypeSpecialization, ICPPCla /** * @deprecated Specializing a member may require a point of instantiation. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated IBinding specializeMember(IBinding binding); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPClassTemplatePartialSpecialization.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPClassTemplatePartialSpecialization.java index bf101887f84..11816541980 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPClassTemplatePartialSpecialization.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPClassTemplatePartialSpecialization.java @@ -25,7 +25,10 @@ package org.eclipse.cdt.core.dom.ast.cpp; public interface ICPPClassTemplatePartialSpecialization extends ICPPClassTemplate, ICPPPartialSpecialization { /** @since 6.0 */ public static final ICPPClassTemplatePartialSpecialization[] EMPTY_ARRAY = {}; - /** @deprecated Use {@link #EMPTY_ARRAY} */ + /** + * @deprecated Use {@link #EMPTY_ARRAY} + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final ICPPClassTemplatePartialSpecialization[] EMPTY_PARTIAL_SPECIALIZATION_ARRAY = EMPTY_ARRAY; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPDeferredTemplateInstance.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPDeferredTemplateInstance.java index 9a1682c4083..b705d2e67d2 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPDeferredTemplateInstance.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPDeferredTemplateInstance.java @@ -15,6 +15,7 @@ import org.eclipse.cdt.internal.core.dom.parser.cpp.ICPPDeferredClassInstance; /** * @deprecated use {@link ICPPDeferredClassInstance} instead. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface ICPPDeferredTemplateInstance extends ICPPTemplateInstance { diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPTemplateNonTypeParameter.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPTemplateNonTypeParameter.java index 7b2598377e1..3a19a41d243 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPTemplateNonTypeParameter.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/cpp/ICPPTemplateNonTypeParameter.java @@ -22,6 +22,7 @@ import org.eclipse.cdt.core.dom.ast.IASTExpression; public interface ICPPTemplateNonTypeParameter extends ICPPTemplateParameter, ICPPVariable { /** * @deprecated, use {@link ICPPTemplateParameter#getDefaultValue()}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IASTExpression getDefault(); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/IGCCASTAttributeSpecifier.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/IGCCASTAttributeSpecifier.java index e0e7cc9e1db..3c430fc3d29 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/IGCCASTAttributeSpecifier.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/IGCCASTAttributeSpecifier.java @@ -15,12 +15,9 @@ import org.eclipse.cdt.core.dom.ast.IASTAttributeSpecifier; import org.eclipse.cdt.core.parser.util.InstanceOfPredicate; /** - * Represents a GCC attribute specifier, introduced by __attribute__. - * - * @deprecated Use IGCCASTAttributeList instead. - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. * @since 5.7 + * @deprecated Use IGCCASTAttributeList instead. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface IGCCASTAttributeSpecifier extends IASTAttributeSpecifier { diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/IGNUASTTypeIdExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/IGNUASTTypeIdExpression.java index d85bc956129..0366ea71181 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/IGNUASTTypeIdExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/IGNUASTTypeIdExpression.java @@ -14,12 +14,8 @@ package org.eclipse.cdt.core.dom.ast.gnu; import org.eclipse.cdt.core.dom.ast.IASTTypeIdExpression; /** - * There are GNU language extensions that apply to both GCC and G++. Unary - * expressions for _alignOf() and typeof() along the lines of sizeof(). - * - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. * @deprecated Use {@link IASTTypeIdExpression}, instead. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface IGNUASTTypeIdExpression extends IASTTypeIdExpression { diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/IGNUASTUnaryExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/IGNUASTUnaryExpression.java index d23eadd9f71..d8ee88ebaac 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/IGNUASTUnaryExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/IGNUASTUnaryExpression.java @@ -14,13 +14,10 @@ import org.eclipse.cdt.core.dom.ast.IASTUnaryExpression; /** * @deprecated Replaced by {@link IASTUnaryExpression}. - * - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface IGNUASTUnaryExpression extends IASTUnaryExpression { - /** * @since 5.1 */ diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/c/IGCCASTSimpleDeclSpecifier.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/c/IGCCASTSimpleDeclSpecifier.java index bff5206aef8..91c597d3a7f 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/c/IGCCASTSimpleDeclSpecifier.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/c/IGCCASTSimpleDeclSpecifier.java @@ -16,13 +16,11 @@ import org.eclipse.cdt.core.dom.ast.IASTSimpleDeclSpecifier; import org.eclipse.cdt.core.dom.ast.c.ICASTSimpleDeclSpecifier; /** - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. * @deprecated Everything can be expressed as {@link ICASTSimpleDeclSpecifier}. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface IGCCASTSimpleDeclSpecifier extends ICASTSimpleDeclSpecifier { - /** * @deprecated Replaced by {@link IASTSimpleDeclSpecifier#t_typeof}. */ diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTBinaryExpression.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTBinaryExpression.java index feddb23249d..1d090ab3b93 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTBinaryExpression.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTBinaryExpression.java @@ -31,8 +31,9 @@ public interface IGPPASTBinaryExpression extends ICPPASTBinaryExpression { public static final int op_min = IASTBinaryExpression.op_min; /** - * @deprecated all constants must be defined in {@link IASTBinaryExpression} to avoid + * @deprecated All constants must be defined in {@link IASTBinaryExpression} to avoid * using a constant twice. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int op_last = IASTBinaryExpression.op_last; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTDeclSpecifier.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTDeclSpecifier.java index 32c966e4ce0..0d0495faaea 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTDeclSpecifier.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTDeclSpecifier.java @@ -13,11 +13,8 @@ package org.eclipse.cdt.core.dom.ast.gnu.cpp; import org.eclipse.cdt.core.dom.ast.IASTDeclSpecifier; /** - * G++ allows for restrict to be a modifier for the decl spec. - * - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. * @deprecated Replaced by {@link IASTDeclSpecifier}. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface IGPPASTDeclSpecifier extends IASTDeclSpecifier { diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTExplicitTemplateInstantiation.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTExplicitTemplateInstantiation.java index a6bb15867da..45960748048 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTExplicitTemplateInstantiation.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTExplicitTemplateInstantiation.java @@ -13,16 +13,11 @@ package org.eclipse.cdt.core.dom.ast.gnu.cpp; import org.eclipse.cdt.core.dom.ast.cpp.ICPPASTExplicitTemplateInstantiation; /** - * G++ allows for instantiations to be qualified w/modifiers for scoping. * @deprecated Replaced by {@link ICPPASTExplicitTemplateInstantiation} - * - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated -public interface IGPPASTExplicitTemplateInstantiation extends - ICPPASTExplicitTemplateInstantiation { - +public interface IGPPASTExplicitTemplateInstantiation extends ICPPASTExplicitTemplateInstantiation { /** * ti_static implies 'static' keyword is used. */ diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTPointer.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTPointer.java index 5a2f93ba43c..0372b59a5d3 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTPointer.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTPointer.java @@ -13,12 +13,11 @@ package org.eclipse.cdt.core.dom.ast.gnu.cpp; import org.eclipse.cdt.core.dom.ast.IASTPointer; /** - * @noimplement This interface is not intended to be implemented by clients. * @deprecated Use {@link IASTPointer}, instead. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface IGPPASTPointer extends IASTPointer { - /** * @since 5.1 */ diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTPointerToMember.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTPointerToMember.java index 2a8fb3c70e5..b8021ff1b8b 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTPointerToMember.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTPointerToMember.java @@ -13,12 +13,11 @@ package org.eclipse.cdt.core.dom.ast.gnu.cpp; import org.eclipse.cdt.core.dom.ast.cpp.ICPPASTPointerToMember; /** - * @noimplement This interface is not intended to be implemented by clients. * @deprecated Use {@link ICPPASTPointerToMember}, instead. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface IGPPASTPointerToMember extends IGPPASTPointer, ICPPASTPointerToMember { - /** * @since 5.1 */ diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTSimpleDeclSpecifier.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTSimpleDeclSpecifier.java index 159448c9b98..c506b56b773 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTSimpleDeclSpecifier.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPASTSimpleDeclSpecifier.java @@ -16,11 +16,8 @@ import org.eclipse.cdt.core.dom.ast.IASTSimpleDeclSpecifier; import org.eclipse.cdt.core.dom.ast.cpp.ICPPASTSimpleDeclSpecifier; /** - * G++ adds its own modifiers and types to the Simple Decl Specifier. - * - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. * @deprecated Replaced by {@link ICPPASTSimpleDeclSpecifier}. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface IGPPASTSimpleDeclSpecifier extends IGPPASTDeclSpecifier, ICPPASTSimpleDeclSpecifier { diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPBasicType.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPBasicType.java index 9b957758c7d..1377a8d3a46 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPBasicType.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPBasicType.java @@ -15,14 +15,11 @@ import org.eclipse.cdt.core.dom.ast.IType; import org.eclipse.cdt.core.dom.ast.cpp.ICPPBasicType; /** - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. * @deprecated use {@link ICPPBasicType}, instead. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface IGPPBasicType extends ICPPBasicType { - - /** * @deprecated don't use this constant. */ diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPPointerToMemberType.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPPointerToMemberType.java index 4373748b855..7fe9b7453c7 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPPointerToMemberType.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPPointerToMemberType.java @@ -13,12 +13,9 @@ package org.eclipse.cdt.core.dom.ast.gnu.cpp; import org.eclipse.cdt.core.dom.ast.cpp.ICPPPointerToMemberType; /** - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. * @deprecated Use {@link ICPPPointerToMemberType}, instead. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated -public interface IGPPPointerToMemberType extends ICPPPointerToMemberType, - IGPPPointerType { - +public interface IGPPPointerToMemberType extends ICPPPointerToMemberType, IGPPPointerType { } diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPPointerType.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPPointerType.java index c44308d84cf..0db7089f956 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPPointerType.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ast/gnu/cpp/IGPPPointerType.java @@ -13,9 +13,8 @@ package org.eclipse.cdt.core.dom.ast.gnu.cpp; import org.eclipse.cdt.core.dom.ast.IPointerType; /** - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. * @deprecated Use {@link IPointerType}, instead. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface IGPPPointerType extends IPointerType { diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/parser/IScannerExtensionConfiguration.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/parser/IScannerExtensionConfiguration.java index e729c8f5a5e..d14e4d558d7 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/parser/IScannerExtensionConfiguration.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/parser/IScannerExtensionConfiguration.java @@ -24,11 +24,10 @@ import org.eclipse.cdt.core.parser.util.CharArrayIntMap; * @noextend This interface is not intended to be extended by clients. */ public interface IScannerExtensionConfiguration { - /** - * @return true, if macros should be initialized to 1 * @deprecated empty macros are taken as they are. It is the task of configuration to provide the correct values. * See https://bugs.eclipse.org/bugs/show_bug.cgi?id=215789 + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public boolean initializeMacroValuesTo1(); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/parser/c/ICParserExtensionConfiguration.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/parser/c/ICParserExtensionConfiguration.java index 568b37bc9cf..ce4778b47fd 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/parser/c/ICParserExtensionConfiguration.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/parser/c/ICParserExtensionConfiguration.java @@ -118,12 +118,8 @@ public interface ICParserExtensionConfiguration { public boolean supportFunctionStyleAssembler(); /** - * See http://gcc.gnu.org/onlinedocs/gcc/Other-Builtins.html for more - * information on GCC's Other Built-in Symbols. - * - * @return true if support for the extension should be - * enabled * @deprecated use {@link #getBuiltinBindingsProvider()} instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public boolean supportGCCOtherBuiltinSymbols(); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/parser/cpp/ICPPParserExtensionConfiguration.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/parser/cpp/ICPPParserExtensionConfiguration.java index ba2c88a5f96..7bc92a2719b 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/parser/cpp/ICPPParserExtensionConfiguration.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/parser/cpp/ICPPParserExtensionConfiguration.java @@ -163,18 +163,21 @@ public interface ICPPParserExtensionConfiguration { /** * @deprecated use {@link #getBuiltinBindingsProvider()} instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public boolean supportGCCOtherBuiltinSymbols(); /** * @deprecated use {@link IScannerExtensionConfiguration#supportMinAndMaxOperators()}, instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public boolean supportMinAndMaxOperators(); /** * @deprecated configure extra keywords, via {@link IScannerExtensionConfiguration#getAdditionalKeywords()} + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public boolean supportRestrictKeyword(); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/index/IIndex.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/index/IIndex.java index 6234e2e3f11..450bfd4231c 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/index/IIndex.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/index/IIndex.java @@ -132,16 +132,9 @@ public interface IIndex { public long getLastWriteAccess(); /** - * Returns the file object for the given location and linkage or {@code null} if the file - * was not indexed in this linkage. - *

- * When a header file is stored in the index in multiple variants for different sets of macro - * definitions, this method will return an arbitrary one of these variants. - * @param location an IIndexFileLocation representing the location of the file - * @return the file in the index or {@code null} - * @throws CoreException * @deprecated Use {@link #getFile(int, IIndexFileLocation, ISignificantMacros)} or * {@link #getFiles(int, IIndexFileLocation)}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public IIndexFile getFile(int linkageID, IIndexFileLocation location) throws CoreException; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/index/IIndexFile.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/index/IIndexFile.java index e83efee13b9..2a65f694c61 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/index/IIndexFile.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/index/IIndexFile.java @@ -78,14 +78,16 @@ public interface IIndexFile extends IFileNomination { long getContentsHash() throws CoreException; /** - * @deprecated Returns 0. + * @deprecated Returns 0. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated int getScannerConfigurationHashcode() throws CoreException; /** * @since 5.3 - * @deprecated Returns 0. + * @deprecated Returns 0. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated int getEncodingHashcode() throws CoreException; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/index/IIndexManager.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/index/IIndexManager.java index e1a9864a567..050afa41ac3 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/index/IIndexManager.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/index/IIndexManager.java @@ -45,6 +45,7 @@ public interface IIndexManager extends IPDOMManager { /** * @deprecated Extension fragments are now used depending on their configuration. * Use one of the ADD_EXTENSION_XX flags instead. + * @noreference This field is not intended to be referenced by clients. */ @Deprecated public static final int SKIP_PROVIDED = 0x4; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/ICodeReaderCache.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/ICodeReaderCache.java index df46fbd8f9f..4f230ae104a 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/ICodeReaderCache.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/ICodeReaderCache.java @@ -20,18 +20,16 @@ import org.eclipse.core.runtime.CoreException; * * For thread safety the implementations of this interface must ensure that their methods are thread safe. * - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. * @deprecated + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface ICodeReaderCache { - /** * Retrieves the CodeReader corresponding to the key specified that represents the * path for that CodeReader. If no CodeReader is found in the cache then a new CodeReader * is created for the path and then returned. - * + * * @param key the path corresponding to the CodeReader, generally: * fileToParse.getLocation().toOSString() * @return the CodeReader corresponding to the path specified by the key diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IProblem.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IProblem.java index 311b49bf959..17c35141843 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IProblem.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IProblem.java @@ -356,68 +356,190 @@ public interface IProblem { */ public final static int MISSING_SEMICOLON = SYNTAX_RELATED | 0x002; - - + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public final static int SEMANTICS_RELATED = 0x08000000; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public final static String A_PREPROC_POUND_ERROR = ""; //$NON-NLS-1$ + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public final static String A_PREPROC_POUND_WARNING = ""; //$NON-NLS-1$ + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public final static String A_PREPROC_INCLUDE_FILENAME = ""; //$NON-NLS-1$ + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public final static String A_PREPROC_MACRO_NAME = ""; //$NON-NLS-1$ + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public final static String A_PREPROC_CONDITION = ""; //$NON-NLS-1$ + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public final static String A_PREPROC_UNKNOWN_DIRECTIVE = ""; //$NON-NLS-1$ + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public final static String A_PREPROC_CONDITIONAL_MISMATCH = ""; //$NON-NLS-1$ + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final String A_SCANNER_BADCHAR = ""; //$NON-NLS-1$ + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final String A_SYMBOL_NAME = ""; //$NON-NLS-1$ + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final String A_NAMESPACE_NAME = ""; //$NON-NLS-1$ + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final String A_TYPE_NAME = ""; //$NON-NLS-1$ + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public final static String FILENAME_NOT_PROVIDED = ""; //$NON-NLS-1$ + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public final static int SEMANTIC_UNIQUE_NAME_PREDEFINED = SEMANTICS_RELATED | 0x001; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public final static int SEMANTIC_NAME_NOT_FOUND = SEMANTICS_RELATED | 0x002; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public final static int SEMANTIC_NAME_NOT_PROVIDED = SEMANTICS_RELATED | 0x003; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int SEMANTIC_INVALID_OVERLOAD = SEMANTICS_RELATED | 0x004; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int SEMANTIC_INVALID_USING = SEMANTICS_RELATED | 0x005; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int SEMANTIC_AMBIGUOUS_LOOKUP = SEMANTICS_RELATED | 0x006; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int SEMANTIC_INVALID_TYPE = SEMANTICS_RELATED | 0x007; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int SEMANTIC_CIRCULAR_INHERITANCE = SEMANTICS_RELATED | 0x008; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int SEMANTIC_INVALID_TEMPLATE = SEMANTICS_RELATED | 0x009; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int SEMANTIC_BAD_VISIBILITY = SEMANTICS_RELATED | 0x00A; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int SEMANTIC_UNABLE_TO_RESOLVE_FUNCTION = SEMANTICS_RELATED | 0x00B; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int SEMANTIC_INVALID_TEMPLATE_ARGUMENT = SEMANTICS_RELATED | 0x00C; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int SEMANTIC_INVALID_TEMPLATE_PARAMETER = SEMANTICS_RELATED | 0x00D; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int SEMANTIC_REDECLARED_TEMPLATE_PARAMETER = SEMANTICS_RELATED | 0x00E; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int SEMANTIC_INVALID_CONVERSION_TYPE = SEMANTICS_RELATED | 0x00F; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int SEMANTIC_MALFORMED_EXPRESSION = SEMANTICS_RELATED | 0x010; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int SEMANTIC_ILLFORMED_FRIEND = SEMANTICS_RELATED | 0x011; + /** + * @deprecated Not used. + * @noreference This field is not intended to be referenced by clients. + */ @Deprecated public static final int SEMANTIC_RECURSIVE_TEMPLATE_INSTANTIATION = SEMANTICS_RELATED | 0x012; } diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IScanner.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IScanner.java index 2d203b7d1b9..ecaf2757a1f 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IScanner.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IScanner.java @@ -114,6 +114,7 @@ public interface IScanner { public int getCodeBranchNesting(); /** + * @deprecated Has no effect. * @noreference This method is not intended to be referenced by clients. */ @Deprecated diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IToken.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IToken.java index 4094b17b257..c815aed2a3e 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IToken.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IToken.java @@ -98,12 +98,8 @@ public interface IToken { /** @since 5.10*/ int t_alignas = 5900; /** @since 5.10*/ int t_alignof = 5901; - /** @deprecated use {@link #tAND} */ @Deprecated int t_and = 54; - /** @deprecated use {@link #tAMPERASSIGN} */ @Deprecated int t_and_eq = 55; int t_asm = 56; int t_auto = 57; - /** @deprecated use {@link #tAMPER} */ @Deprecated int t_bitand = 58; - /** @deprecated use {@link #tBITOR} */ @Deprecated int t_bitor = 59; int t_bool = 60; int t_break = 61; int t_case = 62; @@ -112,8 +108,6 @@ public interface IToken { /** @since 5.2 */ int t_char16_t= 5202; /** @since 5.2 */ int t_char32_t= 5203; int t_class = 65; - /** @deprecated use {@link #tBITCOMPLEMENT} */ @Deprecated int tCOMPL= tBITCOMPLEMENT; - /** @deprecated use {@link #tBITCOMPLEMENT} */ @Deprecated int t_compl = 66; int t_const = 67; /** @since 5.4 */ int t_constexpr = 5400; @@ -144,11 +138,7 @@ public interface IToken { int t_new = 92; /** @since 5.4 */ int t_noexcept = 5401; /** @since 5.4 */ int t_nullptr = 5402; - /** @deprecated use {@link #tNOT} */ @Deprecated int t_not = 93; - /** @deprecated use {@link #tNOTEQUAL} */ @Deprecated int t_not_eq = 94; int t_operator = 95; - /** @deprecated use {@link #tOR} */ @Deprecated int t_or = 96; - /** @deprecated use {@link #tBITORASSIGN} */ @Deprecated int t_or_eq = 97; int t_private = 98; int t_protected = 99; int t_public = 100; @@ -180,8 +170,6 @@ public interface IToken { int t_volatile = 124; int t_wchar_t = 125; int t_while = 126; - /** @deprecated use {@link #tXOR} */ @Deprecated int t_xor = 127; - /** @deprecated use {@link #tXORASSIGN} */ @Deprecated int t_xor_eq = 128; int tFLOATINGPT = 129; int tSTRING = 130; @@ -202,13 +190,10 @@ public interface IToken { int t__Complex = 135; int t__Imaginary = 136; int t_restrict = 137; - /** @deprecated don't use it */ @Deprecated int tMACROEXP = 138; int tPOUND= 138; int tPOUNDPOUND = 139; int tCOMPLETION = 140; int tEOC = 141; // End of Completion - /** @deprecated don't use it */ @Deprecated int tCOMMENT = 142; - /** @deprecated don't use it */ @Deprecated int tBLOCKCOMMENT = 143; int tEND_OF_INPUT= 144; /** @since 5.1 */ int tINACTIVE_CODE_START= 145; /** @since 5.1 */ int tINACTIVE_CODE_SEPARATOR= 146; @@ -234,4 +219,35 @@ public interface IToken { */ @Deprecated public boolean isOperator(); + + /** @deprecated use {@link #tAND} @noreference This field is not intended to be referenced by clients. */ + @Deprecated int t_and = 54; + /** @deprecated use {@link #tAMPERASSIGN} @noreference This field is not intended to be referenced by clients. */ + @Deprecated int t_and_eq = 55; + /** @deprecated use {@link #tAMPER} @noreference This field is not intended to be referenced by clients. */ + @Deprecated int t_bitand = 58; + /** @deprecated use {@link #tBITOR} @noreference This field is not intended to be referenced by clients. */ + @Deprecated int t_bitor = 59; + /** @deprecated use {@link #tBITCOMPLEMENT} @noreference This field is not intended to be referenced by clients. */ + @Deprecated int tCOMPL= tBITCOMPLEMENT; + /** @deprecated use {@link #tBITCOMPLEMENT} @noreference This field is not intended to be referenced by clients. */ + @Deprecated int t_compl = 66; + /** @deprecated use {@link #tNOT} @noreference This field is not intended to be referenced by clients. */ + @Deprecated int t_not = 93; + /** @deprecated use {@link #tNOTEQUAL} @noreference This field is not intended to be referenced by clients. */ + @Deprecated int t_not_eq = 94; + /** @deprecated use {@link #tOR} @noreference This field is not intended to be referenced by clients. */ + @Deprecated int t_or = 96; + /** @deprecated use {@link #tBITORASSIGN} @noreference This field is not intended to be referenced by clients. */ + @Deprecated int t_or_eq = 97; + /** @deprecated use {@link #tXOR} @noreference This field is not intended to be referenced by clients. */ + @Deprecated int t_xor = 127; + /** @deprecated use {@link #tXORASSIGN} @noreference This field is not intended to be referenced by clients. */ + @Deprecated int t_xor_eq = 128; + /** @deprecated don't use it @noreference This field is not intended to be referenced by clients. */ + @Deprecated int tMACROEXP = 138; + /** @deprecated don't use it @noreference This field is not intended to be referenced by clients. */ + @Deprecated int tCOMMENT = 142; + /** @deprecated don't use it @noreference This field is not intended to be referenced by clients. */ + @Deprecated int tBLOCKCOMMENT = 143; } diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/ITokenDuple.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/ITokenDuple.java index 356fdd4bbb4..c1213aada27 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/ITokenDuple.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/ITokenDuple.java @@ -16,13 +16,12 @@ import java.util.List; import org.eclipse.cdt.core.dom.ast.IASTNode; - /** - * @deprecated + * @deprecated Do not use. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface ITokenDuple { - public abstract IToken getFirstToken(); public abstract IToken getLastToken(); @@ -35,7 +34,7 @@ public interface ITokenDuple { public abstract Iterator iterator(); @Override public abstract String toString(); - public char [] toCharArray(); + public char[] toCharArray(); public abstract int length(); diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IncludeFileContentProvider.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IncludeFileContentProvider.java index 9cb06b2bc61..5b338f236da 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IncludeFileContentProvider.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/parser/IncludeFileContentProvider.java @@ -22,7 +22,6 @@ import org.eclipse.cdt.internal.core.parser.SavedFilesProvider; * @since 5.2 */ public abstract class IncludeFileContentProvider { - /** * Returns a provider that pretends that every include file is empty. */ @@ -40,6 +39,7 @@ public abstract class IncludeFileContentProvider { /** * @deprecated Provided to achieve backwards compatibility. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public static IncludeFileContentProvider adapt(org.eclipse.cdt.core.dom.ICodeReaderFactory factory) { diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/internal/core/index/IIndexFragment.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/internal/core/index/IIndexFragment.java index f513247cecd..b765e822361 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/internal/core/index/IIndexFragment.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/internal/core/index/IIndexFragment.java @@ -90,21 +90,9 @@ public interface IIndexFragment { public static final String PROPERTY_RESUME_INDEXER= "org.eclipse.cdt.internal.core.index.resume"; //$NON-NLS-1$ /** - * Returns the file for the given location and linkage. - * May return null, if no such file exists. - * This method may only return files that are actually managed by this fragment. - * This method returns files without content, also. - *

- * When a header file is stored in the index in multiple variants for different sets of macro - * definitions, this method will return an arbitrary one of these variants. - * - * @param linkageID the id of the linkage in which the file has been parsed. - * @param location the IIndexFileLocation representing the location of the file - * @return the file for the location, or null if the file is not present in - * the index - * @throws CoreException * @deprecated Use {@link #getFile(int, IIndexFileLocation, ISignificantMacros)} or * {@link #getFiles(int, IIndexFileLocation)}. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated IIndexFragmentFile getFile(int linkageID, IIndexFileLocation location) throws CoreException; diff --git a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/internal/core/parser/InternalParserUtil.java b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/internal/core/parser/InternalParserUtil.java index 45f89d7b6a4..df5710bf8be 100644 --- a/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/internal/core/parser/InternalParserUtil.java +++ b/core/org.eclipse.cdt.core/parser/org/eclipse/cdt/internal/core/parser/InternalParserUtil.java @@ -54,9 +54,8 @@ public class InternalParserUtil extends ParserFactory { } /** - * Creates a code reader for an external location, normalizing path to - * canonical path. The cache is consulted after the path has been normalized. * @deprecated, use {@link FileContent}, instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public static org.eclipse.cdt.core.parser.CodeReader createExternalFileReader(String externalLocation, CodeReaderLRUCache cache) throws IOException { diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptor.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptor.java index e8d5d98acb9..81018548cb8 100644 --- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptor.java +++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptor.java @@ -19,20 +19,10 @@ import org.eclipse.core.resources.IProject; import org.eclipse.core.runtime.CoreException; import org.w3c.dom.Element; /** - * Models meta-data stored with a CDT project - * - * Consumers should ensure that changes made to an ICDescriptor are done - * in the context of an {@link ICDescriptorOperation} - * via {@link ICDescriptorManager#runDescriptorOperation} - * - * @see ICDescriptorOperation - * @see ICDescriptorManager - * - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. * @deprecated as this API is not configuration aware. Replaced by * {@link ICConfigurationDescription} which can be fetched with * {@link ICProjectDescription#getConfigurations()} + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface ICDescriptor { diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptorListener.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptorListener.java index f295bc12a40..e205a37e075 100644 --- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptorListener.java +++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptorListener.java @@ -15,6 +15,7 @@ import org.eclipse.cdt.core.settings.model.ICProjectDescriptionListener; /** * @deprecated register {@link ICProjectDescriptionListener} for {@link CProjectDescriptionEvent} + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface ICDescriptorListener { diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptorManager.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptorManager.java index 6b76cdb5afb..1513d17912a 100644 --- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptorManager.java +++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptorManager.java @@ -18,13 +18,11 @@ 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. * @deprecated replace with {@link ICProjectDescriptionManager} & {@link ICProjectDescription} + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface ICDescriptorManager { - public void configure(IProject project, String id) throws CoreException; public void convert(IProject project, String id) throws CoreException; diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptorOperation.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptorOperation.java index 4680876ae75..592b41fe55b 100644 --- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptorOperation.java +++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICDescriptorOperation.java @@ -16,13 +16,11 @@ 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. * @deprecated + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface ICDescriptorOperation { - /** * Call-back method executed atomically on a ICDescriptor in a runnable. * @@ -33,5 +31,4 @@ public interface ICDescriptorOperation { * @throws CoreException */ void execute(ICDescriptor descriptor, IProgressMonitor monitor) throws CoreException; - } diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICExtension.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICExtension.java index 68ce3907091..bfad60f62f6 100644 --- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICExtension.java +++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICExtension.java @@ -24,6 +24,7 @@ public interface ICExtension { /** * @deprecated Use {@link #getConfigExtensionReference()} instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public ICExtensionReference getExtensionReference(); diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICExtensionReference.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICExtensionReference.java index 5cd18f157c7..462bffcbede 100644 --- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICExtensionReference.java +++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICExtensionReference.java @@ -26,9 +26,8 @@ import org.eclipse.core.runtime.IConfigurationElement; * @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. * @deprecated replaced with {@link ICConfigExtensionReference} obtained from an {@link ICConfigurationDescription} + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface ICExtensionReference { diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICOwner.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICOwner.java index ec2d74bb50c..6fcda31b2cb 100644 --- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICOwner.java +++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICOwner.java @@ -13,9 +13,8 @@ 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. * @deprecated + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface ICOwner { diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICommandLauncher.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICommandLauncher.java index 2227478f3ce..05c5144ab0c 100644 --- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICommandLauncher.java +++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ICommandLauncher.java @@ -96,14 +96,15 @@ public interface ICommandLauncher { * @param env The list of environment variables in variable=value format. * @throws CoreException if there is an error executing the command. */ - public Process execute(IPath commandPath, String[] args, String[] env, IPath workingDirectory, IProgressMonitor monitor) throws CoreException; + public Process execute(IPath commandPath, String[] args, String[] env, IPath workingDirectory, + IProgressMonitor monitor) throws CoreException; /** - * Reads output form the process to the streams. - * @deprecated Deprecated as of CDT 8.1. Use method taking IProgressMonitor instead. + * @deprecated Use {@link #waitAndRead(OutputStream, OutputStream, IProgressMonitor)} instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated - public int waitAndRead(OutputStream out, OutputStream err); + public int waitAndRead(OutputStream out, OutputStream err); /** * Reads output form the process to the streams. A progress monitor is @@ -111,6 +112,5 @@ public interface ICommandLauncher { * process if the monitor becomes canceled override to implement a different * way to read the process inputs */ - public int waitAndRead(OutputStream output, OutputStream err, IProgressMonitor monitor); - + public int waitAndRead(OutputStream output, OutputStream err, IProgressMonitor monitor); } \ No newline at end of file diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IMarkerGenerator.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IMarkerGenerator.java index 00981d17e01..c5b207b4f5e 100644 --- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IMarkerGenerator.java +++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IMarkerGenerator.java @@ -24,8 +24,8 @@ public interface IMarkerGenerator { int SEVERITY_ERROR_BUILD = 3; /** - * callback from Output Parser * @deprecated Use public void addMarker(org.eclipse.cdt.core.ProblemMarkerInfo problem) instead. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated void addMarker(IResource file, int lineNumber, String errorDesc, int severity, String errorVar); diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ISourceFinder.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ISourceFinder.java index d91d10f34e7..079aa3592a9 100644 --- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ISourceFinder.java +++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/ISourceFinder.java @@ -14,7 +14,6 @@ import java.io.File; import org.eclipse.cdt.internal.core.model.Binary; import org.eclipse.core.runtime.IAdaptable; -import org.eclipse.core.runtime.IPath; /** * This interface is available for a {@link Binary} via the adapter mechanism. It is used to translate the @@ -93,21 +92,9 @@ public interface ISourceFinder { public String toLocalPath(String compilationPath); /** - * Use this method to find a file if you have a debug context. The implementation will consult the source - * locator associated with the given ILaunch. If there is no such locator or it does not find the file, - * the global source locator is consulted. - * - * @param launch - * an IAdaptable that will queried for an ILaunch. Pass in an ILaunch instance or something - * that can be adapted to one. If the object does not adapt to ILaunch, null is returned. - * @param compilationPath - * the path of a file as found in the debug information - * @return if we are able to find the file, the location on the host machine, otherwise null. The result - * is in OS specific format, along the lines of what {@link IPath#toOSString()} would return. Note - * that by "on the host machine", we simply mean a specification that is accessible by the host - * machine. The file may be on a network drive, e.g., and thus not really be "local". * @deprecated This method is unused in CDT code base. Use {@link #toLocalPath(String)} or request * undeprecating on the cdt-dev mailing list. + * @noreference This method is not intended to be referenced by clients. */ @Deprecated public String toLocalPath(IAdaptable launch, String compilationPath); diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/dom/IASTServiceProvider.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/dom/IASTServiceProvider.java index 9ea1570a3c4..ab26b263184 100644 --- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/dom/IASTServiceProvider.java +++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/dom/IASTServiceProvider.java @@ -24,21 +24,16 @@ import org.eclipse.core.resources.IStorage; * IASTTranslationUnits and ASTCompletionNodes are artifacts that this service returns. * * @author jcamelon - * @noextend This interface is not intended to be extended by clients. - * @noimplement This interface is not intended to be implemented by clients. * @deprecated Use methods provided by {@link ITranslationUnit} or {@link ILanguage}. + * @noreference This interface is not intended to be referenced by clients. */ @Deprecated public interface IASTServiceProvider { - /** * This exception is thrown when there is not a service provider that can handle * the request due to dialect mis-match. - * - * @author jcamelon */ - public static class UnsupportedDialectException extends Exception - { + public static class UnsupportedDialectException extends Exception { public static final long serialVersionUID = 0; } @@ -49,7 +44,7 @@ public interface IASTServiceProvider { * @return syntactical parse tree * @throws UnsupportedDialectException */ - public IASTTranslationUnit getTranslationUnit( IFile fileToParse) throws UnsupportedDialectException; + public IASTTranslationUnit getTranslationUnit(IFile fileToParse) throws UnsupportedDialectException; /** * Returns a parse tree that represents the content provided as parameters. @@ -59,7 +54,8 @@ public interface IASTServiceProvider { * @return syntactical parse tree * @throws UnsupportedDialectException */ - public IASTTranslationUnit getTranslationUnit( IFile fileToParse, boolean parseComments) throws UnsupportedDialectException; + public IASTTranslationUnit getTranslationUnit(IFile fileToParse, boolean parseComments) + throws UnsupportedDialectException; /** * Returns a parse tree that represents the content provided as parameters. @@ -70,7 +66,8 @@ public interface IASTServiceProvider { * @return syntactical parse tree * @throws UnsupportedDialectException */ - public IASTTranslationUnit getTranslationUnit( IStorage fileToParse, IProject project, ICodeReaderFactory fileCreator ) throws UnsupportedDialectException; + public IASTTranslationUnit getTranslationUnit(IStorage fileToParse, IProject project, + ICodeReaderFactory fileCreator) throws UnsupportedDialectException; /** * Returns a parse tree that represents the content provided as parameters. @@ -80,7 +77,8 @@ public interface IASTServiceProvider { * @return syntactical parse tree * @throws UnsupportedDialectException */ - public IASTTranslationUnit getTranslationUnit( IStorage fileToParse, IProject project ) throws UnsupportedDialectException; + public IASTTranslationUnit getTranslationUnit(IStorage fileToParse, IProject project) + throws UnsupportedDialectException; /** * Returns a parse tree that represents the content provided as parameters. * @@ -89,18 +87,20 @@ public interface IASTServiceProvider { * @return syntactical parse tree * @throws UnsupportedDialectException */ - public IASTTranslationUnit getTranslationUnit( IFile fileToParse, ICodeReaderFactory fileCreator )throws UnsupportedDialectException; + public IASTTranslationUnit getTranslationUnit(IFile fileToParse, ICodeReaderFactory fileCreator) + throws UnsupportedDialectException; /** * Returns a parse tree that represents the content provided as parameters. * * @param fileToParse the file in question * @param fileCreator @see CDOM#getCodeReaderFactory(int) - * @param parseComments parse commtents flag + * @param parseComments parse comments flag * @return syntactical parse tree * @throws UnsupportedDialectException */ - public IASTTranslationUnit getTranslationUnit( IFile fileToParse, ICodeReaderFactory fileCreator, boolean parseComments)throws UnsupportedDialectException; + public IASTTranslationUnit getTranslationUnit(IFile fileToParse, ICodeReaderFactory fileCreator, + boolean parseComments) throws UnsupportedDialectException; /** * Returns a parse tree that represents the content provided as parameters. @@ -111,7 +111,8 @@ public interface IASTServiceProvider { * @return syntactical parse tree * @throws UnsupportedDialectException */ - public IASTTranslationUnit getTranslationUnit( IFile fileToParse, ICodeReaderFactory fileCreator, IParserConfiguration configuration )throws UnsupportedDialectException; + public IASTTranslationUnit getTranslationUnit(IFile fileToParse, ICodeReaderFactory fileCreator, + IParserConfiguration configuration) throws UnsupportedDialectException; /** * Returns a parse tree that represents the content provided as parameters. @@ -122,7 +123,8 @@ public interface IASTServiceProvider { * @return syntactical parse tree * @throws UnsupportedDialectException */ - public IASTCompletionNode getCompletionNode( IFile fileToParse, int offset, ICodeReaderFactory fileCreator) throws UnsupportedDialectException; + public IASTCompletionNode getCompletionNode(IFile fileToParse, int offset, ICodeReaderFactory fileCreator) + throws UnsupportedDialectException; /** * Returns a parse tree that represents the content provided as parameters. @@ -134,6 +136,6 @@ public interface IASTServiceProvider { * @return syntactical parse tree * @throws UnsupportedDialectException */ - public IASTCompletionNode getCompletionNode( IStorage fileToParse, IProject project, int offset, ICodeReaderFactory fileCreator) throws UnsupportedDialectException; - + public IASTCompletionNode getCompletionNode(IStorage fileToParse, IProject project, int offset, + ICodeReaderFactory fileCreator) throws UnsupportedDialectException; } diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/dom/InternalASTServiceProvider.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/dom/InternalASTServiceProvider.java index 4661b7664b4..2b98e593732 100644 --- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/dom/InternalASTServiceProvider.java +++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/dom/InternalASTServiceProvider.java @@ -48,11 +48,10 @@ import org.eclipse.core.resources.IStorage; import org.eclipse.core.runtime.content.IContentType; /** - * @deprecated + * @deprecated Do not use this class. */ @Deprecated public class InternalASTServiceProvider implements IASTServiceProvider { - protected static final GCCScannerExtensionConfiguration C_GNU_SCANNER_EXTENSION = GCCScannerExtensionConfiguration.getInstance(); protected static final GPPScannerExtensionConfiguration CPP_GNU_SCANNER_EXTENSION = GPPScannerExtensionConfiguration.getInstance(); private static final String[] dialects = {