<p>In <a href="https://github.com/geany/geany/pull/890#discussion_r53470752">scripts/gen-api-gtkdoc.py</a>:</p>
<pre style='color:#555'>> +        proc = DoxygenProcess()
> +        self.brief = proc.process_element(xml)
> +        self.extra += proc.get_extra()
> +
> +    def add_detail(self, xml):
> +        proc = DoxygenProcess()
> +        self.detail = proc.process_element(xml)
> +        self.extra += proc.get_extra()
> +        self.since = proc.get_since()
> +
> +    def add_member(self, xml):
> +        name = xml.find("name").text
> +        proc = DoxygenProcess()
> +        brief = proc.process_element(xml.find("briefdescription"))
> +        # optional doxygen command output appears within <detaileddescription />
> +        proc.process_element(xml.find("detaileddescription"))
</pre>
<p>Members are usually commented after the semicolon. In this case there is only a briefdescription. They can also be commented like functions in which case annotations are expected in the detaildescription (I'm not sure we have any of these currently?).</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/890/files#r53470752">view it on GitHub</a>.<img alt="" height="1" src="https://github.com/notifications/beacon/ABDrJ3PciaFEXh5aqjRnxZrz91x0cddoks5plyZ3gaJpZM4HM9VD.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/files#r53470752"></link>
  <meta itemprop="name" content="View Pull Request"></meta>
</div>
<meta itemprop="description" content="View this Pull Request on GitHub"></meta>
</div>