Summary

provide more information about why the java.beans.beancontext was deprecated

Problem

The beancontext package description or the deprecation text in the classes doesn't say anything about why the API is deprecated.

Solution

Update the package info.

Specification

src/java.desktop/share/classes/java/beans/beancontext/package-info.java

--- a/src/java.desktop/share/classes/java/beans/beancontext/package-info.java
+++ b/src/java.desktop/share/classes/java/beans/beancontext/package-info.java
@@ -30,12 +30,15 @@
  * context can be nested within another bean context. This package also
  * contains events and listener interface for beans being added and removed from
  * a bean context.
- *
- * This package has been deprecated and may be removed in a future version of the Java Platform
- * There is no replacement.
- *
+ * <p>
+ * These APIs are now both obsolete and express an <em>anti-pattern</em> of component
+ * assembly and interaction.
+ * <p>
+ * This package has been deprecated and may be removed in a future version of
+ * the Java Platform. There is no replacement.
+ * <p>
  * All of the classes and interfaces in this package have been terminally deprecated.
- *
+ * <p>
  * Users are advised to migrate their applications to other technologies.
  *
  * @since 1.2