Eog: a bunch of instrospection warning fixes

Eog introspection seems in a need of a complete review.

3 files changed, 75 insertions, 0 deletions

diff --git a/src/eog-image.c b/src/eog-image.c
index 0ac68486..0d6e0913 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 939ecc57..2f56726e 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 907fbbb2..bae78032 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)
 {