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
/**
     * Sets the parent manager of this item
     * 
     * @param parent the parent contribution manager
     * @since 2.0
     */
    public void setParent(IContributionManager parent);
    /**
     * Sets whether this contribution item is visibile within its manager.
     *
     * @param visible <code>true</code> if this item should be visible, and
     *  <code>false</code> otherwise
     */
    public void setVisible(boolean visible);
    /**
     * Updates any SWT controls cached by this contribution item with any
     * changes which have been made to this contribution item since the last update.
     * Called by contribution manager update methods.
     */
    public void update();
    /**
     * Updates any SWT controls cached by this contribution item with changes
     * for the the given property. 
     * 
     * @param id the id of the changed property
     * @since 2.0
     */
    public void update(String id);
}