From 7b091809db5d03d6373e39183bd796a8b485e709 Mon Sep 17 00:00:00 2001
From: Thomas Martitz <kugel@rockbox.org>
Date: Thu, 23 Feb 2017 07:41:40 +0100
Subject: [PATCH] api: new function geany_api_version

This allows plugins to detect the API version of Geany at runtime. This enables
soft dependencies based on Geany's API version, perhaps using a new feature
with a fallback for older API versions. Previously the only alternatives
were hard-depending on a more recent Geany version or ignoring new features.
---
 src/plugindata.h  |  2 +-
 src/pluginutils.c | 16 ++++++++++++++++
 src/pluginutils.h |  1 +
 3 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/src/plugindata.h b/src/plugindata.h
index 6a021556..fb06a512 100644
--- a/src/plugindata.h
+++ b/src/plugindata.h
@@ -59,7 +59,7 @@ G_BEGIN_DECLS
  * @warning You should not test for values below 200 as previously
  * @c GEANY_API_VERSION was defined as an enum value, not a macro.
  */
-#define GEANY_API_VERSION 230
+#define GEANY_API_VERSION 231
 
 /* hack to have a different ABI when built with GTK3 because loading GTK2-linked plugins
  * with GTK3-linked Geany leads to crash */
diff --git a/src/pluginutils.c b/src/pluginutils.c
index 546b1575..1e431cfb 100644
--- a/src/pluginutils.c
+++ b/src/pluginutils.c
@@ -52,6 +52,22 @@ typedef struct
 PluginDocDataProxy;
 
 
+/** Returns the runtime API version Geany was compiled with.
+ *
+ * Unlike @ref GEANY_API_VERSION this version is the value of that
+ * define at the time when Geany itself was compiled. This allows to
+ * establish soft dependencies which are resolved at runtime depending
+ * on Geany's API version.
+ *
+ * @return Geany's API version
+ * @since 1.30 (API 231)
+ **/
+GEANY_API_SYMBOL
+gint geany_api_version(void)
+{
+	return GEANY_API_VERSION;
+}
+
 /** Inserts a toolbar item before the Quit button, or after the previous plugin toolbar item.
  * A separator is added on the first call to this function, and will be shown when @a item is
  * shown; hidden when @a item is hidden.
diff --git a/src/pluginutils.h b/src/pluginutils.h
index d679e4b0..ccc0a400 100644
--- a/src/pluginutils.h
+++ b/src/pluginutils.h
@@ -35,6 +35,7 @@ G_BEGIN_DECLS
 struct GeanyPlugin;
 struct GeanyDocument;
 
+gint geany_api_version(void);
 
 void plugin_add_toolbar_item(struct GeanyPlugin *plugin, GtkToolItem *item);