Comments In Introspection XML?

Lawrence D'Oliveiro <ldo-kC51rjc0cqs1dNLGKZg6taU/[email protected]> Thu, 19 Oct 2017 16:41:05 +1300

Newsgroups	gmane.comp.freedesktop.dbus
Organization	Geek Central
Message-ID	<[email protected]>

I think it would be handy to be able to include explanatory comments in
the introspection XML. This would be helpful to scripters trying to
figure out how to communicate with some D-Bus peer; the comments can
explain what the methods/signals/properties are for, rather than having
to try to guess what they do from their names or other clues.

I can think of two options for doing this:
  * use XML comments
  * or, add a new <annotation> type.

A slight drawback with the first one is that some XML parsers strip out
comments.

Thoughts?
_______________________________________________
dbus mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dbus