[mutter/gbsneto/screencast-improvements: 2/9] clutter/stage-view: Annotate some functions

[Georges Basile Stavracas Neto <gbsneto src gnome org>]

commit 14c0c4d6e88f95cf7b59169ec4b2e091e5132c17
Author: Georges Basile Stavracas Neto <georges stavracas gmail com>
Date:   Mon Jun 17 18:32:12 2019 -0300

    clutter/stage-view: Annotate some functions
    
    The GIR parser cannot figure out the ownership model of
    ClutterStageView.get_framebuffer() and .get_offscreen()
    without them, and throws us a couple of warnings.

 clutter/clutter/clutter-stage-view.c | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
---
diff --git a/clutter/clutter/clutter-stage-view.c b/clutter/clutter/clutter-stage-view.c
index 2f39d30db..d61c2bb17 100644
--- a/clutter/clutter/clutter-stage-view.c
+++ b/clutter/clutter/clutter-stage-view.c
@@ -62,6 +62,15 @@ clutter_stage_view_get_layout (ClutterStageView      *view,
   *rect = priv->layout;
 }
 
+/**
+ * clutter_stage_view_get_framebuffer:
+ * @view: a #ClutterStageView
+ *
+ * Retrieves the offscren framebuffer of @view if available; otherwise,
+ * retrieves the onscreen framebuffer.
+ *
+ * Returns: (transfer none): a #CoglFramebuffer
+ */
 CoglFramebuffer *
 clutter_stage_view_get_framebuffer (ClutterStageView *view)
 {
@@ -74,6 +83,14 @@ clutter_stage_view_get_framebuffer (ClutterStageView *view)
     return priv->framebuffer;
 }
 
+/**
+ * clutter_stage_view_get_onscreen:
+ * @view: a #ClutterStageView
+ *
+ * Retrieves the onscreen framebuffer of @view if available.
+ *
+ * Returns: (transfer none): a #CoglFramebuffer
+ */
 CoglFramebuffer *
 clutter_stage_view_get_onscreen (ClutterStageView *view)
 {