docs/DESKTOP_ENVIRONMENTS: clarify name aliases

Add a note to the service-file naming scheme that reminds developers
that those names might be aliases. Hence, when parsing such unit names,
the entire name-array of a unit must be parsed, rather than just the
unit ID.

The service-name of existing applications might be already part of their
API. Hence, not all applications can switch the service ID to this new
naming scheme, but can provide suitable aliases. Document this behavior.

diff --git a/docs/DESKTOP_ENVIRONMENTS.md b/docs/DESKTOP_ENVIRONMENTS.md
index a42efd6791ec0e015f65bfdcc3be3034b585a987..4f82ce77995dc9a6eea6787ce9694325679e760c 100644 (file)
--- a/docs/DESKTOP_ENVIRONMENTS.md
+++ b/docs/DESKTOP_ENVIRONMENTS.md
@@ -81,7 +81,10 @@ This has the following advantages:
    adjusted using desktop environment specific drop-in files.
 
  * The application ID can be retrieved by stripping the prefix and postfix.
-   This in turn should map to the corresponding `.desktop` file when available
+   This in turn should map to the corresponding `.desktop` file when available.
+
+   Note that this nameing scheme might be a unit alias, so runtime detection
+   must check the entire name-array of a unit, rather than just its unit ID.
 
 TODO: Define the name of slices that should be used.
 This could be `app-<launcher>-<ApplicationID>-<RANDOM>.slice`.