diff --git a/include/cppu/macros.hxx b/include/cppu/macros.hxx
index cc6d93a91a49..d52a6ef913e0 100644
--- a/include/cppu/macros.hxx
+++ b/include/cppu/macros.hxx
@@ -21,7 +21,10 @@
 
 #include <sal/types.h>
 
-/** Namespace name for compiler/ platform, e.g. gcc3, msci */
+/** Namespace name for compiler/ platform, e.g. gcc3, msci
+
+    @deprecated implementation detail, not to be used by client code
+*/
 #define CPPU_CURRENT_NAMESPACE CPPU_ENV
 
 /// @cond INTERNAL