On Fri, Nov 14, 2008 at 3:25 PM, David Malcolm <dmalcolm@xxxxxxxxxx> 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. -- fedora-devel-list mailing list fedora-devel-list@xxxxxxxxxx https://www.redhat.com/mailman/listinfo/fedora-devel-list
