docs: Move documentation to inline comments: pixbufs

3 files changed, 11 insertions, 102 deletions

diff --git a/docs/reference/gdk/tmpl/.gitignore b/docs/reference/gdk/tmpl/.gitignore
index 905a6f25fa..029ace620d 100644
--- a/docs/reference/gdk/tmpl/.gitignore
+++ b/docs/reference/gdk/tmpl/.gitignore
@@ -1,4 +1,5 @@
 cairo_interaction.sgml
 dnd.sgml
+pixbufs.sgml
 regions.sgml
 windows.sgml
diff --git a/docs/reference/gdk/tmpl/pixbufs.sgml b/docs/reference/gdk/tmpl/pixbufs.sgml
deleted file mode 100644
index 09f06fe9b2..0000000000
--- a/docs/reference/gdk/tmpl/pixbufs.sgml
+++ /dev/null
@@ -1,101 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-Pixbufs
-
-<!-- ##### SECTION Short_Description ##### -->
-Functions for rendering pixbufs on drawables
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-These functions allow to render pixbufs on drawables. Pixbufs are
-client-side images. For details on how to create and manipulate
-pixbufs, see the #GdkPixbuf API documentation.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### FUNCTION gdk_pixbuf_render_threshold_alpha ##### -->
-<para>
-
-</para>
-
-@pixbuf: 
-@bitmap: 
-@src_x: 
-@src_y: 
-@dest_x: 
-@dest_y: 
-@width: 
-@height: 
-@alpha_threshold: 
-
-
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION gdk_pixbuf_render_pixmap_and_mask ##### -->
-<para>
-
-</para>
-
-@pixbuf: 
-@pixmap_return: 
-@mask_return: 
-@alpha_threshold: 
-
-
-<!-- ##### FUNCTION gdk_pixbuf_render_pixmap_and_mask_for_colormap ##### -->
-<para>
-
-</para>
-
-@pixbuf: 
-@colormap: 
-@pixmap_return: 
-@mask_return: 
-@alpha_threshold: 
-
-
-<!-- ##### FUNCTION gdk_pixbuf_get_from_drawable ##### -->
-<para>
-
-</para>
-
-@dest: 
-@src: 
-@cmap: 
-@src_x: 
-@src_y: 
-@dest_x: 
-@dest_y: 
-@width: 
-@height: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_pixbuf_get_from_surface ##### -->
-<para>
-
-</para>
-
-@dest: 
-@surface: 
-@src_x: 
-@src_y: 
-@dest_x: 
-@dest_y: 
-@width: 
-@height: 
-@Returns: 
-
-
diff --git a/gdk/gdkpixbuf-drawable.c b/gdk/gdkpixbuf-drawable.c
index 1e63810597..1e2f29fd43 100644
--- a/gdk/gdkpixbuf-drawable.c
+++ b/gdk/gdkpixbuf-drawable.c
@@ -31,7 +31,16 @@
 #include "gdkinternals.h"
 
 
-/* Exported functions */
+/**
+ * SECTION:pixbufs
+ * @Short_description: Functions for rendering pixbufs on drawables
+ * @Title: Pixbufs
+ *
+ * These functions allow to render pixbufs on drawables. Pixbufs are
+ * client-side images. For details on how to create and manipulate
+ * pixbufs, see the #GdkPixbuf API documentation.
+ */
+
 
 /**
  * gdk_pixbuf_get_from_window: