Bug 83248 Warnings in javadoc generation
If you check N20050119-0010/compilelogs/platform.doc.isv.javadoc.txt, you will find that there are a lot of warnings during the javadoc generation of platform plugins. I will attach patches to get rid of them.
bundles/org.eclipse.jface/src/org/eclipse/jface/action/IContributionItem.java
public void saveWidgetState();
    /**
     * 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);
}