Bug 76940 [Preferences] Update JFace javadoc for #putValue and notification
build R3.0 The javadoc for JFace's IPreferenceStore#putValue needs to be updated. The #putValue method does not send out any notification which can cause ill effects if people call this method while others are relying on property change listeners for changes to the values. The spec should be updated to say that clients should only call it when changing their own private preference keys and should not be calling it when modifying public API preference keys.
bundles/org.eclipse.jface/src/org/eclipse/jface/preference/IPreferenceStore.java
*/
    public long getLong(String name);
    /**
     * Returns the current value of the string-valued preference with the
     * given name.
     * Returns the default-default value (the empty string <code>""</code>)
     * if there is no preference with the given name, or if the current value 
     * cannot be treated as a string.
     *
     * @param name the name of the preference
     * @return the string-valued preference
     */
    public String getString(String name);
    /**
     * Returns whether the current value of the preference with the given name
     * has the default value.
     *
     * @param name the name of the preference
     * @return <code>true</code> if the preference has a known default value
     * and its current value is the same, and <code>false</code> otherwise
     * (including the case where the preference is unknown to this store)
     */
    public boolean isDefault(String name);
    /**
     * Returns whether the current values in this property store
     * require saving.
     *
     * @return <code>true</code> if at least one of values of 
     *  the preferences known to this store has changed and 
     *  requires saving, and <code>false</code> otherwise.