video-color: Enhance documentation of gst_video_colorimetry_to_string()

It could return null string. So need to clarify when it will be null.

diff --git a/gst-libs/gst/video/video-color.c b/gst-libs/gst/video/video-color.c
index c883507..9952266 100644 (file)
--- a/gst-libs/gst/video/video-color.c
+++ b/gst-libs/gst/video/video-color.c
@@ -148,7 +148,8 @@ gst_video_colorimetry_from_string (GstVideoColorimetry * cinfo,
  *
  * Make a string representation of @cinfo.
  *
- * Returns: a string representation of @cinfo.
+ * Returns: (transfer full) (nullable): a string representation of @cinfo
+ * or %NULL if all the entries of @cinfo are unknown values.
  */
 gchar *
 gst_video_colorimetry_to_string (const GstVideoColorimetry * cinfo)