mirror of
https://github.com/eclipse-cdt/cdt
synced 2025-08-04 14:55:41 +02:00
Fix warnings + JavaDoc
This commit is contained in:
parent
7e403feb06
commit
bc7549cb14
2 changed files with 24 additions and 32 deletions
|
@ -29,17 +29,14 @@ public interface ICProjectDescription extends ICSettingContainer,
|
||||||
ICProjectDescriptionPreferences {
|
ICProjectDescriptionPreferences {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* returns an array of configurations available for this project
|
* @return {@link ICConfigurationDescription}[] containing all configurations in the project
|
||||||
*
|
|
||||||
* @return
|
|
||||||
*/
|
*/
|
||||||
ICConfigurationDescription[] getConfigurations();
|
ICConfigurationDescription[] getConfigurations();
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* returns active configuration
|
* Returns the Project's active configuration. This is the configuration which is built by default
|
||||||
* Active configuratiuon is the one that is built by default.
|
* @see ICProjectDescriptionPreferences#setConfigurationRelations(int)
|
||||||
*
|
* @return active {@link ICConfigurationDescription} - the one which is build by default
|
||||||
* @return
|
|
||||||
*/
|
*/
|
||||||
ICConfigurationDescription getActiveConfiguration();
|
ICConfigurationDescription getActiveConfiguration();
|
||||||
|
|
||||||
|
@ -49,7 +46,7 @@ public interface ICProjectDescription extends ICSettingContainer,
|
||||||
* @param cfg
|
* @param cfg
|
||||||
*
|
*
|
||||||
* @throws WriteAccessException when the project description is read-only
|
* @throws WriteAccessException when the project description is read-only
|
||||||
* the description is read only if it was queried/returned by the {@link CoreModel#getProjectDescription(org.eclipse.core.resources.IProject, false)} call
|
* the description is read only if it was queried/returned by the <code>CoreModel.getProjectDescription(org.eclipse.core.resources.IProject, false)</code> call
|
||||||
*/
|
*/
|
||||||
void setActiveConfiguration(ICConfigurationDescription cfg) throws WriteAccessException;
|
void setActiveConfiguration(ICConfigurationDescription cfg) throws WriteAccessException;
|
||||||
|
|
||||||
|
@ -59,10 +56,10 @@ public interface ICProjectDescription extends ICSettingContainer,
|
||||||
* @param id configuration id
|
* @param id configuration id
|
||||||
* @param name configuration name
|
* @param name configuration name
|
||||||
* @param base the configuration description from which the settings are to be copied
|
* @param base the configuration description from which the settings are to be copied
|
||||||
* @return
|
* @return {@link ICConfigurationDescription} created
|
||||||
* @throws CoreException
|
* @throws CoreException
|
||||||
* @throws WriteAccessException when the project description is read-only
|
* @throws WriteAccessException when the project description is read-only
|
||||||
* the description is read only if it was queried/returned by the {@link CoreModel#getProjectDescription(org.eclipse.core.resources.IProject, false)} call
|
* the description is read only if it was queried/returned by the <code>CoreModel#getProjectDescription(org.eclipse.core.resources.IProject, false)</code> call
|
||||||
*
|
*
|
||||||
*/
|
*/
|
||||||
ICConfigurationDescription createConfiguration(String id, String name, ICConfigurationDescription base) throws CoreException, WriteAccessException;
|
ICConfigurationDescription createConfiguration(String id, String name, ICConfigurationDescription base) throws CoreException, WriteAccessException;
|
||||||
|
@ -74,53 +71,48 @@ public interface ICProjectDescription extends ICSettingContainer,
|
||||||
* @param buildSystemId build system id, i.e. the extension id contributing to the
|
* @param buildSystemId build system id, i.e. the extension id contributing to the
|
||||||
* org.eclipse.cdt.core.CConfigurationDataProvider extension point
|
* org.eclipse.cdt.core.CConfigurationDataProvider extension point
|
||||||
* @param data CConfigurationData to be associated with this configuration
|
* @param data CConfigurationData to be associated with this configuration
|
||||||
* @return the created configuration
|
* @return {@link ICConfigurationDescription} created
|
||||||
* @throws CoreException
|
* @throws CoreException
|
||||||
* @throws WriteAccessException when the project description is read-only
|
* @throws WriteAccessException when the project description is read-only
|
||||||
* the description is read only if it was queried/returned by the {@link CoreModel#getProjectDescription(org.eclipse.core.resources.IProject, false)} call
|
* the description is read only if it was queried/returned by the <code>CoreModel.getProjectDescription(org.eclipse.core.resources.IProject, false)</code> call
|
||||||
*/
|
*/
|
||||||
ICConfigurationDescription createConfiguration(String buildSystemId, CConfigurationData data) throws CoreException, WriteAccessException;
|
ICConfigurationDescription createConfiguration(String buildSystemId, CConfigurationData data) throws CoreException, WriteAccessException;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* returns Configuration of the given name or null if not found
|
* @param name String name of the configuration to get
|
||||||
* @param name
|
* @return {@link ICConfigurationDescription} of the given name or null if not found
|
||||||
* @return
|
|
||||||
*/
|
*/
|
||||||
ICConfigurationDescription getConfigurationByName(String name);
|
ICConfigurationDescription getConfigurationByName(String name);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* returns Configuration of the given id or null if not found
|
* @param id {@link ICConfigurationDescription} id
|
||||||
* @param id
|
* @return {@link ICConfigurationDescription} of the given id or null if not found
|
||||||
* @return
|
|
||||||
*/
|
*/
|
||||||
ICConfigurationDescription getConfigurationById(String id);
|
ICConfigurationDescription getConfigurationById(String id);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* removes Configuration of the given name from the project description
|
* Remove Configuration of the given name from the project description
|
||||||
* @param name
|
* @param name String name of the configuration to remove
|
||||||
* @throws WriteAccessException when the project description is read-only
|
* @throws WriteAccessException when the project description is read-only
|
||||||
* the description is read only if it was queried/returned by the {@link CoreModel#getProjectDescription(org.eclipse.core.resources.IProject, false)} call
|
* the description is read only if it was queried/returned by the <code>CoreModel.getProjectDescription(org.eclipse.core.resources.IProject, false)</code> call
|
||||||
*/
|
*/
|
||||||
void removeConfiguration(String name) throws WriteAccessException;
|
void removeConfiguration(String name) throws WriteAccessException;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* removed the given configuration from the project description
|
* Remove the given configuration from the project description
|
||||||
* @param cfg
|
* @param cfg {@link ICConfigurationDescription} to remove
|
||||||
* @throws WriteAccessException when the project description is read-only
|
* @throws WriteAccessException when the project description is read-only
|
||||||
* the description is read only if it was queried/returned by the {@link CoreModel#getProjectDescription(org.eclipse.core.resources.IProject, false)} call
|
* the description is read only if it was queried/returned by the <code>CoreModel.getProjectDescription(IProject, false)</code> call
|
||||||
*/
|
*/
|
||||||
void removeConfiguration(ICConfigurationDescription cfg) throws WriteAccessException;
|
void removeConfiguration(ICConfigurationDescription cfg) throws WriteAccessException;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* IProject this project description is associated with
|
* @return IProject this project description is associated with
|
||||||
* @return
|
|
||||||
*/
|
*/
|
||||||
IProject getProject();
|
IProject getProject();
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* returns true if the project description was modified
|
* @return true if the project description was modified, false otherwise
|
||||||
* false otherwise
|
|
||||||
* @return
|
|
||||||
*/
|
*/
|
||||||
boolean isModified();
|
boolean isModified();
|
||||||
|
|
||||||
|
@ -150,7 +142,7 @@ public interface ICProjectDescription extends ICSettingContainer,
|
||||||
* used by the CDT editor and views.
|
* used by the CDT editor and views.
|
||||||
*
|
*
|
||||||
* @see ICProjectDescriptionPreferences#setConfigurationRelations(int)
|
* @see ICProjectDescriptionPreferences#setConfigurationRelations(int)
|
||||||
* @return
|
* @return the default {@link ICConfigurationDescription}
|
||||||
*/
|
*/
|
||||||
ICConfigurationDescription getDefaultSettingConfiguration();
|
ICConfigurationDescription getDefaultSettingConfiguration();
|
||||||
|
|
||||||
|
|
|
@ -17,7 +17,7 @@ public interface ICProjectDescriptionPreferences {
|
||||||
* configuration used by the core and vie a versa
|
* configuration used by the core and vie a versa
|
||||||
*
|
*
|
||||||
* @see #getConfigurationRelations()
|
* @see #getConfigurationRelations()
|
||||||
* @see #setConfigurationRelations(Integer)
|
* @see #setConfigurationRelations(int)
|
||||||
*/
|
*/
|
||||||
public static final int CONFIGS_INDEPENDENT = 1;
|
public static final int CONFIGS_INDEPENDENT = 1;
|
||||||
|
|
||||||
|
@ -27,7 +27,7 @@ public interface ICProjectDescriptionPreferences {
|
||||||
* configuration used by the core and vie a versa
|
* configuration used by the core and vie a versa
|
||||||
*
|
*
|
||||||
* @see #getConfigurationRelations()
|
* @see #getConfigurationRelations()
|
||||||
* @see #setConfigurationRelations(Integer)
|
* @see #setConfigurationRelations(int)
|
||||||
*/
|
*/
|
||||||
public static final int CONFIGS_LINK_SETTINGS_AND_ACTIVE = 2;
|
public static final int CONFIGS_LINK_SETTINGS_AND_ACTIVE = 2;
|
||||||
|
|
||||||
|
|
Loading…
Add table
Reference in a new issue