mirrors/cdt
1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-06-07 17:56:01 +02:00
Code Issues Wiki Activity

JavaDoc warnings

Browse source
This commit is contained in:
Andrew Gvozdev 2010-05-04 03:47:06 +00:00
parent 232e65ec58
commit f400c28d0e
1 changed files with 66 additions and 203 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

269
build/org.eclipse.cdt.managedbuilder.core/src/org/eclipse/cdt/managedbuilder/core/ManagedBuildManager.java
View file

@ -289,9 +289,7 @@ public class ManagedBuildManager extends AbstractCExtension {
}); });
} }
/** /**
* Returns the next random number. * @return the next random number as a positive integer.
*
* @return int A positive integer
*/ */
public static int getRandomNumber() { public static int getRandomNumber() {
if (randomNumber == null) { if (randomNumber == null) {
@ -307,10 +305,8 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* Returns the list of project types that are defined by this project, * @return the list of project types that are defined by this project,
* projects referenced by this project, and by the extensions. * projects referenced by this project, and by the extensions.
*
* @return IProjectType[]
*/ */
public static IProjectType[] getDefinedProjectTypes() { public static IProjectType[] getDefinedProjectTypes() {
try { try {
@ -375,10 +371,8 @@ public class ManagedBuildManager extends AbstractCExtension {
return depCalculatorsMap; return depCalculatorsMap;
} }
/* (non-Javadoc) /**
* Safe accessor for the map of IDs to ProjectTypes * Safe accessor for the map of IDs to ProjectTypes
*
* @return Map
*/ */
public static SortedMap<String, IProjectType> getExtensionProjectTypeMap() { public static SortedMap<String, IProjectType> getExtensionProjectTypeMap() {
try { try {
@ -391,10 +385,8 @@ public class ManagedBuildManager extends AbstractCExtension {
return projectTypeMap; return projectTypeMap;
} }
/* (non-Javadoc) /**
* Safe accessor for the map of IDs to Configurations * Safe accessor for the map of IDs to Configurations
*
* @return Map
*/ */
protected static Map<String, IConfiguration> getExtensionConfigurationMap() { protected static Map<String, IConfiguration> getExtensionConfigurationMap() {
if (extensionConfigurationMap == null) { if (extensionConfigurationMap == null) {
@ -403,10 +395,8 @@ public class ManagedBuildManager extends AbstractCExtension {
return extensionConfigurationMap; return extensionConfigurationMap;
} }
/* (non-Javadoc) /**
* Safe accessor for the map of IDs to Resource Configurations * Safe accessor for the map of IDs to Resource Configurations
*
* @return Map
*/ */
protected static Map<String, IResourceConfiguration> getExtensionResourceConfigurationMap() { protected static Map<String, IResourceConfiguration> getExtensionResourceConfigurationMap() {
if (extensionResourceConfigurationMap == null) { if (extensionResourceConfigurationMap == null) {
@ -415,10 +405,8 @@ public class ManagedBuildManager extends AbstractCExtension {
return extensionResourceConfigurationMap; return extensionResourceConfigurationMap;
} }
/* (non-Javadoc) /**
* Safe accessor for the map of IDs to ToolChains * Safe accessor for the map of IDs to ToolChains
*
* @return Map
*/ */
public static SortedMap<String, IToolChain> getExtensionToolChainMap() { public static SortedMap<String, IToolChain> getExtensionToolChainMap() {
try { try {
@ -444,10 +432,8 @@ public class ManagedBuildManager extends AbstractCExtension {
return extensionToolChainMap.values().toArray(new ToolChain[extensionToolChainMap.size()]); return extensionToolChainMap.values().toArray(new ToolChain[extensionToolChainMap.size()]);
} }
/* (non-Javadoc) /**
* Safe accessor for the map of IDs to Tools * Safe accessor for the map of IDs to Tools
*
* @return Map
*/ */
public static SortedMap<String, ITool> getExtensionToolMap() { public static SortedMap<String, ITool> getExtensionToolMap() {
try { try {
@ -471,10 +457,8 @@ public class ManagedBuildManager extends AbstractCExtension {
return extensionToolMap.values().toArray(new Tool[extensionToolMap.size()]); return extensionToolMap.values().toArray(new Tool[extensionToolMap.size()]);
} }
/* (non-Javadoc) /**
* Safe accessor for the map of IDs to TargetPlatforms * Safe accessor for the map of IDs to TargetPlatforms
*
* @return Map
*/ */
protected static Map<String, ITargetPlatform> getExtensionTargetPlatformMap() { protected static Map<String, ITargetPlatform> getExtensionTargetPlatformMap() {
if (extensionTargetPlatformMap == null) { if (extensionTargetPlatformMap == null) {
@ -483,10 +467,8 @@ public class ManagedBuildManager extends AbstractCExtension {
return extensionTargetPlatformMap; return extensionTargetPlatformMap;
} }
/* (non-Javadoc) /**
* Safe accessor for the map of IDs to Builders * Safe accessor for the map of IDs to Builders
*
* @return Map
*/ */
public static SortedMap<String, IBuilder> getExtensionBuilderMap() { public static SortedMap<String, IBuilder> getExtensionBuilderMap() {
try { try {
@ -510,10 +492,8 @@ public class ManagedBuildManager extends AbstractCExtension {
return extensionBuilderMap.values().toArray(new Builder[extensionBuilderMap.size()]); return extensionBuilderMap.values().toArray(new Builder[extensionBuilderMap.size()]);
} }
/* (non-Javadoc) /**
* Safe accessor for the map of IDs to Options * Safe accessor for the map of IDs to Options
*
* @return Map
*/ */
protected static Map<String, IOption> getExtensionOptionMap() { protected static Map<String, IOption> getExtensionOptionMap() {
if (extensionOptionMap == null) { if (extensionOptionMap == null) {
@ -522,10 +502,8 @@ public class ManagedBuildManager extends AbstractCExtension {
return extensionOptionMap; return extensionOptionMap;
} }
/* (non-Javadoc) /**
* Safe accessor for the map of IDs to Option Categories * Safe accessor for the map of IDs to Option Categories
*
* @return Map
*/ */
protected static Map<String, IOptionCategory> getExtensionOptionCategoryMap() { protected static Map<String, IOptionCategory> getExtensionOptionCategoryMap() {
if (extensionOptionCategoryMap == null) { if (extensionOptionCategoryMap == null) {
@ -534,10 +512,8 @@ public class ManagedBuildManager extends AbstractCExtension {
return extensionOptionCategoryMap; return extensionOptionCategoryMap;
} }
/* (non-Javadoc) /**
* Safe accessor for the map of IDs to InputTypes * Safe accessor for the map of IDs to InputTypes
*
* @return Map
*/ */
protected static Map<String, IInputType> getExtensionInputTypeMap() { protected static Map<String, IInputType> getExtensionInputTypeMap() {
if (extensionInputTypeMap == null) { if (extensionInputTypeMap == null) {
@ -546,10 +522,8 @@ public class ManagedBuildManager extends AbstractCExtension {
return extensionInputTypeMap; return extensionInputTypeMap;
} }
/* (non-Javadoc) /**
* Safe accessor for the map of IDs to OutputTypes * Safe accessor for the map of IDs to OutputTypes
*
* @return Map
*/ */
protected static Map<String, IOutputType> getExtensionOutputTypeMap() { protected static Map<String, IOutputType> getExtensionOutputTypeMap() {
if (extensionOutputTypeMap == null) { if (extensionOutputTypeMap == null) {
@ -558,10 +532,8 @@ public class ManagedBuildManager extends AbstractCExtension {
return extensionOutputTypeMap; return extensionOutputTypeMap;
} }
/* (non-Javadoc) /**
* Safe accessor for the map of IDs to Targets (CDT V2.0 object model) * Safe accessor for the map of IDs to Targets (CDT V2.0 object model)
*
* @return Map
*/ */
protected static Map<String, ITarget> getExtensionTargetMap() { protected static Map<String, ITarget> getExtensionTargetMap() {
if (extensionTargetMap == null) { if (extensionTargetMap == null) {
@ -571,7 +543,6 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* @param resource
* @return the targets owned by this resource. If none are owned, * @return the targets owned by this resource. If none are owned,
* an empty array is returned. * an empty array is returned.
*/ */
@ -586,11 +557,8 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* Returns the project type from the manifest with the ID specified in the argument * @return the project type from the manifest with the ID specified in the argument
* or <code>null</code>. * or {@code null}.
*
* @param id
* @return IProjectType
*/ */
public static IProjectType getExtensionProjectType(String id) { public static IProjectType getExtensionProjectType(String id) {
try { try {
@ -605,11 +573,8 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* Returns the configuration from the manifest with the ID specified in the argument * @return the configuration from the manifest with the ID specified in the argument
* or <code>null</code>. * or {@code null}.
*
* @param id
* @return IConfiguration
*/ */
public static IConfiguration getExtensionConfiguration(String id) { public static IConfiguration getExtensionConfiguration(String id) {
try { try {
@ -636,11 +601,8 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* Returns the resource configuration from the manifest with the ID specified in the argument * @return the resource configuration from the manifest with the ID specified in the argument
* or <code>null</code>. * or {@code null}.
*
* @param id
* @return IResourceConfiguration
*/ */
public static IResourceConfiguration getExtensionResourceConfiguration(String id) { public static IResourceConfiguration getExtensionResourceConfiguration(String id) {
try { try {
@ -655,11 +617,8 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* Returns the tool-chain from the manifest with the ID specified in the argument * @return the tool-chain from the manifest with the ID specified in the argument
* or <code>null</code>. * or {@code null}.
*
* @param id
* @return IToolChain
*/ */
public static IToolChain getExtensionToolChain(String id) { public static IToolChain getExtensionToolChain(String id) {
try { try {
@ -674,11 +633,8 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* Returns the tool from the manifest with the ID specified in the argument * @return the tool from the manifest with the ID specified in the argument
* or <code>null</code>. * or {@code null}.
*
* @param id
* @return ITool
*/ */
public static ITool getExtensionTool(String id) { public static ITool getExtensionTool(String id) {
try { try {
@ -693,11 +649,8 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* Returns the target platform from the manifest with the ID specified in the argument * @return the target platform from the manifest with the ID specified in the argument
* or <code>null</code>. * or {@code null}.
*
* @param id
* @return ITargetPlatform
*/ */
public static ITargetPlatform getExtensionTargetPlatform(String id) { public static ITargetPlatform getExtensionTargetPlatform(String id) {
try { try {
@ -712,11 +665,8 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* Returns the builder from the manifest with the ID specified in the argument * @return the builder from the manifest with the ID specified in the argument
* or <code>null</code>. * or {@code null}.
*
* @param id
* @return IBuilder
*/ */
public static IBuilder getExtensionBuilder(String id) { public static IBuilder getExtensionBuilder(String id) {
try { try {
@ -739,11 +689,8 @@ public class ManagedBuildManager extends AbstractCExtension {
/** /**
* Returns the option from the manifest with the ID specified in the argument * @return the option from the manifest with the ID specified in the argument
* or <code>null</code>. * or {@code null}.
*
* @param id
* @return IOption
*/ */
public static IOption getExtensionOption(String id) { public static IOption getExtensionOption(String id) {
try { try {
@ -758,11 +705,8 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* Returns the InputType from the manifest with the ID specified in the argument * @return the InputType from the manifest with the ID specified in the argument
* or <code>null</code>. * or {@code null}.
*
* @param id
* @return IInputType
*/ */
public static IInputType getExtensionInputType(String id) { public static IInputType getExtensionInputType(String id) {
try { try {
@ -777,11 +721,8 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* Returns the OutputType from the manifest with the ID specified in the argument * @return the OutputType from the manifest with the ID specified in the argument
* or <code>null</code>. * or {@code null}.
*
* @param id
* @return IOutputType
*/ */
public static IOutputType getExtensionOutputType(String id) { public static IOutputType getExtensionOutputType(String id) {
try { try {
@ -796,11 +737,8 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* Returns the target from the manifest with the ID specified in the argument * @return the target from the manifest with the ID specified in the argument
* or <code>null</code> - CDT V2.0 object model. * or {@code null} - CDT V2.0 object model.
*
* @param id
* @return ITarget
*/ */
public static ITarget getExtensionTarget(String id) { public static ITarget getExtensionTarget(String id) {
try { try {
@ -839,9 +777,6 @@ public class ManagedBuildManager extends AbstractCExtension {
/** /**
* Sets the default configuration for the project. Note that this will also * Sets the default configuration for the project. Note that this will also
* update the default target if needed. * update the default target if needed.
*
* @param project
* @param newDefault
*/ */
public static void setDefaultConfiguration(IProject project, IConfiguration newDefault) { public static void setDefaultConfiguration(IProject project, IConfiguration newDefault) {
if (project == null || newDefault == null) { if (project == null || newDefault == null) {
@ -857,9 +792,6 @@ public class ManagedBuildManager extends AbstractCExtension {
/** /**
* Sets the currently selected configuration. This is used while the project * Sets the currently selected configuration. This is used while the project
* property pages are displayed * property pages are displayed
*
* @param project
* @param config
*/ */
public static void setSelectedConfiguration(IProject project, IConfiguration config) { public static void setSelectedConfiguration(IProject project, IConfiguration config) {
if (project == null) { if (project == null) {
@ -886,7 +818,6 @@ public class ManagedBuildManager extends AbstractCExtension {
/** /**
* load tool provider defined or default (if not found) command line generator special for selected tool * load tool provider defined or default (if not found) command line generator special for selected tool
* @param toolId - id selected tool ID * @param toolId - id selected tool ID
* @return IManagedCommandLineGenerator
*/ */
public static IManagedCommandLineGenerator getCommandLineGenerator(IConfiguration config, String toolId) { public static IManagedCommandLineGenerator getCommandLineGenerator(IConfiguration config, String toolId) {
ITool tool = config.getTool(toolId); ITool tool = config.getTool(toolId);
@ -910,10 +841,9 @@ public class ManagedBuildManager extends AbstractCExtension {
/** /**
* Gets the currently selected target. This is used while the project * Gets the currently selected target. This is used while the project
* property pages are displayed * property pages are displayed.
* *
* @param project * @return target configuration.
* @return target
*/ */
public static IConfiguration getSelectedConfiguration(IProject project) { public static IConfiguration getSelectedConfiguration(IProject project) {
if (project == null) { if (project == null) {
@ -1057,7 +987,7 @@ public class ManagedBuildManager extends AbstractCExtension {
* @param option The option to set the value for. * @param option The option to set the value for.
* @param value The boolean that the option should contain after the change. * @param value The boolean that the option should contain after the change.
* *
* @return IOption The modified option. This can be the same option or a newly created option. * @return The modified option. This can be the same option or a newly created option.
* *
* @since 3.0 - The type and name of the <code>ITool tool</code> parameter * @since 3.0 - The type and name of the <code>ITool tool</code> parameter
* has changed to <code>IHoldsOptions holder</code>. Client code * has changed to <code>IHoldsOptions holder</code>. Client code
@ -1095,7 +1025,7 @@ public class ManagedBuildManager extends AbstractCExtension {
* @param option The option to set the value for. * @param option The option to set the value for.
* @param value The boolean that the option should contain after the change. * @param value The boolean that the option should contain after the change.
* *
* @return IOption The modified option. This can be the same option or a newly created option. * @return The modified option. This can be the same option or a newly created option.
* *
* @since 3.0 - The type and name of the <code>ITool tool</code> parameter * @since 3.0 - The type and name of the <code>ITool tool</code> parameter
* has changed to <code>IHoldsOptions holder</code>. Client code * has changed to <code>IHoldsOptions holder</code>. Client code
@ -1132,7 +1062,7 @@ public class ManagedBuildManager extends AbstractCExtension {
* @param option The option to set the value for. * @param option The option to set the value for.
* @param value The value that the option should contain after the change. * @param value The value that the option should contain after the change.
* *
* @return IOption The modified option. This can be the same option or a newly created option. * @return The modified option. This can be the same option or a newly created option.
* *
* @since 3.0 - The type and name of the <code>ITool tool</code> parameter * @since 3.0 - The type and name of the <code>ITool tool</code> parameter
* has changed to <code>IHoldsOptions holder</code>. Client code * has changed to <code>IHoldsOptions holder</code>. Client code
@ -1169,7 +1099,7 @@ public class ManagedBuildManager extends AbstractCExtension {
* @param option The option to set the value for. * @param option The option to set the value for.
* @param value The value that the option should contain after the change. * @param value The value that the option should contain after the change.
* *
* @return IOption The modified option. This can be the same option or a newly created option. * @return The modified option. This can be the same option or a newly created option.
* *
* @since 3.0 - The type and name of the <code>ITool tool</code> parameter * @since 3.0 - The type and name of the <code>ITool tool</code> parameter
* has changed to <code>IHoldsOptions holder</code>. Client code * has changed to <code>IHoldsOptions holder</code>. Client code
@ -1205,7 +1135,7 @@ public class ManagedBuildManager extends AbstractCExtension {
* @param option The option to set the value for. * @param option The option to set the value for.
* @param value The values the option should contain after the change. * @param value The values the option should contain after the change.
* *
* @return IOption The modified option. This can be the same option or a newly created option. * @return The modified option. This can be the same option or a newly created option.
* *
* @since 3.0 - The type and name of the <code>ITool tool</code> parameter * @since 3.0 - The type and name of the <code>ITool tool</code> parameter
* has changed to <code>IHoldsOptions holder</code>. Client code * has changed to <code>IHoldsOptions holder</code>. Client code
@ -1242,7 +1172,7 @@ public class ManagedBuildManager extends AbstractCExtension {
* @param option The option to set the value for. * @param option The option to set the value for.
* @param value The values the option should contain after the change. * @param value The values the option should contain after the change.
* *
* @return IOption The modified option. This can be the same option or a newly created option. * @return The modified option. This can be the same option or a newly created option.
* *
* @since 3.0 - The type and name of the <code>ITool tool</code> parameter * @since 3.0 - The type and name of the <code>ITool tool</code> parameter
* has changed to <code>IHoldsOptions holder</code>. Client code * has changed to <code>IHoldsOptions holder</code>. Client code
@ -1294,11 +1224,6 @@ public class ManagedBuildManager extends AbstractCExtension {
return retOpt; return retOpt;
} }
/**
* @param config
* @param tool
* @param command
*/
public static void setToolCommand(IConfiguration config, ITool tool, String command) { public static void setToolCommand(IConfiguration config, ITool tool, String command) {
// The tool may be a reference. // The tool may be a reference.
if (tool instanceof IToolReference) { if (tool instanceof IToolReference) {
@ -1478,9 +1403,6 @@ public class ManagedBuildManager extends AbstractCExtension {
/** /**
* Saves the build information associated with a project and all resources * Saves the build information associated with a project and all resources
* in the project to the build info file. * in the project to the build info file.
*
* @param project
* @param force
*/ */
private static boolean updateBuildInfo(IProject project, boolean force) throws CoreException { private static boolean updateBuildInfo(IProject project, boolean force) throws CoreException {
IManagedBuildInfo info = getBuildInfo(project, false); IManagedBuildInfo info = getBuildInfo(project, false);
@ -1664,9 +1586,6 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
} }
/**
* @param resource
*/
public static void removeBuildInfo(IResource resource) { public static void removeBuildInfo(IResource resource) {
/* /*
IManagedBuildInfo info = findBuildInfo(resource, false); IManagedBuildInfo info = findBuildInfo(resource, false);
@ -1690,9 +1609,6 @@ public class ManagedBuildManager extends AbstractCExtension {
/** /**
* Resets the build information for the project and configuration specified in the arguments. * Resets the build information for the project and configuration specified in the arguments.
* The build information will contain the settings defined in the plugin manifest. * The build information will contain the settings defined in the plugin manifest.
*
* @param project
* @param configuration
*/ */
public static void resetConfiguration(IProject project, IConfiguration configuration) { public static void resetConfiguration(IProject project, IConfiguration configuration) {
// reset the configuration // reset the configuration
@ -1753,8 +1669,6 @@ public class ManagedBuildManager extends AbstractCExtension {
* Adds a ProjectType that is is specified in the manifest to the * Adds a ProjectType that is is specified in the manifest to the
* build system. It is available to any element that * build system. It is available to any element that
* has a reference to it as part of its description. * has a reference to it as part of its description.
*
* @param projectType
*/ */
public static void addExtensionProjectType(ProjectType projectType) { public static void addExtensionProjectType(ProjectType projectType) {
if (projectTypes == null) { if (projectTypes == null) {
@ -1775,8 +1689,6 @@ public class ManagedBuildManager extends AbstractCExtension {
* Adds a Configuration that is is specified in the manifest to the * Adds a Configuration that is is specified in the manifest to the
* build system. It is available to any element that * build system. It is available to any element that
* has a reference to it as part of its description. * has a reference to it as part of its description.
*
* @param configuration
*/ */
public static void addExtensionConfiguration(Configuration configuration) { public static void addExtensionConfiguration(Configuration configuration) {
IConfiguration previous = getExtensionConfigurationMap().put(configuration.getId(), configuration); IConfiguration previous = getExtensionConfigurationMap().put(configuration.getId(), configuration);
@ -1792,8 +1704,6 @@ public class ManagedBuildManager extends AbstractCExtension {
* Adds a Resource Configuration that is is specified in the manifest to the * Adds a Resource Configuration that is is specified in the manifest to the
* build system. It is available to any element that * build system. It is available to any element that
* has a reference to it as part of its description. * has a reference to it as part of its description.
*
* @param resourceConfiguration
*/ */
public static void addExtensionResourceConfiguration(ResourceConfiguration resourceConfiguration) { public static void addExtensionResourceConfiguration(ResourceConfiguration resourceConfiguration) {
IResourceConfiguration previous = getExtensionResourceConfigurationMap().put(resourceConfiguration.getId(), resourceConfiguration); IResourceConfiguration previous = getExtensionResourceConfigurationMap().put(resourceConfiguration.getId(), resourceConfiguration);
@ -1809,8 +1719,6 @@ public class ManagedBuildManager extends AbstractCExtension {
* Adds a ToolChain that is is specified in the manifest to the * Adds a ToolChain that is is specified in the manifest to the
* build system. It is available to any element that * build system. It is available to any element that
* has a reference to it as part of its description. * has a reference to it as part of its description.
*
* @param toolChain
*/ */
public static void addExtensionToolChain(ToolChain toolChain) { public static void addExtensionToolChain(ToolChain toolChain) {
IToolChain previous = getExtensionToolChainMap().put(toolChain.getId(), toolChain); IToolChain previous = getExtensionToolChainMap().put(toolChain.getId(), toolChain);
@ -1828,8 +1736,6 @@ public class ManagedBuildManager extends AbstractCExtension {
* has a reference to it as part of its description. This * has a reference to it as part of its description. This
* permits a tool that is common to many targets to be defined * permits a tool that is common to many targets to be defined
* only once. * only once.
*
* @param tool
*/ */
public static void addExtensionTool(Tool tool) { public static void addExtensionTool(Tool tool) {
ITool previous = getExtensionToolMap().put(tool.getId(), tool); ITool previous = getExtensionToolMap().put(tool.getId(), tool);
@ -1845,8 +1751,6 @@ public class ManagedBuildManager extends AbstractCExtension {
* Adds a TargetPlatform that is is specified in the manifest to the * Adds a TargetPlatform that is is specified in the manifest to the
* build system. It is available to any element that * build system. It is available to any element that
* has a reference to it as part of its description. * has a reference to it as part of its description.
*
* @param targetPlatform
*/ */
public static void addExtensionTargetPlatform(TargetPlatform targetPlatform) { public static void addExtensionTargetPlatform(TargetPlatform targetPlatform) {
ITargetPlatform previous = getExtensionTargetPlatformMap().put(targetPlatform.getId(), targetPlatform); ITargetPlatform previous = getExtensionTargetPlatformMap().put(targetPlatform.getId(), targetPlatform);
@ -1862,8 +1766,6 @@ public class ManagedBuildManager extends AbstractCExtension {
* Adds a Builder that is is specified in the manifest to the * Adds a Builder that is is specified in the manifest to the
* build system. It is available to any element that * build system. It is available to any element that
* has a reference to it as part of its description. * has a reference to it as part of its description.
*
* @param Builder
*/ */
public static void addExtensionBuilder(Builder builder) { public static void addExtensionBuilder(Builder builder) {
IBuilder previous = getExtensionBuilderMap().put(builder.getId(), builder); IBuilder previous = getExtensionBuilderMap().put(builder.getId(), builder);
@ -1879,8 +1781,6 @@ public class ManagedBuildManager extends AbstractCExtension {
* Adds a Option that is is specified in the manifest to the * Adds a Option that is is specified in the manifest to the
* build system. It is available to any element that * build system. It is available to any element that
* has a reference to it as part of its description. * has a reference to it as part of its description.
*
* @param option
*/ */
public static void addExtensionOption(Option option) { public static void addExtensionOption(Option option) {
IOption previous = getExtensionOptionMap().put(option.getId(), option); IOption previous = getExtensionOptionMap().put(option.getId(), option);
@ -1896,8 +1796,6 @@ public class ManagedBuildManager extends AbstractCExtension {
* Adds a OptionCategory that is is specified in the manifest to the * Adds a OptionCategory that is is specified in the manifest to the
* build system. It is available to any element that * build system. It is available to any element that
* has a reference to it as part of its description. * has a reference to it as part of its description.
*
* @param optionCategory
*/ */
public static void addExtensionOptionCategory(OptionCategory optionCategory) { public static void addExtensionOptionCategory(OptionCategory optionCategory) {
IOptionCategory previous = getExtensionOptionCategoryMap().put(optionCategory.getId(), optionCategory); IOptionCategory previous = getExtensionOptionCategoryMap().put(optionCategory.getId(), optionCategory);
@ -1913,8 +1811,6 @@ public class ManagedBuildManager extends AbstractCExtension {
* Adds an InputType that is is specified in the manifest to the * Adds an InputType that is is specified in the manifest to the
* build system. It is available to any element that * build system. It is available to any element that
* has a reference to it as part of its description. * has a reference to it as part of its description.
*
* @param inputType
*/ */
public static void addExtensionInputType(InputType inputType) { public static void addExtensionInputType(InputType inputType) {
IInputType previous = getExtensionInputTypeMap().put(inputType.getId(), inputType); IInputType previous = getExtensionInputTypeMap().put(inputType.getId(), inputType);
@ -1930,8 +1826,6 @@ public class ManagedBuildManager extends AbstractCExtension {
* Adds an OutputType that is is specified in the manifest to the * Adds an OutputType that is is specified in the manifest to the
* build system. It is available to any element that * build system. It is available to any element that
* has a reference to it as part of its description. * has a reference to it as part of its description.
*
* @param outputType
*/ */
public static void addExtensionOutputType(OutputType outputType) { public static void addExtensionOutputType(OutputType outputType) {
IOutputType previous = getExtensionOutputTypeMap().put(outputType.getId(), outputType); IOutputType previous = getExtensionOutputTypeMap().put(outputType.getId(), outputType);
@ -1947,8 +1841,6 @@ public class ManagedBuildManager extends AbstractCExtension {
* Adds a Target that is is specified in the manifest to the * Adds a Target that is is specified in the manifest to the
* build system. It is available to any CDT 2.0 object model element that * build system. It is available to any CDT 2.0 object model element that
* has a reference to it as part of its description. * has a reference to it as part of its description.
*
* @param target
*/ */
public static void addExtensionTarget(Target target) { public static void addExtensionTarget(Target target) {
getExtensionTargetMap().put(target.getId(), target); getExtensionTargetMap().put(target.getId(), target);
@ -1957,10 +1849,8 @@ public class ManagedBuildManager extends AbstractCExtension {
/** /**
* Creates a new project instance for the resource based on the parent project type. * Creates a new project instance for the resource based on the parent project type.
* *
* @param resource
* @param parent - parent project type * @param parent - parent project type
* @return new <code>ITarget</code> with settings based on the parent passed in the arguments * @return new <code>ITarget</code> with settings based on the parent passed in the arguments
* @throws BuildException
*/ */
public static IManagedProject createManagedProject(IResource resource, IProjectType parent) public static IManagedProject createManagedProject(IResource resource, IProjectType parent)
throws BuildException throws BuildException
@ -1971,10 +1861,7 @@ public class ManagedBuildManager extends AbstractCExtension {
/** /**
* Creates a new target for the resource based on the parentTarget. * Creates a new target for the resource based on the parentTarget.
* *
* @param resource
* @param parentTarget
* @return new <code>ITarget</code> with settings based on the parent passed in the arguments * @return new <code>ITarget</code> with settings based on the parent passed in the arguments
* @throws BuildException
*/ */
public static ITarget createTarget(IResource resource, ITarget parentTarget) public static ITarget createTarget(IResource resource, ITarget parentTarget)
throws BuildException throws BuildException
@ -2083,7 +1970,7 @@ public class ManagedBuildManager extends AbstractCExtension {
return(buildInfoVersion.isGreaterOrEqualTo(version)); return(buildInfoVersion.isGreaterOrEqualTo(version));
} }
/* (non-Javadoc) /**
* Determine if the .cdtbuild file is present, which will determine if build information * Determine if the .cdtbuild file is present, which will determine if build information
* can be loaded externally or not. Return true if present, false otherwise. * can be loaded externally or not. Return true if present, false otherwise.
*/ */
@ -2095,7 +1982,7 @@ public class ManagedBuildManager extends AbstractCExtension {
return cdtbuild.exists(); return cdtbuild.exists();
} }
/* (non-Javadoc) /**
* Load the build information for the specified resource from its project * Load the build information for the specified resource from its project
* file. Pay attention to the version number too. * file. Pay attention to the version number too.
*/ */
@ -2802,15 +2689,12 @@ public class ManagedBuildManager extends AbstractCExtension {
// return false; // return false;
} }
/* (non-Javadoc) /**
* Provate helper method that first checks to see if a build information * Private helper method that first checks to see if a build information
* object has been associated with the project for the current workspace * object has been associated with the project for the current workspace
* session. If one cannot be found, one is created from the project file * session. If one cannot be found, one is created from the project file
* associated with the argument. If there is no prject file or the load * associated with the argument. If there is no prject file or the load
* fails for some reason, the method will return <code>null</code> * fails for some reason, the method will re{@code null}code>
*
* @param resource
* @return
*/ */
private static ManagedBuildInfo findBuildInfo(IResource rc, boolean forceLoad) { private static ManagedBuildInfo findBuildInfo(IResource rc, boolean forceLoad) {
@ -2843,7 +2727,7 @@ public class ManagedBuildManager extends AbstractCExtension {
int flags = forceLoad ? 0 : ICProjectDescriptionManager.GET_IF_LOADDED; int flags = forceLoad ? 0 : ICProjectDescriptionManager.GET_IF_LOADDED;
if(BuildDbgUtil.DEBUG) if(BuildDbgUtil.DEBUG)
BuildDbgUtil.getInstance().traceln(BuildDbgUtil.BUILD_INFO_LOAD, "build info load: build info is NOT loadded" + (forceLoad ? " forceload" : "")); //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$ BuildDbgUtil.getInstance().traceln(BuildDbgUtil.BUILD_INFO_LOAD, "build info load: build info is NOT loaded" + (forceLoad ? " forceload" : "")); //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$
ICProjectDescription projDes = CoreModel.getDefault().getProjectDescriptionManager().getProjectDescription(proj, flags); ICProjectDescription projDes = CoreModel.getDefault().getProjectDescriptionManager().getProjectDescription(proj, flags);
if(projDes != null){ if(projDes != null){
if(BuildDbgUtil.DEBUG) if(BuildDbgUtil.DEBUG)
@ -2863,7 +2747,7 @@ public class ManagedBuildManager extends AbstractCExtension {
buildInfo = ConfigurationDataProvider.getLoaddedBuildInfo(projDes); buildInfo = ConfigurationDataProvider.getLoaddedBuildInfo(projDes);
if(buildInfo != null){ if(buildInfo != null){
if(BuildDbgUtil.DEBUG) if(BuildDbgUtil.DEBUG)
BuildDbgUtil.getInstance().traceln(BuildDbgUtil.BUILD_INFO_LOAD, "build info load: info found, setting as loadded"); //$NON-NLS-1$ BuildDbgUtil.getInstance().traceln(BuildDbgUtil.BUILD_INFO_LOAD, "build info load: info found, setting as loaded"); //$NON-NLS-1$
try { try {
setLoaddedBuildInfo(proj, buildInfo); setLoaddedBuildInfo(proj, buildInfo);
@ -2928,14 +2812,12 @@ public class ManagedBuildManager extends AbstractCExtension {
return buildInfo; return buildInfo;
} }
/* (non-Javadoc) /**
* Determine if build information can be found. Various attempts are made * Determine if build information can be found. Various attempts are made
* to find the information, and if successful, true is returned; false otherwise. * to find the information, and if successful, true is returned; false otherwise.
* Typically, this routine would be called prior to findBuildInfo, to deterimine * Typically, this routine would be called prior to findBuildInfo, to deterimine
* if findBuildInfo should be called to actually do the loading of build * if findBuildInfo should be called to actually do the loading of build
* information, if possible * information, if possible
* @param resource
* @return
*/ */
private static boolean canFindBuildInfo(IResource resource) { private static boolean canFindBuildInfo(IResource resource) {
@ -2969,15 +2851,12 @@ public class ManagedBuildManager extends AbstractCExtension {
return (buildInfo != null); return (buildInfo != null);
} }
/* (non-Javadoc) /**
* this method is called if managed build info session property * this method is called if managed build info session property
* was not set. The caller will use the project rule * was not set. The caller will use the project rule
* to synchronize with other callers * to synchronize with other callers
* findBuildInfoSynchronized could also be called from project converter * findBuildInfoSynchronized could also be called from project converter
* in this case the ManagedBuildInfo saved in the converter would be returned * in this case the ManagedBuildInfo saved in the converter would be returned
*
* @param resource
* @return
*/ */
/* synchronized private static ManagedBuildInfo findBuildInfoSynchronized(IProject project, boolean forceLoad) { /* synchronized private static ManagedBuildInfo findBuildInfoSynchronized(IProject project, boolean forceLoad) {
ManagedBuildInfo buildInfo = null; ManagedBuildInfo buildInfo = null;
@ -3057,7 +2936,7 @@ public class ManagedBuildManager extends AbstractCExtension {
/** /**
* Finds, but does not create, the managed build information for the * Finds, but does not create, the managed build information for the
* argument. * argument.
* Loads the build info in case it is not currently loadded * Loads the build info in case it is not currently loaded
* Calling this method is the same as calling getBuildInfo(IResource resource, boolean forceLoad) * Calling this method is the same as calling getBuildInfo(IResource resource, boolean forceLoad)
* with the "forceLoad" argument set to true * with the "forceLoad" argument set to true
* *
@ -3101,12 +2980,12 @@ public class ManagedBuildManager extends AbstractCExtension {
/** /**
* Finds, but does not create, the managed build information for the * Finds, but does not create, the managed build information for the
* argument. * argument.
* If the build info is not currently loadded and "forceLoad" argument is set to true, * If the build info is not currently loaded and "forceLoad" argument is set to true,
* loads the build info from the .cdtbuild file * loads the build info from the .cdtbuild file
* In case "forceLoad" is false, does not load the build info and returns null in case it is not loadded * In case "forceLoad" is false, does not load the build info and returns null in case it is not loaded
* *
* @param resource The resource to search for managed build information on. * @param resource The resource to search for managed build information on.
* @param forceLoad specifies whether the build info should be loadded in case it is not loadded currently. * @param forceLoad specifies whether the build info should be loaded in case it is not loaded currently.
* @return IManagedBuildInfo The build information object for the resource. * @return IManagedBuildInfo The build information object for the resource.
*/ */
public static IManagedBuildInfo getBuildInfo(IResource resource, boolean forceLoad) { public static IManagedBuildInfo getBuildInfo(IResource resource, boolean forceLoad) {
@ -3279,21 +3158,16 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* Returns the instance of the Environment Variable Provider * @return the instance of the Environment Variable Provider
*
* @return IEnvironmentVariableProvider
*/ */
public static IEnvironmentVariableProvider getEnvironmentVariableProvider(){ public static IEnvironmentVariableProvider getEnvironmentVariableProvider(){
return EnvironmentVariableProvider.getDefault(); return EnvironmentVariableProvider.getDefault();
} }
/** /**
* Returns the version, if 'id' contains a valid version * @return the version, if 'id' contains a valid version
* Returns null if 'id' does not contain a valid version * Returns null if 'id' does not contain a valid version
* Returns null if 'id' does not contain a version * Returns null if 'id' does not contain a version
*
* @param idAndVersion
* @return String
*/ */
public static String getVersionFromIdAndVersion(String idAndVersion) { public static String getVersionFromIdAndVersion(String idAndVersion) {
@ -3316,11 +3190,8 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* If the input to this function contains 'id & a valid version', it returns only the 'id' part * @return If the input to this function contains 'id & a valid version', it returns only the 'id' part
* Otherwise it returns the received input back. * Otherwise it returns the received input back.
*
* @param idAndVersion
* @return String
*/ */
public static String getIdFromIdAndVersion(String idAndVersion) { public static String getIdFromIdAndVersion(String idAndVersion) {
// If there is a valid version return only 'id' part // If there is a valid version return only 'id' part
@ -3336,9 +3207,7 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* Returns the instance of the Build Macro Provider * @return the instance of the Build Macro Provider
*
* @return IBuildMacroProvider
*/ */
public static IBuildMacroProvider getBuildMacroProvider(){ public static IBuildMacroProvider getBuildMacroProvider(){
return BuildMacroProvider.getDefault(); return BuildMacroProvider.getDefault();
@ -3659,14 +3528,13 @@ public class ManagedBuildManager extends AbstractCExtension {
return null; return null;
} }
/* /**
* Generic routine for checking the availability of converters for the given * Generic routine for checking the availability of converters for the given
* Build Object. * Build Object.
* @param IBuildObject, This function takes a 'IBuildObject' as an argument *
* @return true if there are converters for the given Build Object * @return true if there are converters for the given Build Object.
* @return false if there are no converters * Returns false if there are no converters.
*/ */
public static boolean hasTargetConversionElements(IBuildObject buildObj) { public static boolean hasTargetConversionElements(IBuildObject buildObj) {
// Get the Converter Extension Point // Get the Converter Extension Point
@ -4072,9 +3940,6 @@ public class ManagedBuildManager extends AbstractCExtension {
} }
/** /**
* Return the Build Location URI or null if one couldn't be found
* @param cfg
* @param builder
* @return build location URI or null if one couldn't be found * @return build location URI or null if one couldn't be found
* @since 6.0 * @since 6.0
*/ */
@ -4815,8 +4680,6 @@ public class ManagedBuildManager extends AbstractCExtension {
/** /**
* entry-point for the tool-chain modification validation functionality * entry-point for the tool-chain modification validation functionality
*
* @return {@link IToolChainModificationManager}
*/ */
public static IToolChainModificationManager getToolChainModificationManager(){ public static IToolChainModificationManager getToolChainModificationManager(){
return ToolChainModificationManager.getInstance(); return ToolChainModificationManager.getInstance();