[anjuta] libanjuta: fix gir annotations for IAnjutaProjectManager



commit 4894407efa89154e3f5e95a21864becf0a270620
Author: Abderrahim Kitouni <akitouni src gnome org>
Date:   Thu Jan 6 20:26:40 2011 +0100

    libanjuta: fix gir annotations for IAnjutaProjectManager

 libanjuta/interfaces/libanjuta.idl               |  158 +++++++++++-----------
 plugins/language-support-vala/libanjuta-3.0.vapi |   10 +-
 2 files changed, 87 insertions(+), 81 deletions(-)
---
diff --git a/libanjuta/interfaces/libanjuta.idl b/libanjuta/interfaces/libanjuta.idl
index 98f0860..0fef307 100644
--- a/libanjuta/interfaces/libanjuta.idl
+++ b/libanjuta/interfaces/libanjuta.idl
@@ -3484,15 +3484,15 @@ interface IAnjutaProjectManager
 	List<GFile*> get_children (GFile *element);
 	
 	/**
-	* ianjuta_project_manager_get_selected:
-	* @obj: Self
-	* @err: Error propagation and reporting.
-	* 
-	* Gets the currently selected element in the project manager view.
-	*
-	* Returns: A #GFile corresponding to the selected element in the project
-	* view. You own the returned file; use g_object_unref() to release it.
-	*/
+	 * ianjuta_project_manager_get_selected:
+	 * @obj: Self
+	 * @err: Error propagation and reporting.
+	 * 
+	 * Gets the currently selected element in the project manager view.
+	 *
+	 * Returns: (transfer full): A #GFile corresponding to the selected element in the project
+	 * view. You own the returned file; use g_object_unref() to release it.
+	 */
 	GFile* get_selected ();
 	
 	/**
@@ -3508,50 +3508,50 @@ interface IAnjutaProjectManager
 	guint get_capabilities ();
 
 	/**
-	* ianjuta_project_manager_add_source:
-	* @obj: Self.
-	* @name: Source name or URI.
-	* @default_target: A #GFile corresponding to the default target or group or
-	*					%NULL if you don't care.
-	* @err: Error propagation and reporting.
-	*
-	* Prompts the user to add a file to the project. If the user selects
-	* multiple files only the first source file is returned.
-	*
-	* You can add non existing file. In this case the element_added
-	* signal will be emitted with a non existing file. So it is
-	* up to the caller to reemit this signal later when the file
-	* is created.
-	*
-	* Returns: A #GFile corresponding to the new source file in the project
-	* view. You own the returned file; use g_object_unref() to release it.
-	*/
+	 * ianjuta_project_manager_add_source:
+	 * @obj: Self.
+	 * @name: Source name or URI.
+	 * @default_target: (allow-none): A #GFile corresponding to the default target or group or
+	 *					%NULL if you don't care.
+	 * @err: Error propagation and reporting.
+	 *
+	 * Prompts the user to add a file to the project. If the user selects
+	 * multiple files only the first source file is returned.
+	 *
+	 * You can add non existing file. In this case the element_added
+	 * signal will be emitted with a non existing file. So it is
+	 * up to the caller to reemit this signal later when the file
+	 * is created.
+	 *
+	 * Returns: (transfer full): A #GFile corresponding to the new source file in the
+	 * project view. You own the returned file; use g_object_unref() to release it.
+	 */
 	GFile* add_source (const gchar *name, GFile *default_target);
 
 	/**
-	* ianjuta_project_manager_add_source_quiet:
-	* @obj: Self.
-	* @name: Source name or URI.
-	* @target: A #GFile corresponding to the parent target or group.
-	* @err: Error propagation and reporting.
-	*
-	* Adds a file to the project without prompting the user.
-	*
-	* You can add non existing file. In this case the element_added
-	* signal will be emitted with a non existing file. So it is
-	* up to the caller to reemit this signal later when the file
-	* is created.
-	*
-	* Returns: A #GFile corresponding to the new source file in the project
-	* view. You own the returned file; use g_object_unref() to release it.
-	*/
+	 * ianjuta_project_manager_add_source_quiet:
+	 * @obj: Self.
+	 * @name: Source name or URI.
+	 * @target: A #GFile corresponding to the parent target or group.
+	 * @err: Error propagation and reporting.
+	 *
+	 * Adds a file to the project without prompting the user.
+	 *
+	 * You can add non existing file. In this case the element_added
+	 * signal will be emitted with a non existing file. So it is
+	 * up to the caller to reemit this signal later when the file
+	 * is created.
+	 *
+	 * Returns: (transfer full): A #GFile corresponding to the new source file in the project
+	 * view. You own the returned file; use g_object_unref() to release it.
+	 */
 	GFile* add_source_quiet (const gchar *name, GFile *target);
 	
 	/**
 	 * ianjuta_project_manager_add_sources:
 	 * @obj: Self.
 	 * @names: (element-type utf8): Sources name or URI to add.
-	 * @default_target: A #GFile corresponding to the default target or group or
+	 * @default_target: (allow-none): A #GFile corresponding to the default target or group or
 	 *					%NULL if don't care.
 	 * @err: Error propagation and reporting.
 	 *
@@ -3571,35 +3571,35 @@ interface IAnjutaProjectManager
 	List<GFile*> add_sources (List<const gchar*> names, GFile *default_target);
 	
 	/**
-	* ianjuta_project_manager_add_target:
-	* @obj: Self
-	* @name: Target name or URI.
-	* @default_group: A #GFile corresponding to the default parent group or
-	*					%NULL if don't care.
-	* @err: Error propagation and reporting.
-	* 
-	* Prompts the user to add a new target to the project. The user can select
-	* a parent group different from the one set as default.
-	* 
-	* Returns: A #GFile corresponding to the new target added in the project.
-	* You own the returned file; use g_object_unref() to release it.
-	*/
+	 * ianjuta_project_manager_add_target:
+	 * @obj: Self
+	 * @name: Target name or URI.
+	 * @default_group: (allow-none): A #GFile corresponding to the default parent group or
+	 *					%NULL if don't care.
+	 * @err: Error propagation and reporting.
+	 * 
+	 * Prompts the user to add a new target to the project. The user can select
+	 * a parent group different from the one set as default.
+	 * 
+	 * Returns: (transfer full): A #GFile corresponding to the new target added in the project.
+	 * You own the returned file; use g_object_unref() to release it.
+	 */
 	GFile* add_target (const gchar *name, GFile *default_group);
 	
 	/**
-	* ianjuta_project_manager_add_group:
-	* @obj: Self.
-	* @name: Group name or URI.
-	* @default_group: A #GFile corresponding to the default parent group or
-	*					%NULL if don't care.
-	* @err: Error propagation and reporting.
-	* 
-	* Prompts the user to add a new group to the project. The user can select
-	* a parent group different from the one set as default.
-	* 
-	* Returns: A #GFile corresponding to the new group added in the project.
-	* You own the returned file; use g_object_unref() to release it.
-	*/
+	 * ianjuta_project_manager_add_group:
+	 * @obj: Self.
+	 * @name: Group name or URI.
+	 * @default_group: (allow-none): A #GFile corresponding to the default parent group or
+	 *					%NULL if don't care.
+	 * @err: Error propagation and reporting.
+	 * 
+	 * Prompts the user to add a new group to the project. The user can select
+	 * a parent group different from the one set as default.
+	 * 
+	 * Returns: (transfer full): A #GFile corresponding to the new group added in the project.
+	 * You own the returned file; use g_object_unref() to release it.
+	 */
 	GFile* add_group (const gchar *name, GFile *default_group);
 	
 	/**
@@ -3618,21 +3618,21 @@ interface IAnjutaProjectManager
 	 * @obj: Self
 	 * @err: Error propagation and reporting.
 	 *
-	 * Returns: (element-type utf8) (transfer full): the list of pkg-config packages that the current project
+	 * Returns: (element-type utf8) (transfer container): the list of pkg-config packages that the current project
 	 * requires in it's configure.ac. Can be NULL if there is no project
 	 * opened currently or no package is required.
 	 */
 	List<gchar*> get_packages();
 	
 	/**
-	* ianjuta_project_manager_get_current_project:
-	* @obj: Self
-	* @err: Error propagation and reporting.
-	* 
-	* Gets the current project.
-	* 
-	* Return value: the currently active project. NULL if none is there.
-	*/
+	 * ianjuta_project_manager_get_current_project:
+	 * @obj: Self
+	 * @err: Error propagation and reporting.
+	 * 
+	 * Gets the current project.
+	 * 
+	 * Return value: (transfer none): the currently active project. NULL if none is there.
+	 */
 	IAnjutaProject* get_current_project ();
 }
 
