doc, bug fixes

3 files changed, 12 insertions, 4 deletions

diff --git a/java/beans/beancontext/BeanContextChild.java b/java/beans/beancontext/BeanContextChild.java
index 06761f91d..3bf1c9925 100644
--- a/java/beans/beancontext/BeanContextChild.java
+++ b/java/beans/beancontext/BeanContextChild.java
@@ -62,6 +62,10 @@ public interface BeanContextChild {
 	 * Set the parent <code>BeanContext</code>.
 	 * <P>
 	 *
+	 * This method is called from <code>BeanContext.add()</code> and
+	 * should not be called directly.
+	 * <P>
+	 *
 	 * When this Object is being added to a new BeanContext or moved
 	 * from an old one, a non-null value will be passed in.
 	 * <P>
@@ -98,6 +102,10 @@ public interface BeanContextChild {
 	 * If you do veto the change, you must first back out any changes
 	 * you made prior to the veto.  Best not to make any such changes
 	 * prior to the veto in the first place.
+	 * <P>
+	 *
+	 * This method is called from <code>BeanContext.add()</code> and
+	 * should not be called directly.
 	 *
 	 * @param parent the new parent for the <code>BeanContextChild</code>,
 	 *        or <code>null</code> to signify removal from a tree.
diff --git a/java/beans/beancontext/BeanContextServiceRevokedListener.java b/java/beans/beancontext/BeanContextServiceRevokedListener.java
index f430f368b..0137a1d75 100644
--- a/java/beans/beancontext/BeanContextServiceRevokedListener.java
+++ b/java/beans/beancontext/BeanContextServiceRevokedListener.java
@@ -31,9 +31,9 @@ import java.util.EventListener;
 
 public interface BeanContextServiceRevokedListener extends EventListener {
 	/**
-	 * Called by <code>BeanContextServices.revokeService()</code>.
-	 * <B>Assumption:</B> If you have a reference to such a service,
-	 * it should be discarded and may no longer function properly.
+	 * Called by <code>BeanContextServices.revokeService()</code> to indicate that a service has been revoked.
+	 * If you have a reference to such a service, it should be
+	 * discarded and may no longer function properly.
 	 * <code>getService()</code> will no longer work on the specified
 	 * service class after this event has been fired.
 	 *
diff --git a/java/beans/beancontext/BeanContextServicesListener.java b/java/beans/beancontext/BeanContextServicesListener.java
index 5e83f26bf..55ee029c3 100644
--- a/java/beans/beancontext/BeanContextServicesListener.java
+++ b/java/beans/beancontext/BeanContextServicesListener.java
@@ -34,5 +34,5 @@ public interface BeanContextServicesListener extends BeanContextServiceRevokedLi
 	 * @param event the service revoked event, with useful information
 	 *        about the new service.
 	 */
-	public void serviceRevoked(BeanContextServiceAvailableEvent event);
+	public void serviceAvailable(BeanContextServiceAvailableEvent event);
 }
\ No newline at end of file