[anjuta/sdb-core-trans: 76/80] libanjuta.idl: improved doc and symbol manager interfaces.

[Massimo Cora' <mcora src gnome org>]

commit 5270b067c0d92485248df7a64959c4c0f6580af8
Author: Massimo Corà <mcora src gnome org>
Date:   Sat Aug 14 17:06:46 2010 +0200

    libanjuta.idl: improved doc and symbol manager interfaces.

 libanjuta/interfaces/libanjuta.idl |   38 +++++++++++++++++++++++++++--------
 1 files changed, 29 insertions(+), 9 deletions(-)
---
diff --git a/libanjuta/interfaces/libanjuta.idl b/libanjuta/interfaces/libanjuta.idl
index 26732c1..901c008 100644
--- a/libanjuta/interfaces/libanjuta.idl
+++ b/libanjuta/interfaces/libanjuta.idl
@@ -6043,24 +6043,24 @@ interface IAnjutaSymbolManager
 	/**
 	 * ianjuta_symbol_manager_add_package:
 	 * @obj: Self
- 	 * @pkg-name: Name of the package to scan. Should be the name given by
-	 * pkg-config 
- 	 * @pkg_version: Version of the package
+ 	 * @pkg_name: Name of the package to scan. Should be the name given by
+	 * pkg-config. The colon char must be avoided.
+ 	 * @pkg_version: Version of the package. The colon char must be avoided.
  	 * or by the language implementation (Python, Javascript, etc.)
  	 * @files: A list of GFile's to scan for this package
  	 *
- 	 * Reads the package files into the database. 
+ 	 * Reads the package files into the database asynchronously.
 	 *
 	 * Returns: TRUE if the package will be loaded into the db, FALSE if the package
 	 * already exists
  	 */
-	gboolean add_package (const gchar* pkg_name, const gchar* pkg_version, const GList* files);
+	gboolean add_package (const gchar* pkg_name, const gchar* pkg_version, GList* files);
 
 	/**
 	 * ianjuta_symbol_manager_activate_package:
 	 * @obj: Self
- 	 * @pkg_name: Name of the package to activate
- 	 * @pkg_version: Version of the package
+ 	 * @pkg_name: Name of the package to activate. The colon char must be avoided.
+ 	 * @pkg_version: Version of the package. The colon char must be avoided.
  	 *
  	 * Activates the package for searches in the global symbol database.
  	 *
@@ -6073,12 +6073,32 @@ interface IAnjutaSymbolManager
 	/**
 	 * ianjuta_symbol_manager_deactivate_package:
 	 * @obj: Self
- 	 * @package: name of the package
+ 	 * @pkg_name: name of the package. The colon char must be avoided.
+	 * @pkg_version: Version of the package. The colon char must be avoided.
  	 * 
  	 * Deactivates the package if it was found. If package is NULL, deactivate all
- 	 * packages
+ 	 * packages.
+	 *
+	 * Returns FALSE if the package couldn't have been deactivated.
  	 */
 	gboolean deactivate_package (const gchar* pkg_name, const gchar* pkg_version);
+
+	/**
+	 * ianjuta_symbol_manager_add_and_activate_package:
+	 * @obj: Self
+ 	 * @pkg_name: Name of the package to scan and add. Should be the name given by
+	 * pkg-config. The colon char must be avoided.
+ 	 * @pkg_version: Version of the package. The colon char must be avoided.
+ 	 * or by the language implementation (Python, Javascript, etc.)
+ 	 * @files: A list of GFile's to scan for this package
+ 	 *
+ 	 * Convenience function that calls #ianjuta_symbol_manager_activate_package and
+	 * #ianjuta_symbol_manager_deactivate_package.
+	 *
+	 * Returns: TRUE if the package will be loaded into the db and activated, 
+	 * FALSE if the package already exists os is already activated.
+ 	 */	
+	gboolean add_and_activate_package (const gchar* pkg_name, const gchar* pkg_version, GList* files);
 	
 }