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
* @see #setValue(String, <type>)
     * @see org.osgi.service.prefs.Preferences
     */
    public void addPropertyChangeListener(IPropertyChangeListener listener);
    /**
     * Returns whether the named preference is known to this preference
     * store.
     *
     * @param name the name of the preference
     * @return <code>true</code> if either a current value or a default
     *  value is known for the named preference, and <code>false</code>otherwise
     */
    public boolean contains(String name);
    /**
     * Fires a property change event corresponding to a change to the
     * current value of the preference with the given name.
     * <p>
     * This method is provided on this interface to simplify the implementation 
     * of decorators. There is normally no need to call this method since
     * <code>setValue</code> and <code>setToDefault</code> report such
     * events in due course. Implementations should funnel all preference
     * changes through this method.
     * </p>
     *
     * @param name the name of the preference, to be used as the property
     *  in the event object
     * @param oldValue the old value
     * @param newValue the new value
     */
    public void firePropertyChangeEvent(String name, Object oldValue,