<blockquote>
<p>I'd like to treat the .gir like a black box as far as possible because <br>
the format is not documented or stable, subject to change at any time. I <br>
don't consider the extra symbols to be that much of a problem to start <br>
processing the .gir.</p>
</blockquote>

<p>I don't consider the format possible instability (which is rather theoretical as there are more than one tool that deal with it, so it's unlikely to change enough to break much things) not really a reason enough to drop in what I see as useless symbols.  And that we should maintain either manually or trusting a generation script that will parse C to generate actual code in the library.</p>

<p>And as a proof of concept, although it's indeed somewhat hacky, I successfully generated what looks like a proper GIR simply replacing a few symbols before and after: <a href="https://gist.github.com/b4n/75806eaaa87f3b0990a7">https://gist.github.com/b4n/75806eaaa87f3b0990a7</a><br>
Sure it's not as neat as would be having everything recognized out of the box by g-ir-scanner, but it seems better to me than adding more complex stuff to sneak in extra symbols just to make it happy.</p>

<blockquote>
<p>Might be doable with the doxygen too.  The problem with a doxygen-based <br>
solution is that the doxygen output is generated after lingeany is <br>
built, basically too late to add symbols to it.</p>
</blockquote>

<p>Fair point.</p>

<blockquote>
<p>If we can agree on shipping the symbols then I'd suggest to actually <br>
ship the .c file and deal with how to generate after the release (I'm <br>
not sure I'll manage to bring a doxygen-based solution in time).</p>
</blockquote>

<p>POssibly, but I really would rather avoid that.</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/935#issuecomment-192998243">view it on GitHub</a>.<img alt="" height="1" src="https://github.com/notifications/beacon/ABDrJ--lKhm0507xKUeB1oHMoRTsHCI4ks5pq0TagaJpZM4HqIcu.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/935#issuecomment-192998243"></link>
  <meta itemprop="name" content="View Pull Request"></meta>
</div>
<meta itemprop="description" content="View this Pull Request on GitHub"></meta>
</div>