dbus/doc
Simon McVittie ac49b22458 spec: Deprecate hyphen/minus in well-known names
We don't really need two parallel forms of punctuation, and in
particular DNS domain names only have one (hyphens). If we choose one
representation and deprecate the other, it makes the recommendation
clearer for app authors.

This reflects a similar change to the Desktop Entry Specification,
which uses D-Bus well-known names as app IDs. While hyphens are not a
problem for D-Bus well-known names or for freedesktop.org app IDs,
they create problems for adjacent APIs and specifications that want to
use a well-known name in a context where hyphens are not allowed.
Hyphens are not allowed in D-Bus object paths and interface names,
are only conditionally allowed in Flatpak app IDs (they can only
appear in the last element), and have a special syntactic role in
Freedesktop icon names.

Bug: https://bugs.freedesktop.org/show_bug.cgi?id=103216
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=103914
Signed-off-by: Simon McVittie <smcv@collabora.com>
Reviewed-by: Philip Withnall <withnall@endlessm.com>
Reviewed-by: Alexander Larsson <alexl@redhat.com>
2017-12-24 18:27:16 +00:00
..
.gitignore doc: Add a guide to designing D-Bus APIs 2015-02-16 13:45:37 +00:00
busconfig.dtd Add apparmor element and attributes to the bus config dtd 2015-02-18 17:03:56 +00:00
dbus-api-design.duck doc: Clarify /etc/dbus-1/system.d and /usr/share/dbus-1/system.d 2017-02-24 18:34:22 +00:00
dbus-cleanup-sockets.1.xml.in Eliminate unwanted whitespace from the man pages' XML source 2013-02-18 14:16:18 +00:00
dbus-daemon.1.xml.in bus: Add (unused) settings for resource limits for containers 2017-12-12 16:22:35 +00:00
dbus-faq.xml Unify docbook dtd version to 4.4. 2013-04-19 12:40:01 +01:00
dbus-launch.1.xml.in dbus-launch: add --exit-with-x11 option 2016-07-20 13:32:36 +01:00
dbus-monitor.1.xml.in dbus-monitor: add options to log binary data with or without pcap framing 2015-02-04 17:15:34 +00:00
dbus-run-session.1.xml.in dbus-run-session(1): document modern Automake syntax 2015-04-16 13:06:27 +01:00
dbus-send.1.xml.in doc: Fix dbus-send.1 uint16 typo 2017-10-09 13:35:22 +01:00
dbus-specification.xml spec: Deprecate hyphen/minus in well-known names 2017-12-24 18:27:16 +00:00
dbus-test-plan.xml Rename bus-test to test-bus to match common test application naming scheme. 2014-01-17 16:29:37 +00:00
dbus-test-tool.1.xml.in dbus-test-tool echo: fix sleep documentation 2016-03-02 18:19:35 +00:00
dbus-tutorial.xml dbus-tutorial: replace the entire GLib section with "use GDBus" 2014-10-29 14:15:53 +00:00
dbus-update-activation-environment.1.xml.in Add dbus-update-activation-environment tool 2015-02-24 11:15:52 +00:00
dbus-uuidgen.1.xml.in Eliminate unwanted whitespace from the man pages' XML source 2013-02-18 14:16:18 +00:00
dcop-howto.txt initial import of "dbus" skeleton 2002-11-21 16:41:33 +00:00
diagram.png 2005-01-18 Havoc Pennington <hp@redhat.com> 2005-01-18 20:42:15 +00:00
diagram.svg 2005-01-18 Havoc Pennington <hp@redhat.com> 2005-01-18 20:42:15 +00:00
doxygen_to_devhelp.xsl Add doxygen_to_devhelp.xsl (from Fedora, via Debian) 2011-01-14 12:45:46 +00:00
file-boilerplate.c Bug 21161 - Update the FSF address 2009-07-14 15:39:47 -04:00
introspect.dtd spec: Allow <annotation> in <arg> elements in introspection XML 2016-10-03 11:33:47 +01:00
introspect.xsl spec: Allow <annotation> in <arg> elements in introspection XML 2016-10-03 11:33:47 +01:00
Makefile.am doc: Install introspection and busconfig DTDs 2016-10-05 10:08:10 +01:00
system-activation.txt doc: Clarify /etc/dbus-1/system.d and /usr/share/dbus-1/system.d 2017-02-24 18:34:22 +00:00
TODO 2006-11-08 Havoc Pennington <hp@redhat.com> 2006-11-09 00:19:29 +00:00