Doc additions

svn path=/trunk/; revision=22006

diff --git a/ChangeLog b/ChangeLog
index 4c40400e88ab0739920041a017f1db19482dfdf8..813380b9c95704d59c1c9aa75014c743e6cbc5a0 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
+2008-12-30  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtkprintoperationpreview.c: Doc additions
+
 2008-12-29  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/gtkiconview.c:
        * gtk/gtklabel.c:
        * gtk/gtkentry.c:
        * gtk/gtktextview.c:

diff --git a/gtk/gtkprintoperationpreview.c b/gtk/gtkprintoperationpreview.c
index 5363fcd6515d7c2a6e9dea11312e67144083cf9a..3b0ef7c63cb07aef9349570b301488b93f8e7de2 100644 (file)
--- a/gtk/gtkprintoperationpreview.c
+++ b/gtk/gtkprintoperationpreview.c
@@ -65,6 +65,16 @@ gtk_print_operation_preview_base_init (gpointer g_iface)
 
   if (!initialized)
     {
+      /**
+       * GtkPrintOperationPreview::ready:
+       * @preview: the object on which the signal is emitted
+       * @context: the current #GtkPrintContext
+       *
+       * The ::ready signal gets emitted once per preview operation,
+       * before the first page is rendered.
+       * 
+       * A handler for this signal can be used for setup tasks.
+       */
       g_signal_new (I_("ready"),
                    GTK_TYPE_PRINT_OPERATION_PREVIEW,
                    G_SIGNAL_RUN_LAST,
@@ -74,6 +84,19 @@ gtk_print_operation_preview_base_init (gpointer g_iface)
                    G_TYPE_NONE, 1,
                    GTK_TYPE_PRINT_CONTEXT);
 
+      /**
+       * GtkPrintOperationPreview::got-page-size:
+       * @preview: the object on which the signal is emitted
+       * @context: the current #GtkPrintContext
+       * @page_setup: the #GtkPageSetup for the current page
+       *
+       * The ::got-page-size signal is emitted once for each page
+       * that gets rendered to the preview. 
+       *
+       * A handler for this signal should update the @context
+       * according to @page_setup and set up a suitable cairo
+       * context, using gtk_print_context_set_cairo_context().
+       */
       g_signal_new (I_("got-page-size"),
                    GTK_TYPE_PRINT_OPERATION_PREVIEW,
                    G_SIGNAL_RUN_LAST,
@@ -97,6 +120,9 @@ gtk_print_operation_preview_base_init (gpointer g_iface)
  * was passed to the #GtkPrintOperation::preview handler together
  * with @preview.
  *
+ * A custom iprint preview should use this function in its ::expose
+ * handler to render the currently selected page.
+ * 
  * Note that this function requires a suitable cairo context to 
  * be associated with the print context. 
  *