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/preference/PreferenceStore.java
* @param name
     * @param value
     */
    private void setValue(Properties p, String name, long value) {
        Assert.isTrue(p != null);
        p.put(name, Long.toString(value));
    }
    /**
     * Helper method: sets the value for a given name.
     * @param p
     * @param name
     * @param value
     */
    private void setValue(Properties p, String name, String value) {
        Assert.isTrue(p != null && value != null);
        p.put(name, value);
    }
    /**
     * Helper method: sets the value for a given name.
     * @param p
     * @param name
     * @param value
     */
    private void setValue(Properties p, String name, boolean value) {
        Assert.isTrue(p != null);
        p.put(name, value == true ? IPreferenceStore.TRUE
                : IPreferenceStore.FALSE);
    }
}