Fwd: Re: Annotation in introspection XML <arg> elements?

[Ralf Habacker]

Am 11.11.2014 um 12:59 schrieb Simon McVittie:
> On 10/11/14 20:01, rony wrote:
>> On 10.11.2014 19:08, Lennart Poettering wrote:
>>> I noticed that colord exposes <annotation> elements in the XML
>>> introspection data, inside <arg> elements.
> I think it would be fine to allow this.
>
>> However a kind request for a URL to the official standard for the freedesktop.org Introspection
>> DTD/XSD, it seems I cannot locate it.
> doc/introspect.dtd in dbus.git is probably the canonical version.
>
> If there is a canonical way to update the copy used by
> standards.freedesktop.org, I don't know it; given that I do basically
> all the dbus releases, in practice this means the copy used by
> standards.freedesktop.org does not get updated for new dbus releases.
this looks to be automated:

from http://standards.freedesktop.org/README

This directory contains the files used to export the specifications on
  http://specifications.freedesktop.org/

It's mostly two files:

 - specs.idx: information on where to fetch specific versions of different
   specifications (usually from git)

 - update.py: hacky script that uses specs.idx and creates html pages


http://standards.freedesktop.org/specs.idx
....

git:dbus/dbus:doc/introspect.dtd				7652304bff969afb3969603149bb385efe861fe8		1.0	dbus

...

but rather outdated.

git log 7652304bff969afb3969603149bb385efe861fe8

commit 7652304bff969afb3969603149bb385efe861fe8
Author: John (J5) Palmieri <johnp at redhat.com>
Date:   Thu Aug 3 20:34:36 2006 +0000

    * s/D-BUS/D-Bus/g

Ralf