<html>
<head>
<meta content="text/html; charset=ISO-8859-1"
http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<div class="moz-cite-prefix">On 06/09/2013 04:48 AM, Frank Lanitz
wrote:<br>
</div>
<blockquote
cite="mid:20130609134848.2c274d72369643258c83edc1@frank.uvena.de"
type="cite">
<pre wrap="">On Sun, 09 Jun 2013 03:54:05 -0700
Roger Booth <a class="moz-txt-link-rfc2396E" href="mailto:rbooth@kabooth.com"><rbooth@kabooth.com></a> wrote:
</pre>
<blockquote type="cite">
<pre wrap="">I assume you are surprised by this. How dare the user of our docs not
study to great lengths the implementations of the shit we (and others
that have come before us) have produced. Nobody should have the
effrontery to attempt to interface our code without spending a
sufficient amount of time appreciating the edifice we have erected.
</pre>
</blockquote>
<pre wrap="">
Please don't be a party-puper. Geany is FLOSS and everybody is welcome
to improve ... also the documentation. You recognized that the
documentation might not be clear in all cases. .. yepp. That's true.
But it's hard to find such things for somebody who knows the code from
deep inside the heard that Geany-Version -> API-Version -> ABI-Version.
so no need to document it for them.
Please take a look at github and improve the parts of documentation.
Complaining on the mailing list that the whole documentation suckz just
is making people spending a lot of spare time sad and sending them into
aggro-mode.
Would be really happy to see a patch improving that aspect from
documentation as well as the Plugin-HowTo.
cheers,
Frank
</pre>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<br>
<pre wrap="">_______________________________________________
Devel mailing list
<a class="moz-txt-link-abbreviated" href="mailto:Devel@lists.geany.org">Devel@lists.geany.org</a>
<a class="moz-txt-link-freetext" href="https://lists.geany.org/cgi-bin/mailman/listinfo/devel">https://lists.geany.org/cgi-bin/mailman/listinfo/devel</a>
</pre>
</blockquote>
But if I'm going to *improve* the docs, I *still* have an
outstanding (in a manner of speaking) question:<br>
<br>
Why does the function plugin_init() accept the one parameter
GeanyData*?<br>
<br>
The reason that is a question is that the three global variables <br>
<br>
GeanyPlugin *geany_plugin;<br>
GeanyData *geany_data;<br>
GeanyFunctions *geany_functions;<br>
<br>
are available to a plugin and you will notice that one of those
global variables is geany_data which is suspiciously similar to the
parameter to plugin_init().<br>
<br>
So either there is no reason to pass the parameter to plugin_init()
or there is a good reason to pass the parameter to plugin_init(). <br>
<br>
Either way, I'd like to know. Maybe others would to.<br>
<br>
A previous reply from Matthew Brush made me think that I need to
really spell out what I mean here. Say I have the following<br>
<br>
GeanyData *geany_data;<br>
extern "C" void plugin_init(GeanyData *bob)<br>
{<br>
if(*geany_data == *bob) {<br>
exit(1);<br>
} else {<br>
exit(2);<br>
}<br>
}<br>
<br>
What I'm trying to ask by this example, and remember, I'm a moron,
is <br>
<br>
'is geany_data the same as bob?' <br>
<br>
Please don't get all wishy-washy on me here. geany_data and bob are
both pointers. My question is<br>
<br>
Do bob and geany_data point to the same location in memory.<br>
<br>
Now you could all say "geez, moron, just do a comparison". I know
how to do that. But that would only say that this version is blah.<br>
What I want to know is about API guarantees. I want to be able to
document the plugin_init() function and say<br>
<br>
geany_data == bob<br>
<br>
or not.<br>
<br>
<br>
P.S.<br>
<br>
<pre wrap="">>> Complaining on the mailing list that the whole documentation suckz</pre>
Um, I was commenting on one macro for the plugin API. Actually, I
think in general the docs are superb. I want to improve the areas
where I see they can be improved, and I volunteer to do so and have
already done so. What pissed me off was my impression that yall
thought this particular area of the docs was just peachy and I was
just blowing smoke.<br>
</body>
</html>