Bug 188911 [Contributions] [Doc] IContributionItem.dispose() says it should not be called by clients
3.3 RC1. IContributionItem.dispose() says it should not be called by clients but this happens all over the place in the SDK e.g. to dispose menu managers which are also an IContributionItem. I guess this restriction should be removed.
bundles/org.eclipse.jface/src/org/eclipse/jface/action/IContributionItem.java
* A contribution item can realize itself in different SWT widgets, using the different 
 * <code>fill</code> methods.  The same type of contribution item can be used with a 
 * <code>MenuBarManager</code>, <code>ToolBarManager</code>, <code>CoolBarManager</code>, 
 * </code>or a <code>StatusLineManager</code>.
 * </p>
 * <p>
 * This interface is internal to the framework; it should not be implemented outside
 * the framework.
 * </p>
 *
 * @see IContributionManager
 */
public interface IContributionItem {
    /**
     * Disposes of this contribution item. Called by the parent
     * contribution manager when the manager is being disposed.
     * Clients should not call this method directly.
     * 
     * @since 2.1
     */
    public void dispose();
    /**
     * Fills the given composite control with controls representing this 
     * contribution item.  Used by <code>StatusLineManager</code>.
     *
     * @param parent the parent control
     */
    public void fill(Composite parent);
    /**
     * Fills the given menu with controls representing this contribution item.