diff --git a/gst-libs/gst/video/video-format.h b/gst-libs/gst/video/video-format.h
index 748a958e4783e16d7a7b31a39d858af956eafa34..e2a7d78994304f8a6c0aeee41fca916d58c0700e 100644
--- a/gst-libs/gst/video/video-format.h
+++ b/gst-libs/gst/video/video-format.h
@@ -253,9 +253,14 @@ typedef enum
  * @width: the amount of pixels to unpack.
  *
  * Unpacks @width pixels from the given planes and strides containing data of
- * format @info. The pixels will be unpacked into @dest which each component
- * interleaved. @dest should at least be big enough to hold @width *
- * n_components * size(unpack_format) bytes.
+ * format @info. The pixels will be unpacked into @dest with each component
+ * interleaved as per @info's unpack_format, which will usually be one of
+ * #GST_VIDEO_FORMAT_ARGB, #GST_VIDEO_FORMAT_AYUV, #GST_VIDEO_FORMAT_ARGB64 or
+ * #GST_VIDEO_FORMAT_AYUV64 depending on the format to unpack.
+ * @dest should at least be big enough to hold @width * bytes_per_pixel bytes
+ * where bytes_per_pixel relates to the unpack format and will usually be
+ * either 4 or 8 depending on the unpack format. bytes_per_pixel will be
+ * the same as the pixel stride for plane 0 for the above formats.
  *
  * For subsampled formats, the components will be duplicated in the destination
  * array. Reconstruction of the missing components can be performed in a