[librsvg: 8/15] Note the deprecation of the GdkPixbuf functions

[Marge Bot <marge-bot src gnome org>]

commit c8dfd926668e6f0fa38aa0bc83b7ed12149d033e
Author: Federico Mena Quintero <federico gnome org>
Date:   Tue Sep 7 18:08:05 2021 -0500

    Note the deprecation of the GdkPixbuf functions
    
    Part-of: <https://gitlab.gnome.org/GNOME/librsvg/-/merge_requests/585>

 doc/rsvg-sections.txt  | 2 +-
 include/librsvg/rsvg.h | 9 +++++----
 2 files changed, 6 insertions(+), 5 deletions(-)
---
diff --git a/doc/rsvg-sections.txt b/doc/rsvg-sections.txt
index d56961e5..5690d8f5 100644
--- a/doc/rsvg-sections.txt
+++ b/doc/rsvg-sections.txt
@@ -87,7 +87,7 @@ rsvg_handle_render_cairo_sub
 
 <SECTION>
 <FILE>rsvg-pixbuf</FILE>
-<TITLE>Using RSVG with GdkPixbuf</TITLE>
+<TITLE>Deprecated functions to render to GdkPixbuf</TITLE>
 rsvg_handle_get_pixbuf
 rsvg_handle_get_pixbuf_sub
 rsvg_pixbuf_from_file
diff --git a/include/librsvg/rsvg.h b/include/librsvg/rsvg.h
index 4fd19ce4..3831effd 100644
--- a/include/librsvg/rsvg.h
+++ b/include/librsvg/rsvg.h
@@ -1307,11 +1307,12 @@ void rsvg_handle_set_size_callback (RsvgHandle    *handle,
 
 /**
  * SECTION: rsvg-pixbuf
- * @short_description: How to render SVGs into GdkPixbufs, for easy use in GTK+
- *  applications
  *
- * GdkPixbuf is a library for image loading and manipulation. It is part of the
- * cross-platform GTK+ widget toolkit.
+ * Years ago, GNOME and GTK used the gdk-pixbuf library as a general mechanism to load
+ * raster images into memory (PNG, JPEG, etc.) and pass them around.  The general idiom
+ * was, "load this image file and give me a #GdkPixbuf object", which is basically a pixel
+ * buffer.  Librsvg supports this kind of interface to load and render SVG documents, but
+ * it is deprecated in favor of rendering to Cairo contexts.
  */
 
 /**