diff --git a/plugins/language-support-vala/libanjuta-3.0.vapi b/plugins/language-support-vala/libanjuta-3.0.vapi
index 60a3d53..6eacc65 100644
--- a/plugins/language-support-vala/libanjuta-3.0.vapi
+++ b/plugins/language-support-vala/libanjuta-3.0.vapi
@@ -1438,12 +1438,18 @@ namespace IAnjuta {
 	}
 	[CCode (cheader_filename = "libanjuta/interfaces/libanjuta-interfaces.h")]
 	public interface ProjectManager : GLib.Object {
-		public abstract GLib.List<GLib.File> add_sources (GLib.List<weak string> names, GLib.File default_target) throws GLib.Error;
+		public abstract GLib.File add_group (string name, GLib.File? default_group) throws GLib.Error;
+		public abstract GLib.File add_source (string name, GLib.File? default_target) throws GLib.Error;
+		public abstract GLib.File add_source_quiet (string name, GLib.File target) throws GLib.Error;
+		public abstract GLib.List<GLib.File> add_sources (GLib.List<weak string> names, GLib.File? default_target) throws GLib.Error;
+		public abstract GLib.File add_target (string name, GLib.File? default_group) throws GLib.Error;
 		public static GLib.Quark error_quark ();
 		public abstract uint get_capabilities () throws GLib.Error;
 		public abstract GLib.List<GLib.File> get_children (GLib.File element) throws GLib.Error;
+		public abstract unowned IAnjuta.Project get_current_project () throws GLib.Error;
 		public abstract GLib.List<GLib.File> get_elements (Anjuta.ProjectNodeType element_type) throws GLib.Error;
-		public abstract GLib.List<string> get_packages () throws GLib.Error;
+		public abstract GLib.List<weak string> get_packages () throws GLib.Error;
+		public abstract GLib.File get_selected () throws GLib.Error;
 		public abstract Anjuta.ProjectNodeType get_target_type (GLib.File target) throws GLib.Error;
 		public abstract GLib.List<GLib.File> get_targets (Anjuta.ProjectNodeType target_type) throws GLib.Error;
 		public abstract bool is_open () throws GLib.Error;



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]