From 30cc16d670f162b9288fa7654e92a0c5bef56ebe Mon Sep 17 00:00:00 2001
From: Thibault Saunier <tsaunier@igalia.com>
Date: Tue, 28 Nov 2023 10:18:37 -0300
Subject: [PATCH] ges: composition-meta: Enhance documentation

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/5735>
---
 girs/GES-1.0.gir                                            | 6 ++++--
 .../gst-editing-services/ges/ges-frame-composition-meta.h   | 6 ++++--
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/girs/GES-1.0.gir b/girs/GES-1.0.gir
index aac093e295..44e2467c6b 100644
--- a/girs/GES-1.0.gir
+++ b/girs/GES-1.0.gir
@@ -4493,11 +4493,13 @@ composition.</doc>
         <type name="gint" c:type="gint"/>
       </field>
       <field name="height" writable="1">
-        <doc xml:space="preserve" filename="../subprojects/gst-editing-services/ges/ges-frame-composition-meta.h">The desired height of the video.</doc>
+        <doc xml:space="preserve" filename="../subprojects/gst-editing-services/ges/ges-frame-composition-meta.h">The desired height of the video. -1 means that no scaling should be
+applied.</doc>
         <type name="gint" c:type="gint"/>
       </field>
       <field name="width" writable="1">
-        <doc xml:space="preserve" filename="../subprojects/gst-editing-services/ges/ges-frame-composition-meta.h">The desired width of the video.</doc>
+        <doc xml:space="preserve" filename="../subprojects/gst-editing-services/ges/ges-frame-composition-meta.h">The desired width of the video. -1 means that no scaling should beapplied
+applied.</doc>
         <type name="gint" c:type="gint"/>
       </field>
       <field name="zorder" writable="1">
diff --git a/subprojects/gst-editing-services/ges/ges-frame-composition-meta.h b/subprojects/gst-editing-services/ges/ges-frame-composition-meta.h
index c997752842..82f7b55c89 100644
--- a/subprojects/gst-editing-services/ges/ges-frame-composition-meta.h
+++ b/subprojects/gst-editing-services/ges/ges-frame-composition-meta.h
@@ -43,8 +43,10 @@ GType ges_frame_composition_meta_api_get_type (void);
  * @meta: the parent #GstMeta.
  * @posx: The desired x position.
  * @posy: The desired y position.
- * @height: The desired height of the video.
- * @width: The desired width of the video.
+ * @height: The desired height of the video. -1 means that no scaling should be
+ * applied.
+ * @width: The desired width of the video. -1 means that no scaling should beapplied
+ * applied.
  * @zorder: The desired z order.
  * @operator:The blending operator for the source.
  *