[anjuta] libanjuta: bgo #696984 - Update some annotations in documentation comments

From: Sebastien Granjoux <sgranjoux src gnome org>
To: commits-list gnome org
Cc:
Subject: [anjuta] libanjuta: bgo #696984 - Update some annotations in documentation comments
Date: Mon, 1 Apr 2013 08:25:41 +0000 (UTC)
commit 8ffb8f4f65a137da0a6ff6a3a614be6014985e96
Author: Arnel A. Borja <kyoushuu yahoo com>
Date:   Fri Mar 29 20:03:54 2013 +0800

    libanjuta: bgo #696984 - Update some annotations in documentation comments

 libanjuta/anjuta-command-bar.c        |    2 +-
 libanjuta/anjuta-command.c            |    4 ++--
 libanjuta/anjuta-dock.c               |   14 +++++++++-----
 libanjuta/anjuta-entry.c              |    6 +++---
 libanjuta/anjuta-language-provider.c  |    5 +++--
 libanjuta/anjuta-plugin-description.c |    6 +++---
 libanjuta/anjuta-plugin-manager.c     |    5 +++--
 libanjuta/anjuta-plugin.c             |    2 +-
 libanjuta/anjuta-profile-manager.c    |    3 ++-
 libanjuta/anjuta-profile.c            |    2 +-
 libanjuta/anjuta-session.c            |    6 +++---
 libanjuta/anjuta-shell.c              |   10 +++++-----
 libanjuta/anjuta-token-stream.c       |   15 ++++++++-------
 libanjuta/anjuta-ui.c                 |   20 +++++++++++---------
 libanjuta/anjuta-utils.c              |   19 ++++++++++---------
 libanjuta/interfaces/libanjuta.idl    |    2 +-
 16 files changed, 66 insertions(+), 55 deletions(-)
---
diff --git a/libanjuta/anjuta-command-bar.c b/libanjuta/anjuta-command-bar.c
index 348d628..f6ce7a3 100644
--- a/libanjuta/anjuta-command-bar.c
+++ b/libanjuta/anjuta-command-bar.c
@@ -92,7 +92,7 @@ anjuta_command_bar_new (void)
  * anjuta_command_bar_add_action_group:
  * @self: An AnjutaCommandBar
  * @group_name: A unique name for this group of entries
- * @entries: A list of entries to add
+ * @entries: (array length=num_entries): A list of entries to add
  * @num_entries: The number of items pointed to by entries
  * @user_data: User data to pass to the entry callback
  * 
