[gmf-dev] [GMF - API CHANGE] Bugzilla 112797 Deprecate the use of fragme

[Wayne Diu <wdiu@xxxxxxxxxx>]

The API change described below has been committed.

The old API will not be removed on November 9, 2005, as originally planned 
to allow clients more time to migrate.

__________________

Description:
Extension point provider policies were placed in fragments to prevent 
unnecessary premature loading of substantial plug-ins.  Now, it is 
possible to specify in the MANIFEST.MF file the packages that may be 
accessed without loading the entire plug-in.  Therefore, these types of 
fragments should be moved back into their corresponding plug-ins.

1. Removing org.eclipse.gmf.runtime.common.core.provider
This plug-in served solely as a host for fragments for and it will be 
removed.

2. Deprecate the use of the "plugin" attribute in the "Policy" element.
The "plugin" element becomes unnecessary.
<Policy
    plugin="com.acme.myPlugin"   <--- deprecated
    class="com.acme.myPlugin.PolicyClass">
</Policy>

New API Availability: 
Wednesday, November 2, 2005 for (2)

Old API Removal: 
Wednesday, November 9, 2005, unless teams request more time to migrate

Tracking:                         
Bugzilla 112797

Clients Taken Care of:         
gmf

Other Clients' Action:         
a) Move the affected fragments back into their corresponding plug-ins. 
This is the whole point of this Bugzilla.
b) Because of change (1) above, do not reference the 
org.eclipse.gmf.runtime.common.core.provider plug-in anywhere.  Typically, 
this was used as the Policy plug-in.  Because of change (2), the plugin 
element simply needs to be removed.
c) To maintain the delayed loading, make use of the Eclipse-AutoStart 
header and the exceptions attribute in the MANIFEST.MF.
For eaxmple, add the following line to your MANIFEST.MF
Eclipse-AutoStart: true; exceptions="com.acme.myPlugin.policyPackage1, 
com.acme.myPlugin.policyPackage2"
In the example above, com.acme.myPlugin.policyPackage1 and 
com.acme.myPlugin.policyPackage2 are the packages which now contain the 
policies that have been moved over into the plug-in from a fragment in 
step (a).
d) In the event you had org.eclipse.gmf.runtime.common.core.provider in 
your MANIFEST.MF as the Fragment-Host, change it to something more 
appropriate.