bug 319826: Javadoc @deprecated warnings

build/org.eclipse.cdt.managedbuilder.core/src/org/eclipse/cdt/managedbuilder/core/IBuilder.java

@@ -203,7 +203,7 @@ public interface IBuilder extends IBuildObject, IMakeBuilderInfo {
 	 * 
 	 * @param element
 	 * 
-	 * @deprecated
+	 * @deprecated as of CDT 4.0
 	 */
 	@Deprecated
 	public void setBuildFileGeneratorElement(IConfigurationElement element);

build/org.eclipse.cdt.managedbuilder.core/src/org/eclipse/cdt/managedbuilder/core/IManagedBuildInfo.java

@@ -45,19 +45,16 @@ public interface IManagedBuildInfo {
 	/**
 	 * Add a new target to the build information for the receiver
 	 * 
-	 * @param target
+	 * @deprecated as of CDT 7.0
-	 * @deprecated
 	 */
 	@Deprecated
 	public void addTarget(ITarget target);
 		
 	/**
-	 * Answers <code>true</code> if the build system knows how to 
+	 * @return <code>true</code> if the build system knows how to 
 	 * build a file with the extension passed in the argument.
 	 *  
-	 * @param srcExt
+	 * @deprecated as of CDT 7.0
-	 * @return
-	 * @deprecated
 	 */
 	@Deprecated
 	public boolean buildsFileType(String srcExt);
@@ -332,11 +329,9 @@ public interface IManagedBuildInfo {
 	public IConfiguration getSelectedConfiguration();
 
 	/**
-	 * Get the target specified in the argument.
+	 * @return the target specified in the argument.
 	 * 
-	 * @param id
+	 * @deprecated as of CDT 7.0
-	 * @return ITarget
-	 * @deprecated
 	 */
 	@Deprecated
 	public ITarget getTarget(String id);
@@ -344,7 +339,8 @@ public interface IManagedBuildInfo {
 	/**
 	 * Get all of the targets associated with the receiver.
 	 * @return List<ITarget>
-	 * @deprecated
+	 * 
+	 * @deprecated as of CDT 7.0
 	 */
 	@Deprecated
 	public List<ITarget> getTargets();
@@ -386,11 +382,10 @@ public interface IManagedBuildInfo {
 	public ITool getToolFromOutputExtension(String extension);
 
 	/**
-	 * Answers a <code>String</code> array containing the contents of the 
+	 * @param extension the file extension of the build target
-	 * user objects option, if one is defined for the target.
 	 * 
-	 * @param extension the file ecxtension of the build target
+	 * @return a <code>String</code> array containing the contents of the 
-	 * @return
+	 * user objects option, if one is defined for the target.
 	 */
 	public String[] getUserObjectsForConfiguration(String extension);
 

build/org.eclipse.cdt.managedbuilder.core/src/org/eclipse/cdt/managedbuilder/core/ITarget.java

@@ -120,7 +120,8 @@ public interface ITarget extends IBuildObject {
 	 * created by this target.
 	 * 
 	 * @return String
-	 * @deprecated
+	 * 
+	 * @deprecated as of CDT 2.0
 	 */
 	@Deprecated
 	public String getDefaultExtension();	

build/org.eclipse.cdt.managedbuilder.core/src/org/eclipse/cdt/managedbuilder/internal/core/ManagedBuildInfo.java

@@ -726,7 +726,7 @@ public class ManagedBuildInfo implements IManagedBuildInfo, IScannerInfo {
 	 * 
 	 * @param doc
 	 * @param element
-	 * @deprecated
+	 * @deprecated as of CDT 7.0
 	 */
 	@Deprecated
 	public void serializeLegacy(Document doc, Element element) {

build/org.eclipse.cdt.managedbuilder.core/src/org/eclipse/cdt/managedbuilder/internal/macros/BuildMacroProvider.java

@@ -124,11 +124,6 @@ public class BuildMacroProvider implements IBuildMacroProvider, IMacroContextInf
 		return (IBuildMacroSupplier[])list.toArray(new IBuildMacroSupplier[list.size()]);
 	}
 	
-	/**
-	 * @param contextType
-	 * @param contextData
-	 * @return
-	 */
 	public IMacroContextInfo getMacroContextInfo(
 			int contextType,
 			Object contextData){
@@ -328,10 +323,7 @@ public class BuildMacroProvider implements IBuildMacroProvider, IMacroContextInf
 	}
 
 	/**
-	 * answers whether the environment macros are to be expanded in the buildfile
+	 * @return whether the environment macros are to be expanded in the buildfile
-	 * 
-	 * @param cfg
-	 * @return
 	 */
 	public boolean areMacrosExpandedInBuildfile(IConfiguration cfg){
 		IBuilder builder = cfg.getBuilder();

build/org.eclipse.cdt.managedbuilder.core/src/org/eclipse/cdt/newmake/core/IMakeBuilderInfo.java

@@ -22,10 +22,10 @@ public interface IMakeBuilderInfo extends IMakeCommonBuildInfo {
 	public final static String BUILD_TARGET_AUTO = ARGS_PREFIX + ".build.target.auto"; //$NON-NLS-1$
 	public final static String BUILD_TARGET_CLEAN = ARGS_PREFIX + ".build.target.clean"; //$NON-NLS-1$
 
-	/** @deprecated */
+	/** @deprecated  as of CDT 4.0 */
 	@Deprecated
 	public final static String BUILD_TARGET_INCREAMENTAL = BUILD_TARGET_INCREMENTAL;
-	/** @deprecated */
+	/** @deprecated  as of CDT 4.0 */
 	@Deprecated
 	public final static String BUILD_TARGET_FULL = ARGS_PREFIX + ".build.target.full"; //$NON-NLS-1$
 	
@@ -35,7 +35,7 @@ public interface IMakeBuilderInfo extends IMakeCommonBuildInfo {
 	String getAutoBuildTarget();
 
 	/**
-	 * @deprecated
+	 * @deprecated as of CDT 4.0
 	 */
 	@Deprecated
 	void setAutoBuildTarget(String target) throws CoreException;
@@ -46,7 +46,7 @@ public interface IMakeBuilderInfo extends IMakeCommonBuildInfo {
 	String getIncrementalBuildTarget();
 
 	/**
-	 * @deprecated
+	 * @deprecated as of CDT 4.0
 	 */
 	@Deprecated
 	void setIncrementalBuildTarget(String target) throws CoreException;
@@ -57,7 +57,7 @@ public interface IMakeBuilderInfo extends IMakeCommonBuildInfo {
 	String getFullBuildTarget();
 
 	/**
-	 * @deprecated
+	 * @deprecated as of CDT 4.0
 	 */
 	@Deprecated
 	void setFullBuildTarget(String target) throws CoreException;
@@ -65,7 +65,7 @@ public interface IMakeBuilderInfo extends IMakeCommonBuildInfo {
 	String getCleanBuildTarget();
 
 	/**
-	 * @deprecated
+	 * @deprecated as of CDT 4.0
 	 */
 	@Deprecated
 	void setCleanBuildTarget(String target) throws CoreException;

build/org.eclipse.cdt.managedbuilder.core/src/org/eclipse/cdt/newmake/core/MakeScannerInfo.java

@@ -21,7 +21,7 @@ import org.eclipse.core.resources.IProject;
 import org.eclipse.core.runtime.CoreException;
 
 /**
- * @deprecated
+ * @deprecated as of CDT 4.0
  * @author DInglis
  *
  * @noextend This class is not intended to be subclassed by clients.