diff --git a/docs/doxygen/mainpages/cat_classes.h b/docs/doxygen/mainpages/cat_classes.h
index f48a4b032a..81c1dc06e3 100644
--- a/docs/doxygen/mainpages/cat_classes.h
+++ b/docs/doxygen/mainpages/cat_classes.h
@@ -632,13 +632,13 @@ these classes provide a subset or almost complete STL API.
 
 Related Overviews: @ref overview_container
 
-@li wxArray<T>: A type-safe dynamic array implementation (macro based)
+@li wxArray<T>: Legacy dynamic array, use srd::vector or wxVector instead.
 @li wxArrayString: An efficient container for storing wxString objects
 @li wxHashMap<T>: A type-safe hash map implementation (macro based)
 @li wxHashSet<T>: A type-safe hash set implementation(macro based)
 @li wxHashTable: A simple hash table implementation (deprecated, use wxHashMap)
 @li wxList<T>: A type-safe linked list implementation (macro based)
-@li wxVector<T>: Template base vector implementation identical to std::vector
+@li wxVector<T>: Template base vector implementation identical to std::vector.
 
 
 
diff --git a/interface/wx/dynarray.h b/interface/wx/dynarray.h
index 876cbb139c..548a5c8b6a 100644
--- a/interface/wx/dynarray.h
+++ b/interface/wx/dynarray.h
@@ -6,6 +6,8 @@
 /////////////////////////////////////////////////////////////////////////////
 
 /**
+    The legacy dynamic array class, existing for compatibility only and @e NOT
+    to be used in the new code.
 
     This section describes the so called @e "dynamic arrays". This is a C
     array-like type safe data structure i.e. the member access time is constant