lavu: add an API function to return the Libav version string
authorwm4 <nfxjfg@googlemail.com>
Thu, 2 Jul 2015 17:04:59 +0000 (19:04 +0200)
committerJanne Grunau <janne-libav@jannau.net>
Thu, 2 Jul 2015 21:22:53 +0000 (23:22 +0200)
This returns something like "v12_dev0-1332-g333a27c". This is much more
useful than the individual library versions, of which there are too
many, and which are very hard to map back to releases or git commits.

Signed-off-by: Janne Grunau <janne-libav@jannau.net>
.gitignore
Makefile
cmdutils.c
doc/APIchanges
libavutil/avutil.h
libavutil/utils.c

index e225866..d3cde42 100644 (file)
@@ -26,7 +26,7 @@
 /avprobe
 /config.*
 /coverage.info
-/version.h
+/avversion.h
 /doc/*.1
 /doc/*.html
 /doc/*.pod
index cc016b3..5807acd 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -162,8 +162,8 @@ GIT_LOG     = $(SRC_PATH)/.git/logs/HEAD
 .version: $(wildcard $(GIT_LOG)) $(VERSION_SH) config.mak
 .version: M=@
 
-version.h .version:
-       $(M)$(VERSION_SH) $(SRC_PATH) version.h $(EXTRA_VERSION)
+avversion.h .version:
+       $(M)$(VERSION_SH) $(SRC_PATH) avversion.h $(EXTRA_VERSION)
        $(Q)touch .version
 
 # force version.sh to run whenever version might have changed
@@ -204,7 +204,7 @@ clean::
 
 distclean::
        $(RM) $(DISTCLEANSUFFIXES)
-       $(RM) config.* .config libavutil/avconfig.h .version version.h
+       $(RM) config.* .config libavutil/avconfig.h .version avversion.h
 
 config:
        $(SRC_PATH)/configure $(value LIBAV_CONFIGURATION)
index c4a7819..bc22ef5 100644 (file)
@@ -45,8 +45,8 @@
 #include "libavutil/dict.h"
 #include "libavutil/opt.h"
 #include "libavutil/cpu.h"
+#include "avversion.h"
 #include "cmdutils.h"
-#include "version.h"
 #if CONFIG_NETWORK
 #include "libavformat/network.h"
 #endif
index 0ddfb11..06ad1b7 100644 (file)
@@ -19,6 +19,9 @@ API changes, most recent first:
 2015-xx-xx - xxxxxxx - lavu 54.14.0 - cpu.h
   Add AV_CPU_FLAG_AVXSLOW.
 
+2015-xx-xx - xxxxxxx - lavu 56.xx.0
+  Add av_version_info().
+
 2015-xx-xx - xxxxxxx - lavc 56.23.0
   Add av_vda_default_init2.
 
index f056415..688068e 100644 (file)
 unsigned avutil_version(void);
 
 /**
+ * Return an informative version string. This usually is the actual release
+ * version number or a git commit description. This string has no fixed format
+ * and can change any time. It should never be parsed by code.
+ */
+const char *av_version_info(void);
+
+/**
  * Return the libavutil build-time configuration.
  */
 const char *avutil_configuration(void);
index c8c161d..8dcf3b6 100644 (file)
 #include "config.h"
 #include "avutil.h"
 
+#include "avversion.h"
+
 /**
  * @file
  * various utility functions
  */
 
+const char *av_version_info(void)
+{
+    return LIBAV_VERSION;
+}
+
 unsigned avutil_version(void)
 {
     return LIBAVUTIL_VERSION_INT;