[eog/wip/emmanuel/cleanup: 4/4] Eog: a bunch of instrospection warning fixes

[Emmanuel Pacaud <emmanuel src gnome org>]

commit 73fb6ec3698fa5955a05ab25b01cafb2db7bfdac
Author: Emmanuel Pacaud <emmanuel gnome org>
Date:   Wed Aug 26 09:02:24 2015 +0200

    Eog: a bunch of instrospection warning fixes
    
    Eog introspection seems in a need of a complete review.

 src/eog-image.c  |   17 +++++++++++++++++
 src/eog-jobs.c   |   49 +++++++++++++++++++++++++++++++++++++++++++++++++
 src/eog-window.c |    9 +++++++++
 3 files changed, 75 insertions(+), 0 deletions(-)
---
diff --git a/src/eog-image.c b/src/eog-image.c
index 0ac6848..0d6e091 100644
--- a/src/eog-image.c
+++ b/src/eog-image.c
@@ -2432,6 +2432,14 @@ eog_image_get_svg (EogImage *img)
 }
 #endif
 
+/**
+ * eog_image_get_transform:
+ * @img: a #EogImage
+ *
+ * Get @img transform.
+ *
+ * Returns: (transfer none): A #EogTransform.
+ */
 
 EogTransform *
 eog_image_get_transform (EogImage *img)
@@ -2441,6 +2449,15 @@ eog_image_get_transform (EogImage *img)
        return img->priv->trans;
 }
 
+/**
+ * eog_image_get_autorotate_transform:
+ * @img: a #EogImage
+ *
+ * Get @img autorotate transform.
+ *
+ * Returns: (transfer none): A #EogTransform.
+ */
+
 EogTransform*
 eog_image_get_autorotate_transform (EogImage *img)
 {
diff --git a/src/eog-jobs.c b/src/eog-jobs.c
index 939ecc5..2f56726 100644
--- a/src/eog-jobs.c
+++ b/src/eog-jobs.c
@@ -481,6 +481,16 @@ eog_job_copy_run (EogJob *job)
                         g_object_unref);
 }
 
+/**
+ * eog_job_copy_new:
+ * @images: (element-type EogImage) (transfer full): a #EogImage list
+ * @destination: destination path for the copy
+ *
+ * Creates a new #EogJob.
+ *
+ * Returns: A #EogJob.
+ */
+
 EogJob *
 eog_job_copy_new (GList       *images,
                  const gchar *destination)
@@ -757,6 +767,15 @@ eog_job_model_run (EogJob *job)
                         g_object_unref);
 }
 
+/**
+ * eog_job_model_new:
+ * @file_list: (element-type GFile): a #GFile list
+ *
+ * Creates a new #EogJob model.
+ *
+ * Returns: A #EogJob.
+ */
+
 EogJob *
 eog_job_model_new (GSList *file_list)
 {
@@ -937,6 +956,15 @@ eog_job_save_run (EogJob *job)
                         g_object_unref);
 }
 
+/**
+ * eog_job_save_new:
+ * @images: (element-type EogImage) (transfer full): a #EogImage list
+ *
+ * Creates a new #EogJob for image saving.
+ *
+ * Returns: A #EogJob.
+ */
+
 EogJob *
 eog_job_save_new (GList *images)
 {
@@ -1135,6 +1163,17 @@ eog_job_save_as_run (EogJob *job)
                         g_object_unref);
 }
 
+/**
+ * eog_job_save_as_new:
+ * @images: (element-type EogImage) (transfer full): a #EogImage list
+ * @converter: a URI converter
+ * file: a #GFile
+ *
+ * Creates a new #EogJog for save as.
+ *
+ * Returns: A #EogJob.
+ */
+
 EogJob *
 eog_job_save_as_new (GList           *images,
                     EogURIConverter *converter,
@@ -1418,6 +1457,16 @@ eog_job_transform_run (EogJob *job)
                         g_object_unref);
 }
 
+/**
+ * eog_job_transform_new:
+ * @images: (element-type EogImage) (transfer full): a #EogImage list
+ * @transform: a #EogTransform
+ *
+ * Create a new #EogJob for image transformation.
+ *
+ * Returns: A #EogJob.
+ */
+
 EogJob *
 eog_job_transform_new (GList        *images,
                       EogTransform *transform)
diff --git a/src/eog-window.c b/src/eog-window.c
index 907fbbb..bae7803 100644
--- a/src/eog-window.c
+++ b/src/eog-window.c
@@ -3010,6 +3010,15 @@ eog_window_action_print (GSimpleAction *action,
        eog_window_print (window);
 }
 
+/**
+ * eog_window_get_properties_dialog:
+ * @window: a #EogWindow
+ *
+ * Gets the @window property dialog. The widget will be built on the first call to this function.
+ *
+ * Returns: (transfer none): a #GtkWidget.
+ */
+
 GtkWidget*
 eog_window_get_properties_dialog (EogWindow *window)
 {