eldbus: add documentation for Eldbus_Version structure.
authorNicolas Aguirre <aguirre.nicolas@gmail.com>
Fri, 10 Oct 2014 10:20:24 +0000 (12:20 +0200)
committerCedric BAIL <cedric@osg.samsung.com>
Mon, 20 Oct 2014 16:02:10 +0000 (18:02 +0200)
src/lib/eldbus/Eldbus.h

index 478fcea..220d4ec 100644 (file)
@@ -129,12 +129,16 @@ extern "C" {
 #define ELDBUS_ERROR_PENDING_CANCELED "org.enlightenment.DBus.Canceled"
 #define ELDBUS_ERROR_PENDING_TIMEOUT "org.freedesktop.DBus.Error.NoReply"
 
+/**
+ * @typedef Eldbus_Version
+ * Represents the current version of Eldbus
+ */
 typedef struct _Eldbus_Version
 {
-   int major;
-   int minor;
-   int micro;
-   int revision;
+   int major; /** < major (binary or source incompatible changes) */
+   int minor; /** < minor (new features, bugfixes, major improvements version) */
+   int micro; /** < micro (bugfix, internal improvements, no new features version) */
+   int revision; /** < git revision (0 if a proper release or the git revision number Eldbus is built from) */
 } Eldbus_Version;
 
 EAPI extern const Eldbus_Version * eldbus_version;