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 boolean needsSaving();
    /**
     * Sets the current value of the preference with the given name to
     * the given string value.
     * <p>
     * This method is provided on this interface to simplify the implementation 
     * of decorators, and does not report a property change event.
     * Normal clients should instead call <code>setValue</code>.
     * </p>
     *
     * @param name the name of the preference
     * @param value the new current value of the preference
     */
    public void putValue(String name, String value);
    /**
     * Removes the given listener from this preference store.
     * Has no affect if the listener is not registered.
     *
     * @param listener a property change listener
     */
    public void removePropertyChangeListener(IPropertyChangeListener listener);
    /**
     * Sets the default value for the double-valued preference with the
     * given name. 
     * <p>
     * Note that the current value of the preference is affected if
     * the preference's current value was its old default value, in which
     * case it changes to the new default value. If the preference's current
     * is different from its old default value, its current value is