Bug 496145: Adding variable in interface gives error and suggests major version change, but adding to class is OK?
diff --git a/bundles/org.eclipse.pde.doc.user/api_contexts.xml b/bundles/org.eclipse.pde.doc.user/api_contexts.xml
index 6ea4aac..60da578 100644
--- a/bundles/org.eclipse.pde.doc.user/api_contexts.xml
+++ b/bundles/org.eclipse.pde.doc.user/api_contexts.xml
@@ -32,9 +32,13 @@
<topic href="http://wiki.eclipse.org/Execution_Environments" label="Execution Environments"/>
<topic href="tasks/api_tooling_options.htm" label="Changing API Options"/>
</context>
- <context id="apitools_error_warning_explain_incompatibility_field_addition_class" title="'Field Addition to Class' Incompatibility">
- <description>Adding an API field to an API class is a breaking change due to two reasons 1) Name clash 2) Possible linkage error. See the 'Add API field incompatibility' link below for details. </description>
- <topic href="https://wiki.eclipse.org/Evolving_Java-based_APIs_2#add-api-field" label="Add API field incompatibility"/>
+ <context id="apitools_error_warning_explain_incompatibility_field_addition_class" title="'Field Addition to Class' Incompatibility">
+ <description>Adding an API field to an API class is considered a breaking change for two reasons:
+1) Potential name clash
+2) Potential linkage error
+However, field additions can be acceptable with proper precautions.
+See the "'Add API field' incompatibility" link below for details.</description>
+ <topic href="https://wiki.eclipse.org/Evolving_Java-based_APIs_2#add-api-field" label="'Add API field' incompatibility"/>
</context>
<context id="apitools_error_warning_prop_page" title="API Errors/Warnings">
<description>This page allows you to configure project specific settings for problem severities related to API compatibility and use.</description>
@@ -127,5 +131,5 @@
<description>The API Use Report launch configuration runs a use scan reporting API references, internal references, and illegal API use.</description>
<topic href="reference/api-tooling/ant-tasks/apiuse-ant-task.htm" label="API Use Scan Report Task"/>
<topic href="reference/api-tooling/ant-tasks/apiuse-reportconversion-ant-task.htm" label="API Use Scan Report Conversion Task"/>
- </context>
+ </context>
</contexts>
