<p>This is probably not ready yet, but open for review. The new script probably needs some more cleanup but since I'm not sure anyone is interested in reviewing ruby code I decided to PR'ify.</p>

<p>Description: This PR does some prep work, then enables generating xml output from doxygen, and lastly generate gtkdoc'ized headers from the xml output. The gtkdoc'ized headers in turn are input to g-ir-scanner and g-ir-compile but that's not port of the PR yet (but I have it working on my side).</p>

<p>If we decide to not ship the actual .gir and .typelib files for gobject-introspection yet, then we should at least ship the gtkdoc headers so that I can use it to generate .gir and .typelib on my own in my plugin for now.</p>

<hr>

<h4>You can view, comment on, or merge this pull request online at:</h4>
<p>  <a href='https://github.com/geany/geany/pull/890'>https://github.com/geany/geany/pull/890</a></p>

<h4>Commit Summary</h4>
<ul>
  <li>doxygen: generate xml too in preparation for gtkdoc generation</li>
  <li>doxygen: various doxygen-related fixes in preparation for gtkdoc generation</li>
  <li>api: add script to generate {geany,geany-scintilla}-gtkdoc.h</li>
</ul>

<h4>File Changes</h4>
<ul>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-0">.gitignore</a>
    (1)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-1">configure.ac</a>
    (1)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-2">doc/Doxyfile.in</a>
    (16)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-3">doc/Makefile.am</a>
    (40)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-4">doc/pluginsymbols.c</a>
    (4)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-5">m4/geany-docutils.m4</a>
    (16)
  </li>
  <li>
    <strong>A</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-6">scripts/gen-api-gtkdoc.rb</a>
    (490)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-7">src/document.c</a>
    (18)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-8">src/editor.c</a>
    (2)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-9">src/editor.h</a>
    (2)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-10">src/encodingsprivate.h</a>
    (6)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-11">src/filetypes.c</a>
    (19)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-12">src/filetypes.h</a>
    (3)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-13">src/keybindings.c</a>
    (10)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-14">src/plugindata.h</a>
    (4)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-15">src/pluginutils.c</a>
    (16)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-16">src/spawn.c</a>
    (1)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-17">src/stash.c</a>
    (2)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-18">src/ui_utils.c</a>
    (29)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-19">src/utils.c</a>
    (15)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/geany/geany/pull/890/files#diff-20">tagmanager/src/tm_workspace.c</a>
    (4)
  </li>
</ul>

<h4>Patch Links:</h4>
<ul>
  <li><a href='https://github.com/geany/geany/pull/890.patch'>https://github.com/geany/geany/pull/890.patch</a></li>
  <li><a href='https://github.com/geany/geany/pull/890.diff'>https://github.com/geany/geany/pull/890.diff</a></li>
</ul>

<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/890">view it on GitHub</a>.<img alt="" height="1" src="https://github.com/notifications/beacon/ABDrJ_8HgCMXD899b2K0DTWxko-mXoknks5pd_J1gaJpZM4HM9VD.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/890"></link>
  <meta itemprop="name" content="View Pull Request"></meta>
</div>
<meta itemprop="description" content="View this Pull Request on GitHub"></meta>
</div>