Manpages for DBus services? was Re: starting Fedora Server SIG
Colin Walters
walters at verbum.org
Fri Nov 14 20:51:49 UTC 2008
On Fri, Nov 14, 2008 at 3:25 PM, David Malcolm <dmalcolm at redhat.com> wrote:
>
> Brainstorming here, but do DBus services come with some form of
> documentation format?
Not intrinsically, we decided it would be a bad idea to put docs in
the introspection XML. However,
> If so, it it possible to generate a man page per
> service, and ship it in the rpm, as one step towards making DBus more
> accessible to old-school Unix types?
Various projects do different things for interface documentation; for
NetworkManager in particular see here:
http://live.gnome.org/NetworkManagerDBusInterface
The documentation is not yet shipped in the package that I see though
(it probably should be in NetworkManager-devel).
For ConsoleKit there are docs in the shipped introspection XML:
/usr/share/dbus-1/interfaces/org.freedesktop.ConsoleKit.Manager.xml
Eventually we'll straighten this out and probably have some sort of
standard IDL and associated documentation, and probably have -devel
packages build and ship HTML formatted docs. Up until now mostly
these interfaces have been for freedesktop/GNOME/KDE hackers to use
internally, not really for 3rd party developers.
More information about the fedora-devel-list
mailing list