diff --git a/libavformat/avformat.h b/libavformat/avformat.h
index 8bb4605202..072845ac6d 100644
--- a/libavformat/avformat.h
+++ b/libavformat/avformat.h
@@ -35,6 +35,10 @@
 
 #define LIBAVFORMAT_IDENT       "Lavf" AV_STRINGIFY(LIBAVFORMAT_VERSION)
 
+/**
+ * Those FF_API_* defines are not part of public API.
+ * They may change, break or disappear at any time.
+ */
 #ifndef FF_API_MAX_STREAMS
 #define FF_API_MAX_STREAMS   (LIBAVFORMAT_VERSION_MAJOR < 53)
 #endif