Note why certain replacements of odd functionality are not there by design

Change-Id: Iaa3110eaea5e295a193642555b7e14ab3fb6ff96

include/cppuhelper/compbase.hxx

@@ -42,6 +42,10 @@ namespace osl { class Mutex; }
 
 #if defined LIBO_INTERNAL_ONLY
 
+// A replacement for WeakAggComponentImplHelper1 has deliberately been left out,
+// as the underlying aggregation mechanism is known broken in general and should
+// not be used.
+
 namespace cppu {
 
 /** Implementation helper implementing interfaces

include/cppuhelper/implbase.hxx

@@ -38,6 +38,14 @@
 
 #if defined LIBO_INTERNAL_ONLY
 
+// A replacement for ImplHelperN has deliberately been left out, as ImplHelperN
+// is unlikely ever be a better choice htan WeakImplHelper, so all their
+// existing uses are probably confused and should use WeakImplHelper instead.
+//
+// Replacements for WeakAggImplHelperN and AggImplInheritanceHelper1 have
+// deliberately been left out, as the underlying aggregation mechanism is known
+// broken in general and should not be used.
+
 namespace cppu {
 
 /// @cond INTERNAL