GNOME.org
 

[gtranslator] Fix gobject-introspection scanner warnings

commit c5cbbd1f0d267d20b3d301f0ac5d4fd0b410e8df
Author: Garrett Regier <garrettregier gmail com>
Date:   Fri May 25 06:46:29 2012 -0700

    Fix gobject-introspection scanner warnings

 src/Makefile.am             |    2 +-
 src/gtr-application.c       |    3 ++-
 src/gtr-application.h       |    2 --
 src/gtr-header.c            |    7 +++++++
 src/gtr-message-container.c |    7 +++++++
 src/gtr-message-table.c     |   10 +++++++++-
 src/gtr-po.c                |   36 +++++++++++++++++++++++-------------
 src/gtr-tab.c               |    3 ++-
 src/gtr-window.c            |    7 ++++---
 9 files changed, 55 insertions(+), 22 deletions(-)
---
diff --git a/src/Makefile.am b/src/Makefile.am
index 0e61c0c..ce3922f 100644
--- a/src/Makefile.am
+++ b/src/Makefile.am
@@ -63,6 +63,7 @@ INST_H_FILES = \
 	gtr-context.h \
 	gtr-debug.h \
 	gtr-header.h \
+	gtr-message-container.h \
 	gtr-message-table.h \
 	gtr-msg.h \
 	gtr-notebook.h \
@@ -89,7 +90,6 @@ NOINST_H_FILES = \
 	gtr-jump-dialog.h \
 	gtr-language.h \
 	gtr-languages-fetcher.h \
-	gtr-message-container.h \
 	gtr-message-table-model.h \
 	gtr-plugins-engine.h \
 	gtr-preferences-dialog.h \
diff --git a/src/gtr-application.c b/src/gtr-application.c
index 078d0d4..7d7dc19 100644
--- a/src/gtr-application.c
+++ b/src/gtr-application.c
@@ -516,7 +516,8 @@ _gtr_application_save_toolbars_model (GtrApplication * application)
  *
  * Returns all the views currently present in #GtranslationApplication.
  *
