mirror of
https://github.com/eclipse-cdt/cdt
synced 2025-07-26 10:25:32 +02:00
Corrected some ill-encoded characters in comments
This commit is contained in:
parent
85a785117c
commit
d61fcc17ce
5 changed files with 20 additions and 20 deletions
|
@ -38,7 +38,7 @@ public interface IBuildMacroProvider{
|
||||||
* @param contextData represents the additional data needed by the Build Macro Provider
|
* @param contextData represents the additional data needed by the Build Macro Provider
|
||||||
* and Macro Suppliers in order to obtain the macro value. The type of the context data
|
* and Macro Suppliers in order to obtain the macro value. The type of the context data
|
||||||
* differs depending on the context type and can be one of the following:
|
* differs depending on the context type and can be one of the following:
|
||||||
* 1. IFileContextData interface � used to represent currently selected file context
|
* 1. IFileContextData interface - used to represent currently selected file context
|
||||||
* the IFileContextData interface is defined as follows:
|
* the IFileContextData interface is defined as follows:
|
||||||
* public interface IFileContextData{
|
* public interface IFileContextData{
|
||||||
* IFile getFile();
|
* IFile getFile();
|
||||||
|
@ -46,13 +46,13 @@ public interface IBuildMacroProvider{
|
||||||
* }
|
* }
|
||||||
* NOTE: the IFileContextData is passed that represents the current file and the option
|
* NOTE: the IFileContextData is passed that represents the current file and the option
|
||||||
* for that file because Macro Value Provider needs to know what option should be used
|
* for that file because Macro Value Provider needs to know what option should be used
|
||||||
* as a context in case macro is not found for �current file� context
|
* as a context in case macro is not found for "current file" context
|
||||||
* 2. IOptionContextData interface used to represent the currently selected option context
|
* 2. IOptionContextData interface used to represent the currently selected option context
|
||||||
* 3. IConfiguration � used to represent the currently selected configuration context
|
* 3. IConfiguration - used to represent the currently selected configuration context
|
||||||
* 4. IProject � used to represent current project context
|
* 4. IProject - used to represent current project context
|
||||||
* 5. IWorkspace � used to represent current workspace context
|
* 5. IWorkspace - used to represent current workspace context
|
||||||
* 6. null � to represent the CDT and Eclipse installation context
|
* 6. null - to represent the CDT and Eclipse installation context
|
||||||
* 7. null � to represent process environment context
|
* 7. null - to represent process environment context
|
||||||
* @param includeParentContexts specifies whether lower-precedence context macros should
|
* @param includeParentContexts specifies whether lower-precedence context macros should
|
||||||
* be included
|
* be included
|
||||||
*/
|
*/
|
||||||
|
@ -107,7 +107,7 @@ public interface IBuildMacroProvider{
|
||||||
* expanded to. If null the BuildMacroException is thrown in case the string to be resolved
|
* expanded to. If null the BuildMacroException is thrown in case the string to be resolved
|
||||||
* references inexistent macros
|
* references inexistent macros
|
||||||
* @param listDelimiter if not null, StringList macros are expanded as
|
* @param listDelimiter if not null, StringList macros are expanded as
|
||||||
* �<value_1>< listDelimiter ><value_2>< listDelimiter > ... <value_n>�
|
* "<value_1>< listDelimiter ><value_2>< listDelimiter > ... <value_n>"
|
||||||
* otherwise the BuildMacroException is thrown in case the string to be resolved references
|
* otherwise the BuildMacroException is thrown in case the string to be resolved references
|
||||||
* string-list macros
|
* string-list macros
|
||||||
* @param contextType context from which the macro search should be started
|
* @param contextType context from which the macro search should be started
|
||||||
|
@ -157,7 +157,7 @@ public interface IBuildMacroProvider{
|
||||||
* expanded to. If null the BuildMacroException is thrown in case the string to be resolved
|
* expanded to. If null the BuildMacroException is thrown in case the string to be resolved
|
||||||
* references inexistent macros
|
* references inexistent macros
|
||||||
* @param listDelimiter if not null, StringList macros are expanded as
|
* @param listDelimiter if not null, StringList macros are expanded as
|
||||||
* �<value_1>< listDelimiter ><value_2>< listDelimiter > ... <value_n>�
|
* "<value_1>< listDelimiter ><value_2>< listDelimiter > ... <value_n>"
|
||||||
* otherwise the BuildMacroException is thrown in case the string to be resolved references
|
* otherwise the BuildMacroException is thrown in case the string to be resolved references
|
||||||
* string-list macros
|
* string-list macros
|
||||||
* @param contextType context from which the macro search should be started
|
* @param contextType context from which the macro search should be started
|
||||||
|
@ -200,7 +200,7 @@ public interface IBuildMacroProvider{
|
||||||
/**
|
/**
|
||||||
*
|
*
|
||||||
* @return true if the specified expression can be treated as StringList
|
* @return true if the specified expression can be treated as StringList
|
||||||
* 1. The string value is �${<some_StringList_Macro_name>}�
|
* 1. The string value is "${<some_StringList_Macro_name>}"
|
||||||
*/
|
*/
|
||||||
public boolean isStringListValue(String value, int contextType, Object contextData)
|
public boolean isStringListValue(String value, int contextType, Object contextData)
|
||||||
throws BuildMacroException;
|
throws BuildMacroException;
|
||||||
|
@ -213,7 +213,7 @@ public interface IBuildMacroProvider{
|
||||||
* The BuildMacroException will contain the human-readable string describing
|
* The BuildMacroException will contain the human-readable string describing
|
||||||
* the inconsistency and the array of the IBuildMacro interfaces that will represent the macros that
|
* the inconsistency and the array of the IBuildMacro interfaces that will represent the macros that
|
||||||
* caused the inconsistency. This information will be used in the UI to notify the user about
|
* caused the inconsistency. This information will be used in the UI to notify the user about
|
||||||
* the macro inconsistencies (see also the �User interface for viewing and editing Build Macros�
|
* the macro inconsistencies (see also the "User interface for viewing and editing Build Macros"
|
||||||
* section of this design)
|
* section of this design)
|
||||||
*/
|
*/
|
||||||
public void checkIntegrity(int contextType,
|
public void checkIntegrity(int contextType,
|
||||||
|
|
|
@ -26,7 +26,7 @@ public interface IConfigurationBuildMacroSupplier {
|
||||||
* @param configuration configuration
|
* @param configuration configuration
|
||||||
* @param provider the instance of the build macro provider to be used for querying the
|
* @param provider the instance of the build macro provider to be used for querying the
|
||||||
* build macros from within the supplier. The supplier should use this provider to obtain
|
* build macros from within the supplier. The supplier should use this provider to obtain
|
||||||
* the already defined build macros instead of using the �default� provider returned by the
|
* the already defined build macros instead of using the "default" provider returned by the
|
||||||
* ManagedBuildManager.getBuildMacroProvider().
|
* ManagedBuildManager.getBuildMacroProvider().
|
||||||
* The provider passed to a supplier will ignore searching macros for the levels
|
* The provider passed to a supplier will ignore searching macros for the levels
|
||||||
* higher than the current supplier level, will query only the lower-precedence suppliers
|
* higher than the current supplier level, will query only the lower-precedence suppliers
|
||||||
|
@ -46,7 +46,7 @@ public interface IConfigurationBuildMacroSupplier {
|
||||||
* @param configuration configuration
|
* @param configuration configuration
|
||||||
* @param provider the instance of the build macro provider to be used for querying the
|
* @param provider the instance of the build macro provider to be used for querying the
|
||||||
* build macros from within the supplier. The supplier should use this provider to obtain
|
* build macros from within the supplier. The supplier should use this provider to obtain
|
||||||
* the already defined build macros instead of using the �default� provider returned by the
|
* the already defined build macros instead of using the "default" provider returned by the
|
||||||
* ManagedBuildManager.getBuildMacroProvider().
|
* ManagedBuildManager.getBuildMacroProvider().
|
||||||
* The provider passed to a supplier will ignore searching macros for the levels
|
* The provider passed to a supplier will ignore searching macros for the levels
|
||||||
* higher than the current supplier level, will query only the lower-precedence suppliers
|
* higher than the current supplier level, will query only the lower-precedence suppliers
|
||||||
|
|
|
@ -26,7 +26,7 @@ public interface IProjectBuildMacroSupplier {
|
||||||
* @param project the instance of the managed project
|
* @param project the instance of the managed project
|
||||||
* @param provider the instance of the build macro provider to be used for querying the
|
* @param provider the instance of the build macro provider to be used for querying the
|
||||||
* build macros from within the supplier. The supplier should use this provider to obtain
|
* build macros from within the supplier. The supplier should use this provider to obtain
|
||||||
* the already defined build macros instead of using the �default� provider returned by the
|
* the already defined build macros instead of using the "default" provider returned by the
|
||||||
* ManagedBuildManager.getBuildMacroProvider().
|
* ManagedBuildManager.getBuildMacroProvider().
|
||||||
* The provider passed to a supplier will ignore searching macros for the levels
|
* The provider passed to a supplier will ignore searching macros for the levels
|
||||||
* higher than the current supplier level, will query only the lower-precedence suppliers
|
* higher than the current supplier level, will query only the lower-precedence suppliers
|
||||||
|
@ -46,7 +46,7 @@ public interface IProjectBuildMacroSupplier {
|
||||||
* @param project the instance of the managed project
|
* @param project the instance of the managed project
|
||||||
* @param provider the instance of the build macro provider to be used for querying the
|
* @param provider the instance of the build macro provider to be used for querying the
|
||||||
* build macros from within the supplier. The supplier should use this provider to obtain
|
* build macros from within the supplier. The supplier should use this provider to obtain
|
||||||
* the already defined build macros instead of using the �default� provider returned by the
|
* the already defined build macros instead of using the "default" provider returned by the
|
||||||
* ManagedBuildManager.getBuildMacroProvider().
|
* ManagedBuildManager.getBuildMacroProvider().
|
||||||
* The provider passed to a supplier will ignore searching macros for the levels
|
* The provider passed to a supplier will ignore searching macros for the levels
|
||||||
* higher than the current supplier level, will query only the lower-precedence suppliers
|
* higher than the current supplier level, will query only the lower-precedence suppliers
|
||||||
|
|
|
@ -73,20 +73,20 @@ import org.eclipse.core.runtime.IPath;
|
||||||
* We can use this to ensure that the dependency files are up to date
|
* We can use this to ensure that the dependency files are up to date
|
||||||
* by adding rules to the make file for generating the dependency files.
|
* by adding rules to the make file for generating the dependency files.
|
||||||
* These rules are returned by the call to getDependencyCommands.
|
* These rules are returned by the call to getDependencyCommands.
|
||||||
* However, this has a significant problem when we don�t want to build
|
* However, this has a significant problem when we don't want to build
|
||||||
* the build target, but only want to �clean� the configuration,
|
* the build target, but only want to "clean" the configuration,
|
||||||
* for example. If we invoke make just to clean the configuration,
|
* for example. If we invoke make just to clean the configuration,
|
||||||
* make will still update the dependency files if necessary, thereby
|
* make will still update the dependency files if necessary, thereby
|
||||||
* re-generating the dependency files only to immediately delete them.
|
* re-generating the dependency files only to immediately delete them.
|
||||||
* The workaround suggested by the make documentation is to check for
|
* The workaround suggested by the make documentation is to check for
|
||||||
* an invocation using the �clean� target, and to not include the
|
* an invocation using the "clean" target, and to not include the
|
||||||
* dependency files it that case. For example,
|
* dependency files it that case. For example,
|
||||||
*
|
*
|
||||||
* ifneq ($(MAKECMDGOALS),clean)
|
* ifneq ($(MAKECMDGOALS),clean)
|
||||||
* include $(DEPS)
|
* include $(DEPS)
|
||||||
* endif
|
* endif
|
||||||
*
|
*
|
||||||
* The restriction with this is that it only works if �clean� is the only
|
* The restriction with this is that it only works if "clean" is the only
|
||||||
* target specified on the make command line. Therefore, the build
|
* target specified on the make command line. Therefore, the build
|
||||||
* "clean" step must be invoked separately.
|
* "clean" step must be invoked separately.
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -183,7 +183,7 @@ public class Conversions {
|
||||||
return cost;
|
return cost;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
// � otherwise, the program is ill-formed.
|
// otherwise, the program is ill-formed.
|
||||||
return Cost.NO_CONVERSION;
|
return Cost.NO_CONVERSION;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
Loading…
Add table
Reference in a new issue