From: Tomas Mlcoch <tmlcoch@redhat.com>
Date: Mon, 25 Feb 2013 15:51:43 +0000 (+0100)
Subject: doc: Add example of usage load_metadata module.
X-Git-Tag: upstream/0.2.1~252
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=c56ea1449c97b226ac286bc996752686122048e5;p=services%2Fcreaterepo_c.git

doc: Add example of usage load_metadata module.
---

diff --git a/src/load_metadata.h b/src/load_metadata.h
index 7ab8398..f72a67e 100644
--- a/src/load_metadata.h
+++ b/src/load_metadata.h
@@ -28,6 +28,28 @@ extern "C" {
 #endif
 
 /** \defgroup   load_metadata   Load metadata API.
+ *
+ * Module for loading yum xml metadata.
+ *
+ * Example:
+ *
+ * \code
+ * int ret;
+ * cr_Metadata oldmetadata;
+ * GHashTable hashtable;
+ *
+ * // Create new metadata object
+ * oldmetadata = cr_metadata_new(CR_HT_KEY_FILENAME, 1, NULL);
+ * // Load metadata (path to directory which contains repodata/ subdir)
+ * ret = cr_metadata_locate_and_load_xml(oldmetadata, "/foo/bar/repo/")
+ * // Check return code
+ * if (ret != CR_LOAD_METADATA_OK) exit(1);
+ * // Get hash table with all loaded packages (key is package relative path)
+ * hashtable = cr_metadata_hashtable(oldmetadata);
+ * // What to do with hashtable?
+ * // See: http://developer.gnome.org/glib/2.30/glib-Hash-Tables.html
+ * \endcode
+ *
  *  \addtogroup load_metadata
  *  @{
  */