docs: Move documentation to inline comments: drawing

diff --git a/docs/reference/gdk/tmpl/.gitignore b/docs/reference/gdk/tmpl/.gitignore
index 7b5f673a1e652fe30191253047103545af4c0026..3823d757ea4fba0884d804690c962413a2e1f4df 100644 (file)
--- a/docs/reference/gdk/tmpl/.gitignore
+++ b/docs/reference/gdk/tmpl/.gitignore
@@ -2,6 +2,7 @@ cairo_interaction.sgml
 colors.sgml
 cursors.sgml
 dnd.sgml
+drawing.sgml
 events.sgml
 gdkapplaunchcontext.sgml
 gdkdisplay.sgml

diff --git a/docs/reference/gdk/tmpl/drawing.sgml b/docs/reference/gdk/tmpl/drawing.sgml
deleted file mode 100644 (file)
index 351cc8e..0000000
--- a/docs/reference/gdk/tmpl/drawing.sgml
+++ /dev/null
@@ -1,65 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-Drawing Primitives
-
-<!-- ##### SECTION Short_Description ##### -->
-Functions for drawing points, lines, arcs, and text
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-These functions provide support for drawing points, lines, arcs and text
-onto what are called 'drawables'. Drawables, as the name suggests, are things
-which support drawing onto them, and are either #GdkWindow or #GdkPixmap
-objects.
-</para>
-<para>
-Many of the drawing operations take a #GdkGC argument, which represents a
-graphics context. This #GdkGC contains a number of drawing attributes such
-as foreground color, background color and line width, and is used to reduce
-the number of arguments needed for each drawing operation. See the
-<link linkend="gdk-Graphics-Contexts">Graphics Contexts</link> section for
-more information.
-</para>
-<para id="pango-data-structures">
-Some of the drawing operations take Pango data structures like #PangoContext,
-#PangoLayout or #PangoLayoutLine as arguments. If you're using GTK+, the ususal 
-way to obtain these structures is via gtk_widget_create_pango_context() or
-gtk_widget_create_pango_layout().
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GdkDrawable ##### -->
-<para>
-An opaque structure representing an object that can be
-drawn onto. This can be a #GdkPixmap, a #GdkBitmap,
-or a #GdkWindow.
-</para>
-
-
-<!-- ##### FUNCTION gdk_drawable_get_clip_region ##### -->
-<para>
-
-</para>
-
-@drawable: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_drawable_get_visible_region ##### -->
-<para>
-
-</para>
-
-@drawable: 
-@Returns: 
-
-

diff --git a/gdk/gdkdrawable.h b/gdk/gdkdrawable.h
index 72f3dc1c9165513e0dab10e912248b82e449e6cb..a32c18524f7b3ee1e52209bcd877713c61ffb4eb 100644 (file)
--- a/gdk/gdkdrawable.h
+++ b/gdk/gdkdrawable.h
@@ -47,6 +47,12 @@ typedef struct _GdkDrawableClass GdkDrawableClass;
 #define GDK_IS_DRAWABLE_CLASS(klass)   (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_DRAWABLE))
 #define GDK_DRAWABLE_GET_CLASS(obj)    (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_DRAWABLE, GdkDrawableClass))
 
+/**
+ * GdkDrawable:
+ *
+ * An opaque structure representing an object that can be
+ * drawn onto.
+ */
 struct _GdkDrawable
 {
   GObject parent_instance;