diff --git a/libavutil/log.h b/libavutil/log.h
index 48abd4a1b9..665c65144e 100644
--- a/libavutil/log.h
+++ b/libavutil/log.h
@@ -187,18 +187,20 @@ typedef struct AVClass {
 
 #define AV_LOG_MAX_OFFSET (AV_LOG_DEBUG - AV_LOG_QUIET)
 
-/**
- * Sets additional colors for extended debugging sessions.
- * Requires 256color terminal support. Use outside debugging is not
- * recommended.
- */
-
-#define AV_LOG_C(x) (x << 8)
-
 /**
  * @}
  */
 
+/**
+ * Sets additional colors for extended debugging sessions.
+ * @code
+   av_log(ctx, AV_LOG_DEBUG|AV_LOG_C(134), "Message in purple\n");
+   @endcode
+ * Requires 256color terminal support. Uses outside debugging is not
+ * recommended.
+ */
+#define AV_LOG_C(x) (x << 8)
+
 /**
  * Send the specified message to the log if the level is less than or equal
  * to the current av_log_level. By default, all logging messages are sent to