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 <code>true</code> if this item is a group marker, and
     *  <code>false</code> for normal items
     *
     * @see GroupMarker
     * @see IContributionManager#appendToGroup
     * @see IContributionManager#prependToGroup
     */
    public boolean isGroupMarker();
    /**
     * Returns whether this contribution item is a separator.
     * This information is used to enable hiding of unnecessary separators.
     *
     * @return <code>true</code> if this item is a separator, and
     *  <code>false</code> for normal items
     * @see Separator
     */
    public boolean isSeparator();
    /**
     * Returns whether this contribution item is visibile within its manager.
     *
     * @return <code>true</code> if this item is visible, and
     *  <code>false</code> otherwise
     */
    public boolean isVisible();
    /**
     * Saves any state information of the control(s) owned by this contribution item.
     * The contribution manager calls this method before disposing of the controls.
     * 
     * @since 3.0
     */