From 19448b971264e0373553ae06a55522d1f7e7dfd2 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Javier=20Jard=C3=B3n?= <jjardon@gnome.org>
Date: Sun, 16 May 2010 02:11:16 +0200
Subject: [PATCH] Move documentation to inline comments: GtkPrinter

---
 docs/reference/gtk/tmpl/.gitignore      |   1 +
 docs/reference/gtk/tmpl/gtkprinter.sgml | 336 ------------------------
 gtk/gtkprinter.c                        |  19 ++
 gtk/gtkprinter.h                        |  13 +
 4 files changed, 33 insertions(+), 336 deletions(-)
 delete mode 100644 docs/reference/gtk/tmpl/gtkprinter.sgml

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 123a23439..c870daad1 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -6,6 +6,7 @@ gtkmessagedialog.sgml
 gtkobject.sgml
 gtkorientable.sgml
 gtkpagesetupunixdialog.sgml
+gtkprinter.sgml
 gtkradioaction.sgml
 gtkrecentaction.sgml
 gtkrecentchooserwidget.sgml
diff --git a/docs/reference/gtk/tmpl/gtkprinter.sgml b/docs/reference/gtk/tmpl/gtkprinter.sgml
deleted file mode 100644
index 3a3f6791a..000000000
--- a/docs/reference/gtk/tmpl/gtkprinter.sgml
+++ /dev/null
@@ -1,336 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkPrinter
-
-<!-- ##### SECTION Short_Description ##### -->
-Represents a printer
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-A #GtkPrinter object represents a printer. You only need to 
-deal directly with printers if you use the non-portable 
-#GtkPrintUnixDialog API. 
-</para>
-<para>
-A #GtkPrinter allows to get status information about the printer, 
-such as its description, its location, the number of queued jobs, 
-etc. Most importantly, a #GtkPrinter object can be used to create
-a #GtkPrintJob object, which lets you print to the printer.
-</para>
-
-<para>
-Printing support was added in GTK+ 2.10.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkPrinter ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SIGNAL GtkPrinter::details-acquired ##### -->
-<para>
-
-</para>
-
-@printer: the object which received the signal.
-@arg1: 
-
-<!-- ##### ARG GtkPrinter:accepting-jobs ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkPrinter:accepts-pdf ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkPrinter:accepts-ps ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkPrinter:backend ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkPrinter:icon-name ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkPrinter:is-virtual ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkPrinter:job-count ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkPrinter:location ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkPrinter:name ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkPrinter:paused ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkPrinter:state-message ##### -->
-<para>
-
-</para>
-
-<!-- ##### STRUCT GtkPrintBackend ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION gtk_printer_new ##### -->
-<para>
-
-</para>
-
-@name: 
-@backend: 
-@virtual_: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_get_backend ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_get_name ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_get_state_message ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_get_description ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_get_location ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_get_icon_name ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_get_job_count ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_is_active ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_is_paused ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_is_accepting_jobs ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_is_virtual ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_is_default ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_accepts_ps ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_accepts_pdf ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_list_papers ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_compare ##### -->
-<para>
-
-</para>
-
-@a: 
-@b: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_has_details ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_request_details ##### -->
-<para>
-
-</para>
-
-@printer: 
-
-
-<!-- ##### FUNCTION gtk_printer_get_capabilities ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_get_default_page_size ##### -->
-<para>
-
-</para>
-
-@printer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_printer_get_hard_margins ##### -->
-<para>
-
-</para>
-
-@printer: 
-@top: 
-@bottom: 
-@left: 
-@right: 
-@Returns: 
-
-
-<!-- ##### USER_FUNCTION GtkPrinterFunc ##### -->
-<para>
-The type of function passed to gtk_enumerate_printers().
-Note that you need to ref @printer, if you want to keep
-a reference to it after the function has returned.
-</para>
-
-@printer: a #GtkPrinter
-@data: user data passed to gtk_enumerate_printers()
-@Returns: %TRUE to stop the enumeration, %FALSE to continue
-
-
-<!-- ##### FUNCTION gtk_enumerate_printers ##### -->
-<para>
-
-</para>
-
-@func: 
-@data: 
-@destroy: 
-@wait: 
-
-
diff --git a/gtk/gtkprinter.c b/gtk/gtkprinter.c
index 1ffaaf5bc..928896ab1 100644
--- a/gtk/gtkprinter.c
+++ b/gtk/gtkprinter.c
@@ -31,6 +31,25 @@
 #include "gtkprintjob.h"
 #include "gtkalias.h"
 
+
+/**
+ * SECTION:gtkprinter
+ * @Short_description: Represents a printer
+ * @Title: GtkPrinter
+ *
+ * A #GtkPrinter object represents a printer. You only need to
+ * deal directly with printers if you use the non-portable
+ * #GtkPrintUnixDialog API.
+ *
+ * A #GtkPrinter allows to get status information about the printer,
+ * such as its description, its location, the number of queued jobs,
+ * etc. Most importantly, a #GtkPrinter object can be used to create
+ * a #GtkPrintJob object, which lets you print to the printer.
+ *
+ * Printing support was added in GTK+ 2.10.
+ */
+
+
 #define GTK_PRINTER_GET_PRIVATE(o)  \
    (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_PRINTER, GtkPrinterPrivate))
 
diff --git a/gtk/gtkprinter.h b/gtk/gtkprinter.h
index e2cb53496..cb5bcbd05 100644
--- a/gtk/gtkprinter.h
+++ b/gtk/gtkprinter.h
@@ -119,6 +119,19 @@ gboolean                 gtk_printer_get_hard_margins      (GtkPrinter       *pr
                                                             gdouble          *left,
                                                             gdouble          *right);
 
+/**
+ * GtkPrinterFunc:
+ * @printer: a #GtkPrinter
+ * @data: user data passed to gtk_enumerate_printers()
+ *
+ * The type of function passed to gtk_enumerate_printers().
+ * Note that you need to ref @printer, if you want to keep
+ * a reference to it after the function has returned.
+ *
+ * Returns: %TRUE to stop the enumeration, %FALSE to continue
+ *
+ * Since: 2.10
+ */
 typedef gboolean (*GtkPrinterFunc) (GtkPrinter *printer,
 				    gpointer    data);
 
-- 
2.43.2