diff --git a/libanjuta/anjuta-command.c b/libanjuta/anjuta-command.c
index 7c83c3f..cf63d24 100644
--- a/libanjuta/anjuta-command.c
+++ b/libanjuta/anjuta-command.c
@@ -347,8 +347,8 @@ anjuta_command_set_error_message (AnjutaCommand *self, const gchar *error_messag
  * normally used from a ::command-finished handler to report errors to the user
  * when a command finishes. 
  *
- * Return value: Error message string that must be freed when no longer needed.
- * If no error is set, return %NULL.
+ * Return value: (transfer full) (allow-none): Error message string that must
+ * be freed when no longer needed. If no error is set, return %NULL.
  */
 gchar *
 anjuta_command_get_error_message (AnjutaCommand *self)
diff --git a/libanjuta/anjuta-dock.c b/libanjuta/anjuta-dock.c
index b75433a..1659f19 100644
--- a/libanjuta/anjuta-dock.c
+++ b/libanjuta/anjuta-dock.c
@@ -144,7 +144,8 @@ anjuta_dock_new (void)
  * @stock_icon: Stock icon to display in this pane's grip
  * @placement: A #GdlDockPlacement value indicating where the pane should be
  *                        placed
- * @entries: #AnjutaCommandBar entries for this pane. Can be %NULL
+ * @entries: (allow-none) (array length=num_entries): #AnjutaCommandBar entries
+ *                      for this pane. Can be %NULL
  * @num_entries: The number of entries pointed to by entries, or 0.
  * @user_data: User data to pass to the entry callback
  *
@@ -184,7 +185,8 @@ anjuta_dock_add_pane (AnjutaDock *self, const gchar *pane_name,
  *               the pane object.
  * @placement: A #GdlDockPlacement value indicating where the pane should be
  *                        placed
- * @entries: #AnjutaCommandBar entries for this pane. Can be %NULL
+ * @entries: (allow-none) (array length=num_entries): #AnjutaCommandBar entries
+ *                      for this pane. Can be %NULL
  * @num_entries: The number of entries pointed to by entries, or 0.
  * @user_data: User data to pass to the entry callback
  * @behavior: Any combination of #GdlDockItemBehavior flags
@@ -258,7 +260,8 @@ anjuta_dock_add_pane_full (AnjutaDock *self, const gchar *pane_name,
  * @stock_icon: Stock icon to display in this pane's grip
  * @placement: A #GdlDockPlacement value indicating where the pane should be
  *                        placed
- * @entries: #AnjutaCommandBar entries for this pane. Can be %NULL
+ * @entries: (allow-none) (array length=num_entries): #AnjutaCommandBar entries
+ *                      for this pane. Can be %NULL
  * @num_entries: The number of entries pointed to by entries, or 0.
  * @user_data: User data to pass to the entry callback
  *
@@ -407,10 +410,11 @@ anjuta_dock_set_command_bar (AnjutaDock *self, AnjutaCommandBar *command_bar)
  * anjuta_dock_get_command_bar:
  * @self: An AnjutaDock
  *
- * Returns: the #AnjutaCommandBar associated with this dock or %NULL.
+ * Returns: (transfer none) (allow-none): the #AnjutaCommandBar associated with
+ * this dock or %NULL.
  */
 AnjutaCommandBar *
 anjuta_dock_get_command_bar (AnjutaDock *self)
 {
        return ANJUTA_COMMAND_BAR (self->priv->command_bar);
-}
\ No newline at end of file
+}
diff --git a/libanjuta/anjuta-entry.c b/libanjuta/anjuta-entry.c
index 39a3795..431587b 100644
--- a/libanjuta/anjuta-entry.c
+++ b/libanjuta/anjuta-entry.c
@@ -269,9 +269,9 @@ anjuta_entry_get_text (AnjutaEntry *self)
  * anjuta_entry_dup_text:
  * @self: An AnjutaEntry
  *
- * Returns: A copy of the contents of the entry. If the entry is empty, the
- * returned string will be empty. The returned string must be freed when no
- * longer needed. 
+ * Returns: (transfer full): A copy of the contents of the entry. If the entry
+ * is empty, the returned string will be empty. The returned string must be
+ * freed when no longer needed.
  */
 gchar *
 anjuta_entry_dup_text (AnjutaEntry *self)
diff --git a/libanjuta/anjuta-language-provider.c b/libanjuta/anjuta-language-provider.c
index d759953..b7791e1 100644
--- a/libanjuta/anjuta-language-provider.c
+++ b/libanjuta/anjuta-language-provider.c
@@ -295,7 +295,8 @@ anjuta_language_provider_get_calltip_context (AnjutaLanguageProvider* lang_prov,
  *
  * Search for the current typed word
  *
- * Returns: The current word (needs to be freed) or NULL if no word was found
+ * Returns: (transfer full) (allow-none): The current word (needs to be freed)
+ * or %NULL if no word was found
  */
 gchar*
 anjuta_language_provider_get_pre_word (AnjutaLanguageProvider* lang_prov,
@@ -628,7 +629,7 @@ anjuta_language_proposal_data_free (AnjutaLanguageProposalData *data)
  * anjuta_language_proposal_data_new:
  * @name: Name of the object
  * 
- * Returns: Creates a new AnjutaLanguageProposalData object
+ * Returns: (transfer full): Creates a new AnjutaLanguageProposalData object
  */
 AnjutaLanguageProposalData*
 anjuta_language_proposal_data_new (gchar* name)
diff --git a/libanjuta/anjuta-plugin-description.c b/libanjuta/anjuta-plugin-description.c
index 14e48d2..50370ef 100644
--- a/libanjuta/anjuta-plugin-description.c
+++ b/libanjuta/anjuta-plugin-description.c
@@ -631,8 +631,8 @@ anjuta_plugin_description_new_from_string (char *data, GError **error)
  * Converts the description detains into string format, usually for
  * saving it in a file.
  *
- * Return value: The string representation of the description. The
- * returned values must be freed after use.
+ * Return value: (transfer full) (allow-none): The string representation of the description.
+ * The returned values must be freed after use.
  */
 char *
 anjuta_plugin_description_to_string (AnjutaPluginDescription *df)
@@ -743,7 +743,7 @@ lookup_line (AnjutaPluginDescription        *df,
  * @section_name: Name of the section.
  * @keyname: Name of the key.
  * @locale: The locale for which the value is to be retrieved.
- * @val: Pointer to the variable to store the string value.
+ * @val: (out) (transfer full) (allow-none): Pointer to the variable to store the string value.
  *
  * Retrieves the value of a key (in the given section) for the given locale.
  * The value returned in @val must be freed after use.
diff --git a/libanjuta/anjuta-plugin-manager.c b/libanjuta/anjuta-plugin-manager.c
index 41ed3ec..de72cdb 100644
--- a/libanjuta/anjuta-plugin-manager.c
+++ b/libanjuta/anjuta-plugin-manager.c
@@ -2224,7 +2224,7 @@ anjuta_plugin_manager_select_and_activate (AnjutaPluginManager *plugin_manager,
  * Get the description corresponding to the plugin or %NULL if the plugin is not
  * activated.
  *
- * Returns: A #AnjutaPluginDescription or %NULL.
+ * Returns: (transfer none) (allow-none): A #AnjutaPluginDescription or %NULL.
  */
 AnjutaPluginDescription*
 anjuta_plugin_manager_get_plugin_description (AnjutaPluginManager *plugin_manager,
@@ -2649,7 +2649,8 @@ on_collect (gpointer key, gpointer value, gpointer user_data)
  * The list format is returned as a string with the format detailed in 
  * anjuta_plugin_manager_set_remembered_plugins().
  *
- * Return value: a newly-allocated string that must be freed with g_free().
+ * Return value: (transfer full): a newly-allocated string that must be freed
+ * with g_free().
  */
 
 gchar*
diff --git a/libanjuta/anjuta-plugin.c b/libanjuta/anjuta-plugin.c
index 27827db..c0ea66c 100644
--- a/libanjuta/anjuta-plugin.c
+++ b/libanjuta/anjuta-plugin.c
@@ -583,7 +583,7 @@ anjuta_plugin_is_active (AnjutaPlugin *plugin)
  * anjuta_plugin_get_shell:
  * @plugin: a #AnjutaPlugin
  * 
- * Returns: The #AnjutaShell object associated with this plugin
+ * Returns: (transfer none): The #AnjutaShell object associated with this plugin
  */
 AnjutaShell *
 anjuta_plugin_get_shell (AnjutaPlugin* plugin)
diff --git a/libanjuta/anjuta-profile-manager.c b/libanjuta/anjuta-profile-manager.c
index b87f6b9..4b21e55 100644
--- a/libanjuta/anjuta-profile-manager.c
+++ b/libanjuta/anjuta-profile-manager.c
@@ -649,7 +649,8 @@ anjuta_profile_manager_thaw (AnjutaProfileManager *profile_manager,
  * 
  * Return the current profile.
  *
- * Return value: a #AnjutaProfile object or NULL if the profile stack is empty.
+ * Return value: (transfer none) (allow-none): a #AnjutaProfile object or %NULL
+ * if the profile stack is empty.
  */
 AnjutaProfile*
 anjuta_profile_manager_get_current (AnjutaProfileManager *profile_manager)
diff --git a/libanjuta/anjuta-profile.c b/libanjuta/anjuta-profile.c
index d0092d0..4e60eb2 100644
--- a/libanjuta/anjuta-profile.c
+++ b/libanjuta/anjuta-profile.c
@@ -788,7 +788,7 @@ anjuta_profile_add_plugins_from_xml (AnjutaProfile *profile,
  * 
  * Return a string in xml format containing the list of saved plugins.
  *
- * Return value: a newly-allocated string that must be freed with g_free().
+ * Return value: (transfer full): a newly-allocated string that must be freed with g_free().
  */
 static gchar*
 anjuta_profile_to_xml (AnjutaProfile *profile)
diff --git a/libanjuta/anjuta-session.c b/libanjuta/anjuta-session.c
index a71036c..8b0d616 100644
--- a/libanjuta/anjuta-session.c
+++ b/libanjuta/anjuta-session.c
@@ -468,7 +468,7 @@ anjuta_session_get_string_list (AnjutaSession *session,
  * It is useful to keep only relative file paths in a session file to be able
  * to copy the whole project without breaking references.
  *
- * Returns: A string that has to be freed with g_free().
+ * Returns: (transfer full): A string that has to be freed with g_free().
  */
 gchar *
 anjuta_session_get_relative_uri_from_file (AnjutaSession *session,
@@ -535,7 +535,7 @@ anjuta_session_get_relative_uri_from_file (AnjutaSession *session,
  * anjuta_session_get_file_from_relative_uri:
  * @session: an #AnjutaSession object
  * @uri: a relative URI from a key
- * @fragment: fragment part of the URI if existing, cal be NULL
+ * @fragment: (allow-none): fragment part of the URI if existing, can be %NULL
  *
  * Return a GFile corresponding to the URI and and optional fragment,
  * normally read from a session key.
@@ -545,7 +545,7 @@ anjuta_session_get_relative_uri_from_file (AnjutaSession *session,
  * It is useful to keep only relative file paths in a session file to be able
  * to copy the whole project without breaking references.
  *
- * Returns: A new GFile that has to be freed with g_object_unref().
+ * Returns: (transfer full): A new GFile that has to be freed with g_object_unref().
  */
 GFile*
 anjuta_session_get_file_from_relative_uri (AnjutaSession *session,
diff --git a/libanjuta/anjuta-shell.c b/libanjuta/anjuta-shell.c
index ed75418..e9086c9 100644
--- a/libanjuta/anjuta-shell.c
+++ b/libanjuta/anjuta-shell.c
@@ -790,7 +790,7 @@ anjuta_shell_get_object (AnjutaShell *shell, const gchar *iface_name,
  *
  * Retrieves the #AnjutaStatus object associated with the shell.
  *
- * Return value: The #AnjutaStatus object.
+ * Return value: (transfer none): The #AnjutaStatus object.
  */
 AnjutaStatus*
 anjuta_shell_get_status (AnjutaShell *shell, GError **error)
@@ -808,7 +808,7 @@ anjuta_shell_get_status (AnjutaShell *shell, GError **error)
  *
  * Retrieves the #AnjutaUI object associated with the shell.
  *
- * Return value: The #AnjutaUI object.
+ * Return value: (transfer none): The #AnjutaUI object.
  */
 AnjutaUI*
 anjuta_shell_get_ui (AnjutaShell *shell, GError **error)
@@ -826,7 +826,7 @@ anjuta_shell_get_ui (AnjutaShell *shell, GError **error)
  *
  * Retrieves the #AnjutaPreferences object associated with the shell.
  *
- * Return value: The #AnjutaPreferences object.
+ * Return value: (transfer none): The #AnjutaPreferences object.
  */
 AnjutaPreferences*
 anjuta_shell_get_preferences (AnjutaShell *shell, GError **error)
@@ -844,7 +844,7 @@ anjuta_shell_get_preferences (AnjutaShell *shell, GError **error)
  *
  * Retrieves the #AnjutaPluginManager object associated with the shell.
  *
- * Return value: The #AnjutaPluginManager object.
+ * Return value: (transfer none): The #AnjutaPluginManager object.
  */
 AnjutaPluginManager*
 anjuta_shell_get_plugin_manager (AnjutaShell *shell, GError **error)
@@ -862,7 +862,7 @@ anjuta_shell_get_plugin_manager (AnjutaShell *shell, GError **error)
  *
  * Retrieves the #AnjutaProfileManager object associated with the shell.
  *
- * Return value: The #AnjutaProfileManager object.
+ * Return value: (transfer none): The #AnjutaProfileManager object.
  */
 AnjutaProfileManager*
 anjuta_shell_get_profile_manager (AnjutaShell *shell, GError **error)
diff --git a/libanjuta/anjuta-token-stream.c b/libanjuta/anjuta-token-stream.c
index 8131ccc..1c44116 100644
--- a/libanjuta/anjuta-token-stream.c
+++ b/libanjuta/anjuta-token-stream.c
@@ -259,7 +259,7 @@ anjuta_token_stream_read (AnjutaTokenStream *stream, gchar *buffer, gsize max_si
  *
  * Return the root token for the output stream.
  *
- * Return value: The output root token.
+ * Return value: (transfer none): The output root token.
  */
 AnjutaToken*
 anjuta_token_stream_get_root (AnjutaTokenStream *stream)
@@ -275,7 +275,7 @@ anjuta_token_stream_get_root (AnjutaTokenStream *stream)
  *
  * Return the current directory.
  *
- * Return value: The current directory.
+ * Return value: (transfer none): The current directory.
  */
 GFile*
 anjuta_token_stream_get_current_directory (AnjutaTokenStream *stream)
@@ -292,7 +292,7 @@ anjuta_token_stream_get_current_directory (AnjutaTokenStream *stream)
  *
  * Return the current file.
  *
- * Return value: The current file.
+ * Return value: (transfer none): The current file.
  */
 GFile*
 anjuta_token_stream_get_current_file (AnjutaTokenStream *stream)
@@ -307,8 +307,8 @@ anjuta_token_stream_get_current_file (AnjutaTokenStream *stream)
 
 /**
  * anjuta_token_stream_push:
- * @parent: a parent #AnjutaTokenStream object or NULL.
- * @root: a token or NULL
+ * @parent: (allow-none): a parent #AnjutaTokenStream object or %NULL.
+ * @root: (allow-none): a token or %NULL
  * @content: a token list.
  * @file: (allow-none): a #GFile of the file.
  *
@@ -362,7 +362,7 @@ anjuta_token_stream_push (AnjutaTokenStream *parent, AnjutaToken *root, AnjutaTo
  *
  * Destroy the stream object and return the parent stream if it exists.
  *
- * Return value: The parent stream or NULL if there is no parent.
+ * Return value: (transfer none) (allow-none): The parent stream or %NULL if there is no parent.
  */
 AnjutaTokenStream *
 anjuta_token_stream_pop (AnjutaTokenStream *stream)
@@ -385,7 +385,8 @@ anjuta_token_stream_pop (AnjutaTokenStream *stream)
  *
  * Return the parent stream
  *
- * Return value: The parent stream or NULL if there is no parent.
+ * Return value: (transfer none) (allow-none): The parent stream or %NULL if
+ * there is no parent.
  */
 AnjutaTokenStream *
 anjuta_token_stream_get_parent (AnjutaTokenStream *stream)
diff --git a/libanjuta/anjuta-ui.c b/libanjuta/anjuta-ui.c
index 04a67c7..8fa41b6 100644
--- a/libanjuta/anjuta-ui.c
+++ b/libanjuta/anjuta-ui.c
@@ -1009,7 +1009,7 @@ anjuta_ui_new (void)
  * @ui: A #AnjutaUI object.
  * @action_group_name: Untranslated name of the action group.
  * @action_group_label: Translated label of the action group.
- * @entries: An array of action entries.
+ * @entries: (array length=num_entries): An array of action entries.
  * @num_entries: Number of elements in the action entries array.
  * @can_customize: If true the actions are customizable by user.
  * @translation_domain: The translation domain used to translated the entries.
@@ -1028,7 +1028,8 @@ anjuta_ui_new (void)
  * @action_group_label is used as the display name for the action group in
  * UI manager dialog where action shortcuts are configured.
  * 
- * Return value: A #GtkActionGroup object holding all the action objects.
+ * Return value: (transfer none): A #GtkActionGroup object holding all the
+ * action objects.
  */
 GtkActionGroup*
 anjuta_ui_add_action_group_entries (AnjutaUI *ui,
@@ -1062,7 +1063,7 @@ anjuta_ui_add_action_group_entries (AnjutaUI *ui,
  * @ui: A #AnjutaUI object.
  * @action_group_name: Untranslated name of the action group.
  * @action_group_label: Translated label of the action group.
- * @entries: An array of action entries.
+ * @entries: (array length=num_entries): An array of action entries.
  * @num_entries: Number of elements in the action entries array.
  * @translation_domain: The translation domain used to translated the entries.
  * It is usually the GETTEXT_PACKAGE macro in a project.
@@ -1072,7 +1073,8 @@ anjuta_ui_add_action_group_entries (AnjutaUI *ui,
  * This is similar to anjuta_ui_add_action_group_entries(), except that
  * it adds #GtkToggleAction objects after creating them from the @entries.
  * 
- * Return value: A #GtkActionGroup object holding all the action objects.
+ * Return value: (transfer none): A #GtkActionGroup object holding all the
+ * action objects.
  */
 GtkActionGroup*
 anjuta_ui_add_toggle_action_group_entries (AnjutaUI *ui,
@@ -1105,7 +1107,7 @@ anjuta_ui_add_toggle_action_group_entries (AnjutaUI *ui,
  * @ui: A #AnjutaUI object.
  * @action_group_name: Untranslated name of the action group.
  * @action_group_label: Translated label of the action group.
- * @action_group: #GtkActionGroup object to add.
+ * @action_group: (transfer full): #GtkActionGroup object to add.
  * 
  * This is similar to anjuta_ui_add_action_group_entries(), except that
  * it adds #GtkActionGroup object @action_group directly. All actions in this
@@ -1212,7 +1214,7 @@ anjuta_ui_remove_action_group (AnjutaUI *ui, GtkActionGroup *action_group)
  * Note that it will be only sucessully returned if the group has been added
  * using methods in #AnjutaUI.
  *
- * Returns: A #GtkAction object
+ * Returns: (transfer none): A #GtkAction object
  */
 GtkAction*
 anjuta_ui_get_action (AnjutaUI *ui, const gchar *action_group_name,
@@ -1355,7 +1357,7 @@ anjuta_ui_unmerge (AnjutaUI *ui, gint id)
  *
  * Returns the #GtkAccelGroup object associated with this UI manager.
  *
- * Returns: A #GtkAccelGroup object.
+ * Returns: (transfer none): A #GtkAccelGroup object.
  */
 GtkAccelGroup*
 anjuta_ui_get_accel_group (AnjutaUI *ui)
@@ -1371,7 +1373,7 @@ anjuta_ui_get_accel_group (AnjutaUI *ui)
  * Creates an accel editor widget and returns it. It should be added to
  * container and displayed to users.
  *
- * Returns: a #GtkWidget containing the editor.
+ * Returns: (transfer none): a #GtkWidget containing the editor.
  */
 GtkWidget *
 anjuta_ui_get_accel_editor (AnjutaUI *ui)
@@ -1471,7 +1473,7 @@ anjuta_ui_get_accel_editor (AnjutaUI *ui)
  * this icon factory. Read the documentation for #GtkIconFactory on how to 
  * use it.
  *
- * Return value: The #GtkIconFactory object used by it
+ * Return value: (transfer none): The #GtkIconFactory object used by it
  */
 GtkIconFactory*
 anjuta_ui_get_icon_factory (AnjutaUI *ui)
diff --git a/libanjuta/anjuta-utils.c b/libanjuta/anjuta-utils.c
index 694fce4..cd36b65 100644
--- a/libanjuta/anjuta-utils.c
+++ b/libanjuta/anjuta-utils.c
@@ -843,7 +843,7 @@ has_valid_scheme (const char *uri)
  * Create a new file corresponding to arg, unlike g_file_new_for_commandline_arg,
  * keeps symbolic links in path name.
  *
- * Returns: A new GFile object
+ * Returns: (transfer full): A new GFile object
  */
 GFile *
 anjuta_util_file_new_for_commandline_arg (const gchar *arg)
@@ -1123,9 +1123,9 @@ anjuta_util_user_shell (void)
  *
  * Retrieves the user's preferred terminal.
  *
- * Returns: A newly allocated strings list. The first argument is the terminal
- * program name. The following are the arguments needed to execute
- * a command. The list has to be freed with g_strfreev
+ * Returns: (transfer full): A newly allocated strings list. The first argument
+ * is the terminal program name. The following are the arguments needed to
+ * execute a command. The list has to be freed with g_strfreev
  */
 /* copied from deprecated gnome_execute_terminal in libgnome */
 gchar **
@@ -1558,8 +1558,8 @@ anjuta_util_is_template_file (const gchar *filename)
  *
  * Return the mime type corresponding to a file infor object.
  *
- * Returns: The mime type as a newly allocated string that must be freed with
- * g_free() or %NULL if the mime type cannot be found.
+ * Returns: (transfer full) (allow-none): The mime type as a newly allocated
+ * string that must be freed with g_free() or %NULL if the mime type cannot be found.
  */
 gchar *
 anjuta_util_get_file_info_mime_type (GFileInfo *info)
@@ -1610,8 +1610,9 @@ anjuta_util_get_file_info_mime_type (GFileInfo *info)
  *
  * Check if a file exists and return its mime type.
  *
- * Returns: NULL if the corresponding file doesn't exist or the mime type as a newly
- * allocated string that must be freed with g_free().
+ * Returns: (transfer full) (allow-none): %NULL if the corresponding file doesn't
+ * exist or the mime type as a newly allocated string that must be freed with
+ * g_free().
  */
 gchar *
 anjuta_util_get_file_mime_type (GFile *file)
@@ -2048,7 +2049,7 @@ anjuta_util_replace_home_dir_with_tilde (const gchar *uri)
  *
  * Expand environment variables $(var_name) and tilde (~) in the input string.
  *
- * Returns: a newly-allocated string that must be freed with g_free().
+ * Returns: (transfer full): a newly-allocated string that must be freed with g_free().
  */
 gchar*
 anjuta_util_shell_expand (const gchar *string)
diff --git a/libanjuta/interfaces/libanjuta.idl b/libanjuta/interfaces/libanjuta.idl
index 65a4874..b2fcda2 100644
--- a/libanjuta/interfaces/libanjuta.idl
+++ b/libanjuta/interfaces/libanjuta.idl
@@ -3325,7 +3325,7 @@ interface IAnjutaTerminal
        * @obj: Self
        * @directory: Working directory
        * @command: Command executed followed by arguments
-       * @environment: List of additional environment variables
+       * @environment: (array zero-terminated=1): List of additional environment variables
        * @err: Error propagation and reporting.
        *
        * Run the command in a terminal, setting the working directory
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]