summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorVíctor Manuel Jáquez Leal <vjaquez@igalia.com>2010-09-29 21:54:43 +0200
committerVíctor Manuel Jáquez Leal <vjaquez@igalia.com>2010-09-30 15:42:57 +0200
commit45cdfe2617998d5dc73e27c6f2aa9346f786a4e0 (patch)
treec1a262a414e14b622cbae1779245b920b53968a2
parent868c291b0dec31d4ea3a4657844cbf98c10941b0 (diff)
downloadgrilo-45cdfe2617998d5dc73e27c6f2aa9346f786a4e0.tar.gz
doc: add more documentation to grilo.c
Signed-off-by: Víctor Manuel Jáquez Leal <vjaquez@igalia.com>
-rw-r--r--src/grilo.c18
1 files changed, 16 insertions, 2 deletions
diff --git a/src/grilo.c b/src/grilo.c
index a2f4da0..7bba467 100644
--- a/src/grilo.c
+++ b/src/grilo.c
@@ -20,6 +20,19 @@
*
*/
+/**
+ * SECTION:grl
+ * @short_description: Metadata library supporting several services
+ *
+ * Grilo is a metadata retrieval library. Given a search or browse operation,
+ * the library will retrieve a set of metadata related to the operation from a
+ * set of on-line services.
+ *
+ * The Grilo library should be initialized with grl_init() before it can be used.
+ * You should pass pointers to the main argc and argv variables so that Grilo can
+ * process its own command line options.
+ */
+
#include "grilo.h"
#include "grl-metadata-key-priv.h"
#include "grl-log-priv.h"
@@ -101,10 +114,11 @@ grl_init (gint *argc,
/**
* grl_init_get_option_group: (skip)
*
- * Returns a GOptionGroup with Grilo's argument specifications.
+ * Returns a #GOptionGroup with Grilo's argument specifications.
*
* This function is useful if you want to integrate Grilo with other
- * libraries that use #GOption (see g_option_context_add_group() ).
+ * libraries that use the GOption commandline parser
+ * (see g_option_context_add_group() ).
*
* Returns: a pointer to Grilo's option group. Should be dereferenced
* after use.