Clarify Doxygen comment for FF_API_* #defines.

1 files changed, 4 insertions, 5 deletions

diff --git a/libavutil/version.h b/libavutil/version.h
index 426146562e..c42c6b0bc4 100644
--- a/libavutil/version.h
+++ b/libavutil/version.h
@@ -54,14 +54,13 @@
  * @}
  *
  * @defgroup depr_guards Deprecation guards
- * These FF_API_* defines are not part of the public API.
- * They may change, break or disappear at any time.
- *
- * They are used mostly internally to mark code that will be removed
- * on the next major version.
+ * FF_API_* defines may be placed below to indicate public API that will be
+ * dropped at a future version bump. The defines themselves are not part of
+ * the public API and may change, break or disappear at any time.
  *
  * @{
  */
+
 #ifndef FF_API_GET_BITS_PER_SAMPLE_FMT
 #define FF_API_GET_BITS_PER_SAMPLE_FMT (LIBAVUTIL_VERSION_MAJOR < 52)
 #endif