Add some docs.

2006-06-07  Matthias Clasen  <mclasen@redhat.com>

	* gtk/gtkprintoperation.c: Add some docs.

	* gtk/gtk.symbols: Add gtk_print_operation_set_allow_async.

	* gtk/gtkprintoperation.h: Remove gtk_print_operation_run_async.

diff --git a/ChangeLog b/ChangeLog
index 913a8209c5fb62e16f54f4fa2b672a23e6fe3744..24cd29846d702c5f33c5338f6beeb8a879893282 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
 2006-06-07  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/gtkprintoperation.c: Add some docs. 
+
+       * gtk/gtk.symbols: Add gtk_print_operation_set_allow_async.
+
+       * gtk/gtkprintoperation.h: Remove gtk_print_operation_run_async.
+
        * tests/testnotebookdnd.c: Update callers.
 
        * gtk/gtknotebook.h:

diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index 913a8209c5fb62e16f54f4fa2b672a23e6fe3744..24cd29846d702c5f33c5338f6beeb8a879893282 100644 (file)
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,5 +1,11 @@
 2006-06-07  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/gtkprintoperation.c: Add some docs. 
+
+       * gtk/gtk.symbols: Add gtk_print_operation_set_allow_async.
+
+       * gtk/gtkprintoperation.h: Remove gtk_print_operation_run_async.
+
        * tests/testnotebookdnd.c: Update callers.
 
        * gtk/gtknotebook.h:

diff --git a/gtk/gtk.symbols b/gtk/gtk.symbols
index 0af6aad0cb4a515fd73d40254a5def6616e79d39..545c26f05a3f27a17d4c91479519246fc5fbdd2b 100644 (file)
--- a/gtk/gtk.symbols
+++ b/gtk/gtk.symbols
@@ -2688,6 +2688,7 @@ gtk_print_job_get_track_print_status
 gtk_print_error_quark
 gtk_print_operation_get_type G_GNUC_CONST
 gtk_print_operation_new
+gtk_print_operation_set_allow_async
 gtk_print_operation_set_default_page_setup
 gtk_print_operation_get_default_page_setup
 gtk_print_operation_set_print_settings

diff --git a/gtk/gtkprintoperation.c b/gtk/gtkprintoperation.c
index 861d482acd048cb48db73ca62657562eb4ed82d4..b0ecbce6bd9dc42351a664033d8a114e9ce0b8c3 100644 (file)
--- a/gtk/gtkprintoperation.c
+++ b/gtk/gtkprintoperation.c
@@ -1025,7 +1025,7 @@ gtk_print_operation_class_init (GtkPrintOperationClass *class)
    *
    * Determines whether the print operation may run asynchronous or not.
    * Some systems don't support asynchronous printing, but those that do
-   * will return GTK_PRINT_OPERATION_RESULT_IN_PROGRESS as the status, and
+   * will return %GTK_PRINT_OPERATION_RESULT_IN_PROGRESS as the status, and
    * emit the done signal when the operation is actually done.
    *
    * Since: 2.10
@@ -1607,6 +1607,17 @@ gtk_print_operation_set_show_progress (GtkPrintOperation  *op,
     }
 }
 
+/**
+ * gtk_print_operation_set_allow_async:
+ * @op: a #GtkPrintOperation
+ * @allow_async: %TRUE to allow asynchronous operation
+ *
+ * Sets whether the gtk_print_operation_run() may return
+ * before the print operation is completed. Note that
+ * some platforms may not allow asynchronous operation.
+ *
+ * Since: 2.10
+ */
 void
 gtk_print_operation_set_allow_async (GtkPrintOperation  *op,
                                     gboolean            allow_async)
@@ -2300,7 +2311,7 @@ gtk_print_operation_get_error (GtkPrintOperation  *op)
  * @op to obtain some information about the progress of the print operation. 
  * Furthermore, it may use a recursive mainloop to show the print dialog.
  *
- * If you call gtk_print_operation_set_allow_async () or set the allow-async
+ * If you call gtk_print_operation_set_allow_async() or set the allow-async
  * property the operation will run asyncronously if this is supported on the
  * platform. The ::done signal will be emitted with the operation results when
  * the operation is done (i.e. when the dialog is canceled, or when the print

diff --git a/gtk/gtkprintoperation.h b/gtk/gtkprintoperation.h
index ac144f4ff3f45f424607b804e74fe2dd85e020d7..d524223cdf1b01132fc08ea23ff86ebf38736fe3 100644 (file)
--- a/gtk/gtkprintoperation.h
+++ b/gtk/gtkprintoperation.h
@@ -176,8 +176,6 @@ GtkPageSetup           *gtk_print_run_page_setup_dialog            (GtkWindow
 typedef void  (* GtkPageSetupDoneFunc) (GtkPageSetup *page_setup, 
                                        gpointer      data);
 
-void                    gtk_print_operation_run_async              (GtkPrintOperation    *op,
-                                                                   GtkWindow            *parent);
 void                    gtk_print_run_page_setup_dialog_async      (GtkWindow            *parent,
                                                                    GtkPageSetup         *page_setup,
                                                                    GtkPrintSettings     *settings,