<blockquote>
<p>I would agree to either drop this PR as <a href="https://github.com/kugel" class="user-mention">@kugel</a> suggested or postpone it to 1.27.</p>
</blockquote>

<p>We can't really postpone it, as it changes the new plugin API, and then would mean we break the new API from 1.26 in 1.27 :)</p>

<p>But apparently we agree to drop this.  IMO we should document this, so what about something like this:</p>

<div class="highlight highlight-source-diff"><pre><span class="pl-c1">diff --git a/src/pluginutils.c b/src/pluginutils.c</span>
index e48b4c1..4470313 100644
<span class="pl-md">--- a/src/pluginutils.c</span>
<span class="pl-mi1">+++ b/src/pluginutils.c</span>
<span class="pl-mdr">@@ -92,6 +92,24 @@</span> void plugin_add_toolbar_item(GeanyPlugin *plugin, GtkToolItem *item)
  *
  * @param plugin Must be @ref geany_plugin.
  *
<span class="pl-mi1">+ * @warning This cannot be used from inside `geany_load_module()` using the new plugin API.</span>
<span class="pl-mi1">+ * You generally should only call this from your plugin's `GeanyPluginFuncs::init()`</span>
<span class="pl-mi1">+ * function if possible to avoid possible extra resource usage when your plugin isn't</span>
<span class="pl-mi1">+ * actually activated. If you really need your module to be resident whenever it has been</span>
<span class="pl-mi1">+ * loaded (i.e. you create GTypes directly in your `geany_load_module()`), you need to use</span>
<span class="pl-mi1">+ * GLib's</span>
<span class="pl-mi1">+ * [g_module_check_init()](https://developer.gnome.org/glib/stable/glib-Dynamic-Loading-of-Modules.html#GModuleCheckInit)</span>
<span class="pl-mi1">+ * hook and call</span>
<span class="pl-mi1">+ * [g_module_make_resident()](https://developer.gnome.org/glib/unstable/glib-Dynamic-Loading-of-Modules.html#g-module-make-resident)</span>
<span class="pl-mi1">+ * from there:</span>
<span class="pl-mi1">+ * @code</span>
<span class="pl-mi1">+ * const gchar *g_module_check_init(GModule *module)</span>
<span class="pl-mi1">+ * {</span>
<span class="pl-mi1">+ *  g_module_make_resident(module);</span>
<span class="pl-mi1">+ *  return NULL;</span>
<span class="pl-mi1">+ * }</span>
<span class="pl-mi1">+ * @endcode</span>
<span class="pl-mi1">+ *</span>
  *  @since 0.16
  */
 GEANY_API_SYMBOL</pre></div>

<p>Which gives:<br>
<a href="https://cloud.githubusercontent.com/assets/793526/11164884/fb433cce-8afd-11e5-9cdf-24aac16c0b9f.png" target="_blank"><img src="https://cloud.githubusercontent.com/assets/793526/11164884/fb433cce-8afd-11e5-9cdf-24aac16c0b9f.png" alt="capture d ecran 2015-11-14 a 18 31 24" style="max-width:100%;"></a></p>

<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">—<br>Reply to this email directly or <a href="https://github.com/geany/geany/pull/719#issuecomment-156722007">view it on GitHub</a>.<img alt="" height="1" src="https://github.com/notifications/beacon/ABDrJ26Go8mKkv-LoBhnnBilNhRsb_rNks5pF2e-gaJpZM4GZg2a.gif" width="1" /></p>
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="action" itemscope itemtype="http://schema.org/ViewAction">
  <link itemprop="url" href="https://github.com/geany/geany/pull/719#issuecomment-156722007"></link>
  <meta itemprop="name" content="View Pull Request"></meta>
</div>
<meta itemprop="description" content="View this Pull Request on GitHub"></meta>
</div>