In scripts/gen-api-gtkdoc.py:

> +        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"))

apparently processing the detailed description like this erases any possible annotation from the brief description, which is not handy for members

—
Reply to this email directly or view it on GitHub.