--- old/src/java.desktop/share/classes/java/beans/beancontext/BeanContextSupport.java 2015-08-11 19:35:56.639331276 +0400 +++ new/src/java.desktop/share/classes/java/beans/beancontext/BeanContextSupport.java 2015-08-11 19:35:56.479331283 +0400 @@ -85,16 +85,16 @@ * Construct a BeanContextSupport instance * * - * @param peer The peer BeanContext we are + * @param peer The peer {@code BeanContext} we are * supplying an implementation for, - * or null + * or {@code null} * if this object is its own peer * @param lcle The current Locale for this BeanContext. If - * lcle is null, the default locale - * is assigned to the BeanContext instance. + * {@code lcle} is {@code null}, the default locale + * is assigned to the {@code BeanContext} instance. * @param dTime The initial state, - * true if in design mode, - * false if runtime. + * {@code true} if in design mode, + * {@code false} if runtime. * @param visible The initial visibility. * @see java.util.Locale#getDefault() * @see java.util.Locale#setDefault(java.util.Locale) @@ -112,15 +112,15 @@ /** * Create an instance using the specified Locale and design mode. * - * @param peer The peer BeanContext we + * @param peer The peer {@code BeanContext} we * are supplying an implementation for, - * or null if this object is its own peer - * @param lcle The current Locale for this BeanContext. If - * lcle is null, the default locale - * is assigned to the BeanContext instance. - * @param dtime The initial state, true + * or {@code null} if this object is its own peer + * @param lcle The current Locale for this {@code BeanContext}. If + * {@code lcle} is {@code null}, the default locale + * is assigned to the {@code BeanContext} instance. + * @param dtime The initial state, {@code true} * if in design mode, - * false if runtime. + * {@code false} if runtime. * @see java.util.Locale#getDefault() * @see java.util.Locale#setDefault(java.util.Locale) */ @@ -133,13 +133,13 @@ * * @param peer The peer BeanContext we are * supplying an implementation for, - * or null if this object + * or {@code null} if this object * is its own peer * @param lcle The current Locale for this - * BeanContext. If - * lcle is null, + * {@code BeanContext}. If + * {@code lcle} is {@code null}, * the default locale - * is assigned to the BeanContext + * is assigned to the {@code BeanContext} * instance. * @see java.util.Locale#getDefault() * @see java.util.Locale#setDefault(java.util.Locale) @@ -151,9 +151,9 @@ /** * Create an instance using with a default locale * - * @param peer The peer BeanContext we are + * @param peer The peer {@code BeanContext} we are * supplying an implementation for, - * or null if this object + * or {@code null} if this object * is its own peer */ public BeanContextSupport(BeanContext peer) { @@ -169,7 +169,7 @@ } /** - * Gets the instance of BeanContext that + * Gets the instance of {@code BeanContext} that * this object is providing the implementation for. * @return the BeanContext instance */ @@ -180,7 +180,7 @@ * The instantiateChild method is a convenience hook * in BeanContext to simplify * the task of instantiating a Bean, nested, - * into a BeanContext. + * into a {@code BeanContext}. *

*

