[gtranslator] Add/Fix GObject introspection annotations

From: Ignacio Casal Quinteiro <icq src gnome org>
To: commits-list gnome org
Cc:
Subject: [gtranslator] Add/Fix GObject introspection annotations
Date: Thu, 2 Dec 2010 21:42:12 +0000 (UTC)
commit 2db835ca5572e11c0545b7cdc098600e967a9c06
Author: Kenny Meyer <knny myer gmail com>
Date:   Thu Dec 2 16:16:28 2010 -0300

    Add/Fix GObject introspection annotations

 src/gtr-application.c |   20 ++++++++++++++------
 src/gtr-context.c     |    4 ++--
 src/gtr-header.c      |    8 ++++++++
 src/gtr-msg.c         |   49 ++++++++++++++++++++++++++-----------------------
 src/gtr-notebook.c    |    2 +-
 src/gtr-notebook.h    |    4 ++--
 src/gtr-po.c          |   40 ++++++++++++++++++++++++----------------
 src/gtr-po.h          |    2 +-
 src/gtr-tab.c         |   12 ++++++------
 src/gtr-window.c      |   31 +++++++++++++++++++------------
 10 files changed, 103 insertions(+), 69 deletions(-)
---
diff --git a/src/gtr-application.c b/src/gtr-application.c
index f8191db..2b5ded7 100644
--- a/src/gtr-application.c
+++ b/src/gtr-application.c
@@ -466,7 +466,7 @@ _gtr_application_new ()
  * 
  * Returns the default instance of the application.
  * 
- * Returns: the default instance of the application.
+ * Returns: (transfer none): the default instance of the application.
  */
 GtrApplication *
 gtr_application_get_default (void)
@@ -475,12 +475,12 @@ gtr_application_get_default (void)
 }
 
 /**
- * gtr_application_open_window:
+ * gtr_application_create_window:
  * @app: a #GtrApplication
  *
  * Creates a new #GtrWindow and shows it.
  * 
- * Returns: the #GtrWindow to be opened
+ * Returns: (transfer none):  the #GtrWindow to be opened
  */
 GtrWindow *
 gtr_application_create_window (GtrApplication *app)
@@ -533,7 +533,7 @@ gtr_application_create_window (GtrApplication *app)
  * 
  * Returns the toolbar model.
  * 
- * Retuns: the toolbar model.
+ * Returns: the toolbar model.
  */
 GObject *
 _gtr_application_get_toolbars_model (GtrApplication * application)
@@ -562,7 +562,7 @@ _gtr_application_save_toolbars_model (GtrApplication * application)
  *
  * Returns all the views currently present in #GtranslationApplication.
  *
