8347008: beancontext package spec does not clearly explain why the AP…

…I is deprecated

Reviewed-by: aivanov, prr

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -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