* The semantics of the beanName parameter are defined by java.beans.Beans.instantiate. @@ -213,8 +213,8 @@ /** * Reports whether or not this - * BeanContext is empty. - * A BeanContext is considered + * {@code BeanContext} is empty. + * A {@code BeanContext} is considered * empty when it contains zero * nested children. * @return if there are not children @@ -227,7 +227,7 @@ /** * Determines whether or not the specified object - * is currently a child of this BeanContext. + * is currently a child of this {@code BeanContext}. * @param o the Object in question * @return if this object is a child */ @@ -239,7 +239,7 @@ /** * Determines whether or not the specified object - * is currently a child of this BeanContext. + * is currently a child of this {@code BeanContext}. * @param o the Object in question * @return if this object is a child */ @@ -250,9 +250,9 @@ } /** - * Gets all JavaBean or BeanContext instances - * currently nested in this BeanContext. - * @return an Iterator of the nested children + * Gets all JavaBean or {@code BeanContext} instances + * currently nested in this {@code BeanContext}. + * @return an {@code Iterator} of the nested children */ public Iterator iterator() { synchronized(children) { @@ -261,7 +261,7 @@ } /** - * Gets all JavaBean or BeanContext + * Gets all JavaBean or {@code BeanContext} * instances currently nested in this BeanContext. */ public Object[] toArray() { @@ -272,7 +272,7 @@ /** * Gets an array containing all children of - * this BeanContext that match + * this {@code BeanContext} that match * the types contained in arry. * @param arry The array of object * types that are of interest. @@ -362,7 +362,7 @@ /************************************************************************/ /** - * Adds/nests a child within this BeanContext. + * Adds/nests a child within this {@code BeanContext}. *

* Invoked as a side effect of java.beans.Beans.instantiate(). * If the child object is not valid for adding then this method @@ -371,7 +371,7 @@ * * * @param targetChild The child objects to nest - * within this BeanContext + * within this {@code BeanContext} * @return true if the child was added successfully. * @see #validatePendingAdd */ @@ -485,12 +485,12 @@ /** * internal remove used when removal caused by - * unexpected setBeanContext or - * by remove() invocation. + * unexpected {@code setBeanContext} or + * by {@code remove()} invocation. * @param targetChild the JavaBean, BeanContext, or Object to be removed * @param callChildSetBC used to indicate that * the child should be notified that it is no - * longer nested in this BeanContext. + * longer nested in this {@code BeanContext}. * @return whether or not was present before being removed */ protected boolean remove(Object targetChild, boolean callChildSetBC) { @@ -558,13 +558,13 @@ /** * Tests to see if all objects in the - * specified Collection are children of - * this BeanContext. - * @param c the specified Collection + * specified {@code Collection} are children of + * this {@code BeanContext}. + * @param c the specified {@code Collection} * - * @return true if all objects + * @return {@code true} if all objects * in the collection are children of - * this BeanContext, false if not. + * this {@code BeanContext}, false if not. */ @SuppressWarnings("rawtypes") public boolean containsAll(Collection c) { @@ -698,7 +698,7 @@ } /** - * Sets the new design time value for this BeanContext. + * Sets the new design time value for this {@code BeanContext}. * @param dTime the new designTime value */ public synchronized void setDesignTime(boolean dTime) { @@ -713,15 +713,15 @@ /** * Reports whether or not this object is in * currently in design time mode. - * @return true if in design time mode, - * false if not + * @return {@code true} if in design time mode, + * {@code false} if not */ public synchronized boolean isDesignTime() { return designTime; } /** * Sets the locale of this BeanContext. * @param newLocale the new locale. This method call will have - * no effect if newLocale is null. + * no effect if newLocale is {@code null}. * @throws PropertyVetoException if the new value is rejected */ public synchronized void setLocale(Locale newLocale) throws PropertyVetoException { @@ -738,9 +738,9 @@ } /** - * Gets the locale for this BeanContext. + * Gets the locale for this {@code BeanContext}. * - * @return the current Locale of the BeanContext + * @return the current Locale of the {@code BeanContext} */ public synchronized Locale getLocale() { return locale; } @@ -754,7 +754,7 @@ * to determine if they are either Containers, Components, or if they implement * Visibility and return needsGui() == true. *

- * @return true if the implementor needs a GUI + * @return {@code true} if the implementor needs a GUI */ public synchronized boolean needsGui() { BeanContext bc = getBeanContextPeer(); @@ -823,7 +823,7 @@ } /** - * Used to determine if the BeanContext + * Used to determine if the {@code BeanContext} * child is avoiding using its GUI. * @return is this instance avoiding using its GUI? * @see Visibility @@ -833,16 +833,16 @@ } /** - * Is this BeanContext in the + * Is this {@code BeanContext} in the * process of being serialized? - * @return if this BeanContext is + * @return if this {@code BeanContext} is * currently being serialized */ public boolean isSerializing() { return serializing; } /** * Returns an iterator of all children - * of this BeanContext. + * of this {@code BeanContext}. * @return an iterator for all the current BCSChild values */ protected Iterator bcsChildren() { synchronized(children) { return children.values().iterator(); } } @@ -895,9 +895,9 @@ /** * Used by writeObject to serialize a Collection. - * @param oos the ObjectOutputStream + * @param oos the {@code ObjectOutputStream} * to use during serialization - * @param coll the Collection to serialize + * @param coll the {@code Collection} to serialize * @throws IOException if serialization failed */ protected final void serialize(ObjectOutputStream oos, Collection coll) throws IOException { @@ -943,8 +943,8 @@ /** * Used to serialize all children of - * this BeanContext. - * @param oos the ObjectOutputStream + * this {@code BeanContext}. + * @param oos the {@code ObjectOutputStream} * to use during serialization * @throws IOException if serialization failed */ @@ -1375,7 +1375,7 @@ /** - * all accesses to the protected HashMap children field + * all accesses to the {@code protected HashMap children} field * shall be synchronized on that object. */ protected transient HashMap children; @@ -1383,7 +1383,7 @@ private int serializable = 0; // children serializable /** - * all accesses to the protected ArrayList bcmListeners field + * all accesses to the {@code protected ArrayList bcmListeners} field * shall be synchronized on that object. */ protected transient ArrayList bcmListeners; @@ -1396,14 +1396,14 @@ protected Locale locale; /** - * A boolean indicating if this + * A {@code boolean} indicating if this * instance may now render a GUI. */ protected boolean okToUseGui; /** - * A boolean indicating whether or not + * A {@code boolean} indicating whether or not * this object is currently in design time mode. */ protected boolean designTime;