mirror of
https://gitlab.freedesktop.org/dbus/dbus.git
synced 2026-01-01 19:50:12 +01:00
bafb2c455d
Previously, we arbitrarily divided o.fd.DBus into "messages" (methods and signals), in one sect2, and Properties, in another sect2; and for the only extended interface that is documented so far, o.fd.DBus.Monitoring, we included its single method in the list of o.fd.DBus methods. This is putting too much weight on implementation details of how the D-Bus protocol is implemented (with Properties being "less core" than methods and signals), and not enough weight on how interfaces are conceptually structured. It's more usual to group together all aspects of an interface into one document or section, and the current arbitrary separation is going to look more and more odd as we start documenting more interfaces like Containers (dbus!449), Stats and Verbose. Instead, repurpose the "Message Bus Messages" section to become the documentation for the o.fd.DBus interface, and introduce a separate section for each other interface that the message bus provides. Each one contains a full list of methods, signals and properties (if any) if it is specific to the message bus, or a cross-reference to a more generic interface description if it is equally applicable to the message bus and its clients. Prompted by discussion on dbus!449. Signed-off-by: Simon McVittie <smcv@collabora.com> |
||
|---|---|---|
| .. | ||
| .gitignore | ||
| busconfig.dtd | ||
| catalog.xml.in | ||
| CMakeLists.txt | ||
| dbus-api-design.duck | ||
| dbus-cleanup-sockets.1.xml.in | ||
| dbus-daemon.1.xml.in | ||
| dbus-faq.xml | ||
| dbus-launch.1.xml.in | ||
| dbus-monitor.1.xml.in | ||
| dbus-run-session.1.xml.in | ||
| dbus-send.1.xml.in | ||
| dbus-specification.xml | ||
| dbus-test-plan.xml | ||
| dbus-test-tool.1.xml.in | ||
| dbus-tutorial.xml | ||
| dbus-update-activation-environment.1.xml.in | ||
| dbus-uuidgen.1.xml.in | ||
| dcop-howto.txt | ||
| diagram.png | ||
| diagram.svg | ||
| doxygen_to_devhelp.xsl | ||
| file-boilerplate.c | ||
| index.html.in | ||
| introspect.dtd | ||
| introspect.xsl | ||
| list-doc-source.py | ||
| maintainer-upload-docs.sh | ||
| meson.build | ||
| meson_post_install.py | ||
| system-activation.txt | ||
| TODO | ||
