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
*
     * @return the contribution item identifier, or <code>null</code>
     *   if none
     */
    public String getId();
    /**
     * Returns whether this contribution item is enabled.
     * 
     * @return <code>true</code> if this item is enabled
     */
    public boolean isEnabled();
    /**
     * Returns whether this contribution item is dirty. A dirty item will be
     * recreated when the action bar is updated.
     * 
     * @return <code>true</code> if this item is dirty
     */
    public boolean isDirty();
    /**
     * Returns whether this contribution item is dynamic. A dynamic contribution
     * item contributes items conditionally, dependent on some internal state.
     *
     * @return <code>true</code> if this item is dynamic, and
     *  <code>false</code> for normal items
     */
    public boolean isDynamic();
    /**
     * Returns whether this contribution item is a group marker.
     * This information is used when adding items to a group.
     *