- * Return value: (transfer container): a newly allocated list of #GtranslationApplication objects
+ * Return value: (transfer container) (element-type Gtranslator.View):
+ * a newly allocated list of #GtranslationApplication objects
  */
 GList *
 gtr_application_get_views (GtrApplication * app,
diff --git a/src/gtr-application.h b/src/gtr-application.h
index ee22fa4..1e68a8c 100644
--- a/src/gtr-application.h
+++ b/src/gtr-application.h
@@ -69,8 +69,6 @@ GtrWindow        *gtr_application_create_window          (GtrApplication *app);
 
 GtrWindow        *gtr_application_get_active_window      (GtrApplication *app);
 
-const GList      *gtr_application_get_windows            (GtrApplication *app);
-
 void              gtr_application_register_icon          (GtrApplication *app,
                                                           const gchar    *icon,
                                                           const gchar    *stock_id);
diff --git a/src/gtr-header.c b/src/gtr-header.c
index 8a0a373..d2c42fb 100644
--- a/src/gtr-header.c
+++ b/src/gtr-header.c
@@ -186,6 +186,13 @@ gtr_header_class_init (GtrHeaderClass * klass)
 
 /* Public methods */
 
+/**
+ * gtr_header_new: (skip)
+ * @iter:
+ * @message:
+ *
+ * Return value:
+ */
 GtrHeader *
 gtr_header_new (po_message_iterator_t iter, po_message_t message)
 {
diff --git a/src/gtr-message-container.c b/src/gtr-message-container.c
index 8b99307..170f664 100644
--- a/src/gtr-message-container.c
+++ b/src/gtr-message-container.c
@@ -31,6 +31,13 @@ gtr_message_container_default_init (GtrMessageContainerInterface * iface)
 {
 }
 
+/**
+ * gtr_message_container_get_message:
+ * @container:
+ * @number:
+ *
+ * Returns: (transfer none):
+ */
 GtrMsg *
 gtr_message_container_get_message (GtrMessageContainer * container,
                                    gint number)
diff --git a/src/gtr-message-table.c b/src/gtr-message-table.c
index c0bd706..752d28a 100644
--- a/src/gtr-message-table.c
+++ b/src/gtr-message-table.c
@@ -283,7 +283,7 @@ gtr_message_table_new (GtkWidget * tab)
 /**
  * gtr_message_table_populate:
  * @table: a #GtrMessageTable
- * @messages: a list of #GtrMsg
+ * @container: a list of #GtrMsg
  *
  * Populates the #GtrMessageTable with the list of #GtrMsg and
  * sort them.
@@ -322,6 +322,14 @@ gtr_message_table_populate (GtrMessageTable * table, GtrMessageContainer * conta
                            table->priv->sort_model);
 }
 
+/**
+ * gtr_message_table_navigate:
+ * @table:
+ * @navigation:
+ * @func: (scope call):
+ *
+ * Returns: (transfer none):
+ */
 GtrMsg *
 gtr_message_table_navigate (GtrMessageTable * table,
                             GtrMessageTableNavigation navigation,
diff --git a/src/gtr-po.c b/src/gtr-po.c
index ee31697..0a83785 100644
--- a/src/gtr-po.c
+++ b/src/gtr-po.c
@@ -909,7 +909,8 @@ gtr_po_get_write_perms (GtrPo * po)
  * gtr_po_get_messages:
  * @po: a #GtrPo
  *
- * Return value: (transfer container): a pointer to the messages list
+ * Return value: (transfer container) (element-type Gtranslator.Msg):
+ *               a pointer to the messages list
  **/
 GList *
 gtr_po_get_messages (GtrPo * po)
@@ -919,11 +920,11 @@ gtr_po_get_messages (GtrPo * po)
   return po->priv->messages;
 }
 
+/* FIXME: this is hack, we should fix it */
 /**
- * FIXME: this is hack, we should fix it
  * gtr_po_set_messages:
  * @po: a #GtrPo
- * @messages: a pointer to a new messages list.
+ * @messages: (element-type Gtranslator.Msg): a pointer to a new messages list.
  *
  * Sets an updated list of messages.
  **/
@@ -939,7 +940,8 @@ gtr_po_set_messages (GtrPo * po, GList * messages)
  * gtr_po_get_current_message:
  * @po: a #GtrPo
  *
- * Return value: (transfer none) (element-type GtrMsg): a pointer to the current message
+ * Return value: (transfer none) (element-type Gtranslator.Msg):
+ *               a pointer to the current message
  **/
 GList *
 gtr_po_get_current_message (GtrPo * po)
@@ -967,7 +969,8 @@ gtr_po_update_current_message (GtrPo * po, GtrMsg * msg)
  * gtr_po_get_domains:
  * @po: a #GtrPo
  *
- * Return value: (transfer none): a pointer to the domains list
+ * Return value: (transfer none) (element-type utf8):
+ *               a pointer to the domains list
  **/
 GList *
 gtr_po_get_domains (GtrPo * po)
@@ -976,7 +979,7 @@ gtr_po_get_domains (GtrPo * po)
 }
 
 /**
- * gtr_po_get_po_file:
+ * gtr_po_get_po_file: (skip)
  * @po: a #GtrPo
  *
  * Gets the gettext file.
@@ -993,7 +996,8 @@ gtr_po_get_po_file (GtrPo * po)
  * gtr_po_get_next_fuzzy:
  * @po: a #GtrPo
  *
- * Return value: (transfer none): a pointer to the next fuzzy message
+ * Return value: (transfer none) (element-type Gtranslator.Msg):
+ *               a pointer to the next fuzzy message
  **/
 GList *
 gtr_po_get_next_fuzzy (GtrPo * po)
@@ -1015,7 +1019,8 @@ gtr_po_get_next_fuzzy (GtrPo * po)
  * gtr_po_get_prev_fuzzy:
  * @po: a #GtrPo
  *
- * Return value: (transfer none): a pointer to the previously fuzzy message
+ * Return value: (transfer none) (element-type Gtranslator.Msg):
+ *               a pointer to the previously fuzzy message
  **/
 GList *
 gtr_po_get_prev_fuzzy (GtrPo * po)
@@ -1037,7 +1042,8 @@ gtr_po_get_prev_fuzzy (GtrPo * po)
  * gtr_po_get_next_untrans:
  * @po: a #GtrPo
  *
- * Return value: (transfer none): a pointer to the next untranslated message
+ * Return value: (transfer none) (element-type Gtranslator.Msg):
+ *               a pointer to the next untranslated message
  **/
 GList *
 gtr_po_get_next_untrans (GtrPo * po)
@@ -1059,7 +1065,8 @@ gtr_po_get_next_untrans (GtrPo * po)
  * gtr_po_get_prev_untrans:
  * @po: a #GtrPo
  *
- * Return value: (transfer none): a pointer to the previously untranslated
+ * Return value: (transfer none) (element-type Gtranslator.Msg):
+ *                a pointer to the previously untranslated
  *                message or NULL if there are not previously untranslated
  *                message.
  **/
@@ -1082,7 +1089,8 @@ gtr_po_get_prev_untrans (GtrPo * po)
  * gtr_po_get_next_fuzzy_or_untrans:
  * @po: a #GtrPo
  *
- * Return value: (transfer none): a pointer to the next fuzzy or untranslated
+ * Return value: (transfer none) (element-type Gtranslator.Msg):
+ *               a pointer to the next fuzzy or untranslated
  *               message or NULL if there is not next fuzzy or untranslated
  *               message.
  **/
@@ -1105,7 +1113,8 @@ gtr_po_get_next_fuzzy_or_untrans (GtrPo * po)
  * gtr_po_get_prev_fuzzy_or_untrans:
  * @po: a #GtrPo
  *
- * Return value: (transfer none): a pointer to the previously fuzzy or
+ * Return value: (transfer none) (element-type Gtranslator.Msg):
+ *               a pointer to the previously fuzzy or
  *               untranslated message or NULL if there is not previously 
  *               fuzzy or untranslated message.
  **/
@@ -1131,7 +1140,8 @@ gtr_po_get_prev_fuzzy_or_untrans (GtrPo * po)
  *
  * Gets the message at the given position.
  *
- * Returns: (transfer none): the message at the given position.
+ * Returns: (transfer none) (element-type Gtranslator.Msg):
+ *          the message at the given position.
  */
 GList *
 gtr_po_get_msg_from_number (GtrPo * po, gint number)
diff --git a/src/gtr-tab.c b/src/gtr-tab.c
index d7c1052..75fbd35 100644
--- a/src/gtr-tab.c
+++ b/src/gtr-tab.c
@@ -1163,7 +1163,8 @@ gtr_tab_get_active_view (GtrTab * tab)
  *
  * Returns all the views currently present in #GtranslationTab
  *
- * Return: (transfer container): a newly allocated list of #GtranslationTab objects
+ * Returns: (transfer container) (element-type Gtranslator.View):
+ *          a newly allocated list of #GtranslationTab objects
  */
 GList *
 gtr_tab_get_all_views (GtrTab * tab, gboolean original, gboolean translated)
diff --git a/src/gtr-window.c b/src/gtr-window.c
index 8893076..f136346 100644
--- a/src/gtr-window.c
+++ b/src/gtr-window.c
@@ -1732,8 +1732,8 @@ gtr_window_get_active_tab (GtrWindow * window)
  *
  * Gets a list of all tabs in the @window or NULL if there is no tab opened.
  *
- * Returns: (transfer container): a list of all tabs in the @window or NULL if there
- * is no tab opened.
+ * Returns: (transfer container) (element-type Gtranslator.Tab):
+ * a list of all tabs in the @window or NULL if there is no tab opened.
  */
 GList *
 gtr_window_get_all_tabs (GtrWindow * window)
@@ -1858,7 +1858,8 @@ gtr_window_get_active_view (GtrWindow * window)
  *
  * Returns all the views currently present in #GtranslationWindow
  *
- * Return value: (transfer container): a newly allocated list of #GtranslationWindow objects
+ * Return value: (transfer container) (element-type Gtranslator.View):
+ * a newly allocated list of #GtranslationWindow objects
  **/
 GList *
 gtr_window_get_all_views (GtrWindow * window,
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]