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

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?).

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