CONFLUENCE-240: Make AbstractMacroConverter and the Confluence Converter public

* Mark ConfluenceConverter as deprecated so IDEs can warn against injecting it

Author: raphj

confluence-xml/src/main/java/org/xwiki/contrib/confluence/filter/internal/input/ConfluenceConverter.java

@@ -68,15 +68,18 @@
 /**
  * Default implementation of ConfluenceFilterReferenceConverter.
  *
- * Note: the ConfluenceConverter role is deprecated and will eventually go away. We give a grace period to let
- * projects switch to {@link ConfluenceFilterReferenceConverter}, ideally we should get rid of this deprecated role
- * early 2026.
+ * Note: While the implementation itself is not deprecated, the ConfluenceConverter role is deprecated and will
+ * eventually go away. We give a grace period to let projects switch to {@link ConfluenceFilterReferenceConverter},
+ * ideally we should get rid of this deprecated role early 2026. We use the deprecated annotations to make the IDEs
+ * warn against using it.
  *
  * @version $Id$
  * @since 9.26.0
+ * @deprecated since 9.83.0, use {@link ConfluenceFilterReferenceConverter} instead
  */
 @Component (roles = {ConfluenceFilterReferenceConverter.class, ConfluenceConverter.class})
 @Singleton
+@Deprecated (since = "9.83.0")
 public class ConfluenceConverter implements ConfluenceFilterReferenceConverter
 {
     private static final Pattern FORBIDDEN_USER_CHARACTERS = Pattern.compile("[. /]");