- * Return value: a newly allocated list of #GtranslationApplication objects
+ * Return value: (transfer container): a newly allocated list of #GtranslationApplication objects
  */
 GList *
 gtr_application_get_views (GtrApplication * app,
@@ -584,7 +584,7 @@ gtr_application_get_views (GtrApplication * app,
  * gtr_application_get_active_window:
  * @app: a #GtrApplication
  * 
- * Return value: the active #GtrWindow
+ * Return value: (transfer none): the active #GtrWindow
  **/
 GtrWindow *
 gtr_application_get_active_window (GtrApplication * app)
@@ -659,6 +659,14 @@ _gtr_application_set_last_dir (GtrApplication * app, const gchar * last_dir)
   app->priv->last_dir = g_strdup (last_dir);
 }
 
+/**
+ * gtr_application_get_translation_memory:
+ * @app: a #GtrApplication
+ *
+ * Gets the translation memory.
+ *
+ * Returns: (transfer none): Get the translation memory.
+ */
 GObject *
 gtr_application_get_translation_memory (GtrApplication * app)
 {
diff --git a/src/gtr-context.c b/src/gtr-context.c
index 866fbb1..ef7f51a 100644
--- a/src/gtr-context.c
+++ b/src/gtr-context.c
@@ -512,10 +512,10 @@ gtr_context_panel_new (GtkWidget *tab)
 }
 
 /**
- * gtr_context_panel_get_extracted_text_view:
+ * gtr_context_panel_get_context_text_view:
  * @panel: a #GtrContextPanel
  *
- * Returns: the context #GtkTextView
+ * Returns: (transfer none): the context #GtkTextView
  */
 GtkTextView *
 gtr_context_panel_get_context_text_view (GtrContextPanel * panel)
diff --git a/src/gtr-header.c b/src/gtr-header.c
index cd821a2..e52f519 100644
--- a/src/gtr-header.c
+++ b/src/gtr-header.c
@@ -736,6 +736,14 @@ gtr_header_set_profile (GtrHeader  *header,
   header->priv->profile = g_object_ref (profile);
 }
 
+/**
+ * gtr_header_get_profile:
+ * @header: a #GtrHeader
+ *
+ * Gets the profile of the header
+ *
+ * Return value: (transfer none): the profile of the header.
+ */
 GtrProfile *
 gtr_header_get_profile (GtrHeader *header)
 {
diff --git a/src/gtr-msg.c b/src/gtr-msg.c
index 294c17c..f257084 100644
--- a/src/gtr-msg.c
+++ b/src/gtr-msg.c
@@ -144,10 +144,12 @@ gtr_msg_class_init (GtrMsgClass * klass)
 
 /**
  * gtr_msg_new:
- * 
+ * @iter: the po_message_iterator_t to set into the @msg
+ * @message: the
+ *
  * Creates a new #GtrMsg.
- * 
- * Return value: a new #GtrMsg object
+ *
+ * Return value: (transfer full): a new #GtrMsg object
  **/
 GtrMsg *
 gtr_msg_new (po_message_iterator_t iter, po_message_t message)
@@ -189,7 +191,7 @@ gtr_msg_get_iterator (GtrMsg * msg)
 /**
  * gtr_msg_set_iterator:
  * @msg: a #GtrMsg
- * @message: the po_message_iterator_t to set into the @msg
+ * @iter: the po_message_iterator_t to set into the @msg
  *
  * Sets the iterator into the #GtrMsg class.
  **/
@@ -253,7 +255,7 @@ gtr_msg_get_row_reference (GtrMsg * msg)
 /**
  * gtr_msg_set_row_reference:
  * @msg: a #GtrMsg
- * @tree_iter: the GtkTreeRowReference corresponding to position in the message table
+ * @row_reference: the GtkTreeRowReference corresponding to position in the message table
  *
  * Sets the GtkTreeRowReference from the messages table for the given message
  **/
@@ -374,8 +376,8 @@ gtr_msg_get_msgid (GtrMsg * msg)
  * gtr_msg_get_msgid_plural:
  * @msg: a #GtrMsg
  * 
- * Return value: the msgid_plural (untranslated English plural string) of a
- * message, or NULL for a message without plural.
+ * Return value: (transfer none): the msgid_plural (untranslated English plural
+ *               string) of a message, or NULL for a message without plural.
  **/
 const gchar *
 gtr_msg_get_msgid_plural (GtrMsg * msg)
@@ -388,7 +390,7 @@ gtr_msg_get_msgid_plural (GtrMsg * msg)
  * gtr_msg_get_msgstr:
  * @msg: a #GtrMsg
  * 
- * Return value: the msgstr (translation) of a message.
+ * Return value: (transfer none): the msgstr (translation) of a message.
  * Return the empty string for an untranslated message.
  **/
 const gchar *
@@ -423,8 +425,9 @@ gtr_msg_set_msgstr (GtrMsg * msg, const gchar * msgstr)
  * @msg: a #GtrMsg
  * @index: the index of the plural array
  *
- * Return value: the msgstr[index] for a message with plural handling, or
- * NULL when the index is out of range or for a message without plural.
+ * Return value: (transfer none): the msgstr[index] for a message with plural
+ *               handling, or NULL when the index is out of range or for a
+ *               message without plural.
  **/
 const gchar *
 gtr_msg_get_msgstr_plural (GtrMsg * msg, gint index)
@@ -457,7 +460,7 @@ gtr_msg_set_msgstr_plural (GtrMsg * msg, gint index, const gchar * msgstr)
  * gtr_msg_get_comment:
  * @msg: a #GtrMsg
  *
- * Return value: the comments for a message.
+ * Return value: (transfer none) the comments for a message.
  **/
 const gchar *
 gtr_msg_get_comment (GtrMsg * msg)
@@ -521,7 +524,7 @@ gtr_msg_set_po_position (GtrMsg * msg, gint po_position)
  * gtr_msg_get_extracted_comments:
  * @msg: a #GtrMsg
  *
- * Return value: the extracted comments for a message.
+ * Return value: (transfer none): the extracted comments for a message.
  **/
 const gchar *
 gtr_msg_get_extracted_comments (GtrMsg * msg)
@@ -536,8 +539,8 @@ gtr_msg_get_extracted_comments (GtrMsg * msg)
  * @msg: a #GtrMsg
  * @i: the i-th file for a message.
  *
- * Return value: the i-th filename for a message, or NULL if @i is out
- * of range.
+ * Return value: (transfer none): the i-th filename for a message, or NULL if
+ *               @i is out of range.
  */
 const gchar *
 gtr_msg_get_filename (GtrMsg * msg, gint i)
@@ -559,8 +562,8 @@ gtr_msg_get_filename (GtrMsg * msg, gint i)
  * @msg: a #GtrMsg
  * @i: the i-th file for a message.
  *
- * Return value: the i-th file line for a message, or NULL if @i is out
- * of range.
+ * Return value: (transfer none): the i-th file line for a message, or NULL if
+ *               @i is out of range.
  */
 gint *
 gtr_msg_get_file_line (GtrMsg * msg, gint i)
@@ -581,8 +584,8 @@ gtr_msg_get_file_line (GtrMsg * msg, gint i)
  * gtr_msg_get_msgctxt:
  * @msg: a #GtrMsg
  *
- * Return value: the context of a message, or NULL for a 
- * message not restricted to a context.
+ * Return value: (transfer none): the context of a message, or NULL for a
+ *               message not restricted to a context.
  */
 const gchar *
 gtr_msg_get_msgctxt (GtrMsg * msg)
@@ -600,8 +603,8 @@ gtr_msg_get_msgctxt (GtrMsg * msg)
  * For example, for "csharp-format", return "C#".
  * Return NULL if the are no format type in the message.
  * 
- * Return value: the pretty name associated with a format type or NULL
- * if the message hasn't any format type.
+ * Return value: (transfer none): the pretty name associated with a format type
+ *               or NULL if the message hasn't any format type.
  */
 const gchar *
 gtr_msg_get_format (GtrMsg * msg)
@@ -655,11 +658,11 @@ on_gettext_po_xerror2 (gint severity,
  * gtr_msg_check:
  * @msg: a #GtrMsg
  * 
- * Return value: the message error or NULL if there is not any error. Must be
- * freed with g_free.
- *
  * Test whether the message translation is a valid format string if the message
  * is marked as being a format string.  
+ *
+ * Return value: (transfer full): the message error or NULL if there is not any
+ *               error. Must be freed with g_free.
  **/
 gchar *
 gtr_msg_check (GtrMsg * msg)
diff --git a/src/gtr-notebook.c b/src/gtr-notebook.c
index a17883c..cbec70b 100644
--- a/src/gtr-notebook.c
+++ b/src/gtr-notebook.c
@@ -194,7 +194,7 @@ gtr_notebook_remove_page (GtrNotebook * notebook, gint page_num)
  * 
  * Gets the selected page in the #GtrNotebook.
  * 
- * Returns: the selected page in the @notebook
+ * Returns: (transfer none): the selected page in the @notebook
  */
 GtrTab *
 gtr_notebook_get_page (GtrNotebook * notebook)
diff --git a/src/gtr-notebook.h b/src/gtr-notebook.h
index 9e9d511..51ad720 100644
--- a/src/gtr-notebook.h
+++ b/src/gtr-notebook.h
@@ -69,9 +69,9 @@ gtr_notebook_get_type (void)
 
      GtkWidget *gtr_notebook_new (void);
 
-     void gtr_notebook_add_page (GtrNotebook * notebook, GtrTab * pax);
+     void gtr_notebook_add_page (GtrNotebook * notebook, GtrTab * tab);
 
-     void gtr_notebook_remove_page (GtrNotebook * notebook, gint i);
+     void gtr_notebook_remove_page (GtrNotebook * notebook, gint page_num);
 
      GtrTab *gtr_notebook_get_page (GtrNotebook * notebook);
 
diff --git a/src/gtr-po.c b/src/gtr-po.c
index e941706..8c6595e 100644
--- a/src/gtr-po.c
+++ b/src/gtr-po.c
@@ -60,6 +60,7 @@ G_DEFINE_TYPE (GtrPo, gtr_po, G_TYPE_OBJECT)
 
 struct _GtrPoPrivate
 {
+  /* The location of the file to open */
   GFile *location;
 
   /* Gettext's file handle */
@@ -617,13 +618,13 @@ gtr_po_save_file (GtrPo * po, GError ** error)
 }
 
 /**
- * gtr_po_get_filename:
+ * gtr_po_get_location:
  * @po: a #GtrPo
  *
  * Gets the GFile of the po file.
  *
- * Returns: the GFile associated with the @po. The returned location must be freed
- * with g_object_unref.
+ * Returns: (transfer full): the GFile associated with the @po. The returned
+ *          location must be freed with g_object_unref.
  **/
 GFile *
 gtr_po_get_location (GtrPo * po)
@@ -697,7 +698,7 @@ gtr_po_get_write_perms (GtrPo * po)
  * gtr_po_get_messages:
  * @po: a #GtrPo
  *
- * Return value: a pointer to the messages list
+ * Return value: (transfer container): a pointer to the messages list
  **/
 GList *
 gtr_po_get_messages (GtrPo * po)
@@ -722,7 +723,7 @@ gtr_po_set_messages (GtrPo * po, GList * messages)
  * gtr_po_get_current_message:
  * @po: a #GtrPo
  *
- * Return value: a pointer to the current message
+ * Return value: (transfer none): a pointer to the current message
  **/
 GList *
 gtr_po_get_current_message (GtrPo * po)
@@ -751,7 +752,7 @@ gtr_po_update_current_message (GtrPo * po, GtrMsg * msg)
  * gtr_po_get_domains:
  * @po: a #GtrPo
  *
- * Return value: a pointer to the domains list
+ * Return value: (transfer none): a pointer to the domains list
  **/
 GList *
 gtr_po_get_domains (GtrPo * po)
@@ -763,6 +764,8 @@ gtr_po_get_domains (GtrPo * po)
  * gtr_po_get_po_file:
  * @po: a #GtrPo
  *
+ * Gets the gettext file.
+ *
  * Return value: the gettext file
  **/
 po_file_t
@@ -775,7 +778,7 @@ gtr_po_get_po_file (GtrPo * po)
  * gtr_po_get_next_fuzzy:
  * @po: a #GtrPo
  *
- * Return value: a pointer to the next fuzzy message
+ * Return value: (transfer none): a pointer to the next fuzzy message
  **/
 GList *
 gtr_po_get_next_fuzzy (GtrPo * po)
@@ -797,7 +800,7 @@ gtr_po_get_next_fuzzy (GtrPo * po)
  * gtr_po_get_prev_fuzzy:
  * @po: a #GtrPo
  *
- * Return value: a pointer to the previously fuzzy message
+ * Return value: (transfer none): a pointer to the previously fuzzy message
  **/
 GList *
 gtr_po_get_prev_fuzzy (GtrPo * po)
@@ -819,7 +822,7 @@ gtr_po_get_prev_fuzzy (GtrPo * po)
  * gtr_po_get_next_untrans:
  * @po: a #GtrPo
  *
- * Return value: a pointer to the next untranslated message
+ * Return value: (transfer none): a pointer to the next untranslated message
  **/
 GList *
 gtr_po_get_next_untrans (GtrPo * po)
@@ -841,8 +844,9 @@ gtr_po_get_next_untrans (GtrPo * po)
  * gtr_po_get_prev_untrans:
  * @po: a #GtrPo
  *
- * Return value: a pointer to the previously untranslated message
- * or NULL if there are not previously untranslated message.
+ * Return value: (transfer none): a pointer to the previously untranslated
+ *                message or NULL if there are not previously untranslated
+ *                message.
  **/
 GList *
 gtr_po_get_prev_untrans (GtrPo * po)
@@ -863,8 +867,9 @@ gtr_po_get_prev_untrans (GtrPo * po)
  * gtr_po_get_next_fuzzy_or_untrans:
  * @po: a #GtrPo
  *
- * Return value: a pointer to the next fuzzy or untranslated message
- * or NULL if there is not next fuzzy or untranslated message.
+ * Return value: (transfer none): a pointer to the next fuzzy or untranslated
+ *               message or NULL if there is not next fuzzy or untranslated
+ *               message.
  **/
 GList *
 gtr_po_get_next_fuzzy_or_untrans (GtrPo * po)
@@ -885,8 +890,9 @@ gtr_po_get_next_fuzzy_or_untrans (GtrPo * po)
  * gtr_po_get_prev_fuzzy_or_untrans:
  * @po: a #GtrPo
  *
- * Return value: a pointer to the previously fuzzy or untranslated message
- * or NULL if there is not previously fuzzy or untranslated message.
+ * Return value: (transfer none): a pointer to the previously fuzzy or
+ *               untranslated message or NULL if there is not previously 
+ *               fuzzy or untranslated message.
  **/
 GList *
 gtr_po_get_prev_fuzzy_or_untrans (GtrPo * po)
@@ -909,6 +915,8 @@ gtr_po_get_prev_fuzzy_or_untrans (GtrPo * po)
  * @number: the message to jump
  *
  * Gets the message at the given position.
+ *
+ * Returns: (transfer none): the message at the given position.
  */
 GList *
 gtr_po_get_msg_from_number (GtrPo * po, gint number)
@@ -922,7 +930,7 @@ gtr_po_get_msg_from_number (GtrPo * po, gint number)
  * gtr_po_get_header:
  * @po: a #GtrPo
  *
- * Return value: The #GtrHeader of the @po.
+ * Return value: (transfer none): The #GtrHeader of the @po.
  **/
 GtrHeader *
 gtr_po_get_header (GtrPo * po)
diff --git a/src/gtr-po.h b/src/gtr-po.h
index e68c206..cfae9e9 100644
--- a/src/gtr-po.h
+++ b/src/gtr-po.h
@@ -99,7 +99,7 @@ gtr_po_get_type (void)
 
      GtrPo *gtr_po_new (void);
 
-     void gtr_po_parse (GtrPo * po, GFile * filename, GError ** error);
+     void gtr_po_parse (GtrPo * po, GFile * location, GError ** error);
 
      void gtr_po_save_header_in_msg (GtrPo * po, GtrHeader * header);
 
diff --git a/src/gtr-tab.c b/src/gtr-tab.c
index 5082840..8b77942 100644
--- a/src/gtr-tab.c
+++ b/src/gtr-tab.c
@@ -920,7 +920,7 @@ gtr_tab_new (GtrPo * po)
  * gtr_tab_get_po:
  * @tab: a #GtrTab
  *
- * Return value: the #GtrPo stored in the #GtrTab
+ * Return value: (transfer none): the #GtrPo stored in the #GtrTab
 **/
 GtrPo *
 gtr_tab_get_po (GtrTab * tab)
@@ -945,7 +945,7 @@ gtr_tab_get_active_trans_tab (GtrTab * tab)
  * gtr_tab_get_context_panel:
  * @tab: a #GtrTab
  *
- * Return value: the #GtranslaorContextPanel
+ * Return value: (transfer none): the #GtranslaorContextPanel
  */
 GtrContextPanel *
 gtr_tab_get_context_panel (GtrTab * tab)
@@ -957,7 +957,7 @@ gtr_tab_get_context_panel (GtrTab * tab)
  * gtr_tab_get_translation_memory_ui:
  * @tab: a #GtrTab
  *
- * Returns: the #GtrTranslationMemoryUi panel.
+ * Returns: (transfer none): the #GtrTranslationMemoryUi panel.
  */
 GtkWidget *
 gtr_tab_get_translation_memory_ui (GtrTab * tab)
@@ -971,7 +971,7 @@ gtr_tab_get_translation_memory_ui (GtrTab * tab)
  * gtr_tab_get_active_view:
  * @tab: a #GtranslationTab
  *
- * Return value: the active page of the translation notebook.
+ * Return value: (transfer none): the active page of the translation notebook.
 **/
 GtrView *
 gtr_tab_get_active_view (GtrTab * tab)
@@ -991,7 +991,7 @@ gtr_tab_get_active_view (GtrTab * tab)
  *
  * Returns all the views currently present in #GtranslationTab
  *
- * Return value: a newly allocated list of #GtranslationTab objects
+ * Return: (transfer container): a newly allocated list of #GtranslationTab objects
  */
 GList *
 gtr_tab_get_all_views (GtrTab * tab, gboolean original, gboolean translated)
@@ -1186,7 +1186,7 @@ _gtr_tab_can_close (GtrTab * tab)
  *
  * Returns the #GtrTab for a specific #GtrPo.
  *
- * Returns: the #GtrTab for a specific #GtrPo
+ * Returns: (transfer none): the #GtrTab for a specific #GtrPo
  */
 GtrTab *
 gtr_tab_get_from_document (GtrPo * po)
diff --git a/src/gtr-window.c b/src/gtr-window.c
index a3a2ef5..f9ce6a8 100644
--- a/src/gtr-window.c
+++ b/src/gtr-window.c
@@ -2082,7 +2082,7 @@ gtr_window_class_init (GtrWindowClass * klass)
  * Adds a new #GtrTab to the #GtrNotebook and returns the
  * #GtrTab.
  * 
- * Returns: a new #GtrTab object
+ * Returns: (transfer none): a new #GtrTab object
  */
 GtrTab *
 gtr_window_create_tab (GtrWindow * window, GtrPo * po)
@@ -2103,7 +2103,7 @@ gtr_window_create_tab (GtrWindow * window, GtrPo * po)
  * 
  * Gets the active #GtrTab of the @window.
  *
- * Returns: the active #GtrTab of the @window.
+ * Returns: (transfer none): the active #GtrTab of the @window.
  */
 GtrTab *
 gtr_window_get_active_tab (GtrWindow * window)
@@ -2117,7 +2117,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: 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.
  */
 GList *
 gtr_window_get_all_tabs (GtrWindow * window)
@@ -2148,7 +2149,7 @@ gtr_window_get_all_tabs (GtrWindow * window)
  * Gets the #GtrHeader of the #GtrPo of in the active
  * #GtrTab.
  *
- * Returns: the #GtrHeader of the #GtrPo of in the active
+ * Returns: (transfer none): the #GtrHeader of the #GtrPo of in the active
  * #GtrTab
  */
 GtrHeader *
@@ -2176,7 +2177,7 @@ gtr_window_get_header_from_active_tab (GtrWindow * window)
  * 
  * Gets the main #GtrNotebook of the @window.
  *
- * Returns: the #GtrNotebook of the @window
+ * Returns: (transfer none): the #GtrNotebook of the @window
  */
 GtrNotebook *
 gtr_window_get_notebook (GtrWindow * window)
@@ -2190,7 +2191,7 @@ gtr_window_get_notebook (GtrWindow * window)
  *
  * Gets the statusbar widget of the window.
  *
- * Returns: the statusbar widget of the window
+ * Returns: (transfer none): the statusbar widget of the window
  */
 GtkWidget *
 gtr_window_get_statusbar (GtrWindow * window)
@@ -2204,7 +2205,7 @@ gtr_window_get_statusbar (GtrWindow * window)
  *
  * Gets the #GtkUIManager of the window.
  *
- * Returns: the #GtkUIManager of the @window
+ * Returns: (transfer none): the #GtkUIManager of the @window
  */
 GtkUIManager *
 gtr_window_get_ui_manager (GtrWindow * window)
@@ -2219,8 +2220,8 @@ gtr_window_get_ui_manager (GtrWindow * window)
  * Gets the active translation view in the #GtranslationWindow or
  * NULL if there is not tab opened.
  *
- * Returns: the active translation view in the #GtranslationWindow or
- * NULL if there is not tab opened.
+ * Returns: (transfer none): the active translation view in the
+ *          #GtranslationWindow or %NULL if there is not tab opened.
  **/
 GtrView *
 gtr_window_get_active_view (GtrWindow * window)
@@ -2242,7 +2243,7 @@ gtr_window_get_active_view (GtrWindow * window)
  *
  * Returns all the views currently present in #GtranslationWindow
  *
- * Return value: a newly allocated list of #GtranslationWindow objects
+ * Return value: (transfer container): a newly allocated list of #GtranslationWindow objects
  **/
 GList *
 gtr_window_get_all_views (GtrWindow * window,
@@ -2327,14 +2328,14 @@ _gtr_window_get_layout_manager (GtrWindow * window)
 }
 
 /**
- * gtr_window_get_tab_from_uri:
+ * gtr_window_get_tab_from_location:
  * @window: a #GtrWindow
  * @location: the GFile of the po file of the #GtrTab
  *
  * Gets the #GtrTab of the #GtrWindows that matches with the
  * @location.
  *
- * Returns: the #GtrTab which @location matches with its po file.
+ * Returns: (transfer none): the #GtrTab which @location matches with its po file.
  */
 GtkWidget *
 gtr_window_get_tab_from_location (GtrWindow * window, GFile * location)
@@ -2414,6 +2415,12 @@ _gtr_window_close_tab (GtrWindow * window, GtrTab * tab)
   set_sensitive_according_to_window (window);
 }
 
+/**
+ * gtr_window_get_tm_menu:
+ * @window: a #GtrWindow
+ *
+ * Returns: (transfer none): get the tm_menu GtkWidget instance.
+ */
 GtkWidget *
 gtr_window_get_tm_menu (GtrWindow * window)
 {
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]