Deprecate PLUGIN_KEY_GROUP() macro - use plugin_set_key_group()

instead.



git-svn-id: https://geany.svn.sourceforge.net/svnroot/geany/trunk@4401 ea778897-0a13-0410-b9d1-a72fbfd435f5
This commit is contained in:
Nick Treleaven 2009-11-05 16:17:11 +00:00
parent 6e873a5bd0
commit 48cd3cbc12
3 changed files with 16 additions and 8 deletions

View File

@ -1,3 +1,10 @@
2009-11-05 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com>
* src/plugindata.h, HACKING:
Deprecate PLUGIN_KEY_GROUP() macro - use plugin_set_key_group()
instead.
2009-11-04 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de>
* tagmanager/makefile.win32:

View File

@ -75,10 +75,10 @@ the existing elements stay in place - this will keep the ABI stable.
.. warning::
Some structs like GeanyKeyGroupInfo and GeanyCallback cannot be
appended to without breaking the ABI because they are used to declare
structs by plugins, not just for accessing struct members through
a pointer.
Some structs like GeanyCallback cannot be appended to without
breaking the ABI because they are used to declare structs by
plugins, not just for accessing struct members through a pointer.
Normally structs should never be allocated by plugins.
Keeping the plugin ABI stable
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

View File

@ -119,7 +119,8 @@ GeanyPlugin;
}
/** @see PLUGIN_KEY_GROUP() macro. */
/** @deprecated - use plugin_set_key_group() instead.
* @see PLUGIN_KEY_GROUP() macro. */
typedef struct GeanyKeyGroupInfo
{
const gchar *name; /**< Group name used in the configuration file, such as @c "html_chars" */
@ -127,7 +128,8 @@ typedef struct GeanyKeyGroupInfo
}
GeanyKeyGroupInfo;
/** Declare and initialise a keybinding group.
/** @deprecated - use plugin_set_key_group() instead.
* Declare and initialise a keybinding group.
* @code GeanyKeyGroup *plugin_key_group; @endcode
* You must then set the @c plugin_key_group::keys[] entries for the group in plugin_init(),
* normally using keybindings_set_item().
@ -135,8 +137,7 @@ GeanyKeyGroupInfo;
* is called, to the name of the plugin.
* @param group_name A unique group name (without quotes) to be used in the
* configuration file, such as @c html_chars.
* @param key_count The number of keybindings the group will hold.
* @see plugin_set_key_group() to set the group size dynamically. */
* @param key_count The number of keybindings the group will hold. */
#define PLUGIN_KEY_GROUP(group_name, key_count) \
/* We have to declare this as a single element array.
* Declaring as a pointer to a struct doesn't work with g_module_symbol(). */ \