+++ This bug was initially created as a clone of Bug #103216 +++ We don't really need two parallel forms of punctuation, and in particular DNS domain names only have one (dashes). If we choose one representation and deprecate the other, it makes the recommendation clearer for app authors. Relevant: https://bugs.freedesktop.org/show_bug.cgi?id=103216 https://github.com/flatpak/flatpak-builder/issues/37 https://github.com/parnold-x/nasc/issues/67 https://github.com/elementary/houston/issues/436
Created attachment 135726 [details] [review] 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. --- Not to be applied until the patches on Bug #103216 are.
Comment on attachment 135726 [details] [review] spec: Deprecate hyphen/minus in well-known names Review of attachment 135726 [details] [review]: ----------------------------------------------------------------- Looks good to me. One nitpick, but I don’t care whether it’s changed or not. Good to push with/without a fix. ::: doc/dbus-specification.xml @@ +1877,5 @@ > simultaneously if backwards compatibility is required. > </para> > > + <para> > + As with interface names, if the author's DNS domain name Nitpick: ‘As with’ could be a link back to the interface names section.
Looks good to me
(In reply to Philip Withnall from comment #2) > Nitpick: ‘As with’ could be a link back to the interface names section. The previous paragraph already has that link, so another one seemed unnecessary.
(In reply to Simon McVittie from comment #4) > (In reply to Philip Withnall from comment #2) > > Nitpick: ‘As with’ could be a link back to the interface names section. > > The previous paragraph already has that link, so another one seemed > unnecessary. Ah, cool.
Fixed in git for spec v0.32 (dbus 1.13.0). Thanks!
Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.