[gtk/matthiasc/for-master: 2/4] docs: Add details for gsk_renderer_new_for_surface

[Matthias Clasen <matthiasc src gnome org>]

commit 03fec389f4a144d035695bc74f9e4598292d0f40
Author: Matthias Clasen <mclasen redhat com>
Date:   Thu Oct 29 14:58:12 2020 -0400

    docs: Add details for gsk_renderer_new_for_surface
    
    Mention the GSK_RENDERER variable here.

 gsk/gskrenderer.c | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)
---
diff --git a/gsk/gskrenderer.c b/gsk/gskrenderer.c
index 8ec0e0d36a..dbbfd28f35 100644
--- a/gsk/gskrenderer.c
+++ b/gsk/gskrenderer.c
@@ -606,7 +606,11 @@ static struct {
  *
  * Creates an appropriate #GskRenderer instance for the given @surface.
  *
- * The renderer will be realized when it is returned.
+ * If the `GSK_RENDERER` environment variable is set, GSK will
+ * try that renderer first, before trying the backend-specific
+ * default. The ultimate fallback is the cairo renderer.
+ *
+ * The renderer will be realized before it is returned.
  *
  * Returns: (transfer full) (nullable): a #GskRenderer
  */