X-Git-Url: http://git.indexdata.com/?p=yaz-moved-to-github.git;a=blobdiff_plain;f=include%2Fyaz%2Fyaz-version.h.in;fp=include%2Fyaz%2Fyaz-version.h.in;h=f90ca9ab0a95a506162ff51e658bca8b86801b57;hp=e6a6bd01365f3958a4ae1c5cb4a691f5aa6e08bc;hb=3185557b9c4f422e12f79a930a89a35b4cac6cfe;hpb=e97610b3e0040428e2cb74f846ade31a0194074e

diff --git a/include/yaz/yaz-version.h.in b/include/yaz/yaz-version.h.in
index e6a6bd0..f90ca9a 100644
--- a/include/yaz/yaz-version.h.in
+++ b/include/yaz/yaz-version.h.in
@@ -52,6 +52,18 @@
 
 YAZ_BEGIN_CDECL
 
+/** \brief returns YAZ version
+    \param version_str holds version upon completion (YAZ_VERSION)
+    \param sha1_str holds SHA1 (Git) upon completion (YAZ_VERSION_SHA1)
+    \returns long version value (YAZ_VERSIONL)
+
+    The version_str may be NULL in which case version is not returned.
+    When not-null, version_str, should point to a buffer of at least 20
+    charcters in size (including "\0").
+    The sha1_str may be NULL in which case the SHA1 is not returnd.
+    When not-null, sha1_str whould point to a buffer of at least 41 characters
+    in size (including "\0"). 
+  */
 YAZ_EXPORT unsigned long yaz_version(char *version_str, char *sha1_str);
 
 YAZ_END_CDECL