Bug 161848 [JFace] Javadoc quality in org.eclipse.jface
As Tod announced on the platform-ui mailing list he wants to set the compiler settings to stricter mode so to ensure the javadoc quality. Because the weather was so lousy in Austria today I tried it and took the effort (~2 hours). I'll attach the patches package wise. This is a starting point.
bundles/org.eclipse.jface/src/org/eclipse/jface/action/ActionContributionItem.java
private LocalResourceManager imageManager;
    
    /**
     * Listener for SWT button widget events.
     */
    private Listener buttonListener;
    /**
     * Listener for SWT menu item widget events.
     */
    private Listener menuItemListener;
    /**
     * Listener for action property change notifications.
     */
    private final IPropertyChangeListener propertyListener = new IPropertyChangeListener() {
        public void propertyChange(PropertyChangeEvent event) {
            actionPropertyChange(event);
        }
    };
    /**
     * Listener for SWT tool item widget events.
     */
    private Listener toolItemListener;
    /**
     * The widget created for this item; <code>null</code>
     * before creation and after disposal.
     */
    private Widget widget = null;
    /**
     * Creates a new contribution item from the given action. The id of the
     * action is used as the id of the item.