Document more structs

gdk/gdkclipboard.c

@@ -55,6 +55,13 @@
  * which provides a #GInputStream object.
  */
 
+/**
+ * GdkClipboard:
+ *
+ * The GdkClipboard struct contains only private fields and should not be
+ * accessed directly.
+ */
+
 typedef struct _GdkClipboardPrivate GdkClipboardPrivate;
 
 struct _GdkClipboardPrivate

gdk/gdkcontentprovider.h

@@ -38,6 +38,12 @@ G_BEGIN_DECLS
 
 typedef struct _GdkContentProviderClass GdkContentProviderClass;
 
+/**
+ * GdkContentProvider:
+ *
+ * Should not be directly accessed.
+ */
+
 struct _GdkContentProvider
 {
   GObject parent;

gdk/gdkdevice.c

@@ -42,6 +42,13 @@
  * relationships.
  */
 
+/**
+ * GdkDevice:
+ *
+ * The GdkDevice struct contains only private fields and
+ * should not be accessed directly.
+ */
+
 typedef struct _GdkAxisInfo GdkAxisInfo;
 
 struct _GdkAxisInfo

gdk/gdkdevicepad.c

@@ -42,6 +42,13 @@
  *
  */
 
+/**
+ * GdkDevicePad:
+ *
+ * The GdkDevicePad struct contains only private fields and
+ * should not be accessed directly.
+ */
+
 #include "config.h"
 
 #include "gdkdevicepad.h"

gdk/gdkdisplay.c

@@ -63,6 +63,12 @@
  * with gdk-display_get_monitor() and similar APIs.
  */
 
+/**
+ * GdkDisplay:
+ *
+ * The GdkDisplay struct contains only private field and should not
+ * be accessed directly.
+ */
 enum
 {
   PROP_0,

gdk/gdkdisplaymanager.c

@@ -109,6 +109,12 @@
  * ]|
  */
 
+/**
+ * GdkDisplayManager:
+ *
+ * The GdkDisplayManager struct contains only private fields and
+ * should not be accessed directly.
+ */
 
 enum {
   PROP_0,

gdk/gdkdnd.c

@@ -84,6 +84,13 @@ static GList *contexts = NULL;
  * the GTK+ documentation for more information.
  */
 
+/**
+ * GdkDragContext:
+ *
+ * The GdkDragContext struct contains only private fields and
+ * should not be accessed directly.
+ */
+
 /**
  * gdk_drag_context_get_display:
  * @context: a #GdkDragContext

gdk/gdkdrawcontext.c

@@ -34,8 +34,18 @@
  * rendering methods, such as #GdkGLContext or #GdkVulkanContext. It provides
  * shared functionality between those contexts.
  *
- * You will always interact with one of those subclasses.
+ * You will always interact with one of those s.ubclasses.
+ *
+ * A GdkDrawContext is always associated with a single toplevel window.
+ */
+
+/**
+ * GdkDrawContext:
+ *
+ * The GdkDrawContext struct contains only private fields and should not
+ * be accessed directly.
  */
+
 typedef struct _GdkDrawContextPrivate GdkDrawContextPrivate;
 
 struct _GdkDrawContextPrivate {

gdk/gdkdrawingcontext.c

@@ -32,6 +32,13 @@
  * #GdkDrawingContext is available since GDK 3.22
  */
 
+/**
+ * GdkDrawingContext:
+ *
+ * The GdkDrawingContext struct contains only private fields and should not
+ * be accessed directly.
+ */
+
 #include "config.h"
 
 #include <cairo-gobject.h>

gdk/gdkevents.c

@@ -49,6 +49,19 @@
  * so these functions are rarely needed.
  */
 
+/**
+ * GdkEvent:
+ *
+ * The GdkEvent struct contains only private fields and
+ * should not be accessed directly.
+ */
+
+/**
+ * GdkEventSequence:
+ *
+ * GdkEventSequence is an opaque type representing a sequence
+ * of related touch events.
+ */
 
 typedef struct _GdkIOClosure GdkIOClosure;
 

gdk/gdkframeclock.c

@@ -67,6 +67,13 @@
  * they will stay exactly synchronized.
  */
 
+/**
+ * GdkFrameClock:
+ *
+ * The GdkFrameClock struct contains only private fields and
+ * should not be accessed directly.
+ */
+
 enum {
   FLUSH_EVENTS,
   BEFORE_PAINT,

gdk/gdkframetimings.c

@@ -34,6 +34,13 @@
  * quality metrics for the application’s display, such as latency and jitter.
  */
 
+/**
+ * GdkFrameTimings:
+ *
+ * The GdkFrameTimings struct contains only private fields and
+ * should not be accessed directly.
+ */
+
 G_DEFINE_BOXED_TYPE (GdkFrameTimings, gdk_frame_timings,
                      gdk_frame_timings_ref,
                      gdk_frame_timings_unref)

gdk/gdkglcontext.c

@@ -76,6 +76,13 @@
  * that is currently set by calling gdk_gl_context_clear_current().
  */
 
+/**
+ * GdkGLContext:
+ *
+ * The GdkGLContext struct contains only private fields and
+ * should not be accessed directly.
+ */
+
 #include "config.h"
 
 #include "gdkglcontextprivate.h"

gdk/gdkseat.c

@@ -36,6 +36,13 @@
  * that belong to a user.
  */
 
+/**
+ * GdkSeat:
+ *
+ * The GdkSeat struct contains only private fields and
+ * should not be accessed directly.
+ */
+
 typedef struct _GdkSeatPrivate GdkSeatPrivate;
 
 struct _GdkSeatPrivate

gdk/gdkwindow.c

@@ -68,6 +68,12 @@
  * each #GtkButton has a #GdkWindow associated with it.
  */
 
+/**
+ * GdkWindow:
+ *
+ * The GdkWindow struct contains only private fields and
+ * should not be accessed directly.
+ */
 
 /* Historically a GdkWindow always matches a platform native window,
  * be it a toplevel window or a child window. In this setup the