summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorDavid Rheinsberg <david@readahead.eu>2024-10-11 10:07:40 +0200
committerDavid Rheinsberg <david@readahead.eu>2024-10-11 10:42:06 +0200
commitcbaebf811e6edb79279f72950b2d63189be314d3 (patch)
treec462ecf34ef8105b7ba20650e072f4a2a816023c /docs
parentudev: allow persistent storage rules for ublk devices (diff)
downloadsystemd-cbaebf811e6edb79279f72950b2d63189be314d3.tar.xz
systemd-cbaebf811e6edb79279f72950b2d63189be314d3.zip
docs/DESKTOP_ENVIRONMENT: clarify <RANDOM> usage
The <RANDOM> part is optional in the naming scheme of application units. However, this is only true for service files. Scope units must include the <RANDOM> part, otherwise it would be impossible to parse: The schema would be: `app[-<launcher>]-<ApplicationID>[-<RANDOM>].scope` in which case a two-part name would be impossible to parse, since it is unclear whether the launcher of the random bit where omitted.
Diffstat (limited to 'docs')
-rw-r--r--docs/DESKTOP_ENVIRONMENTS.md10
1 files changed, 5 insertions, 5 deletions
diff --git a/docs/DESKTOP_ENVIRONMENTS.md b/docs/DESKTOP_ENVIRONMENTS.md
index ebf4694934..a42efd6791 100644
--- a/docs/DESKTOP_ENVIRONMENTS.md
+++ b/docs/DESKTOP_ENVIRONMENTS.md
@@ -65,11 +65,11 @@ desktop environments should adhere to the following conventions:
instead of the caller starting the process and letting systemd know about it,
is encouraged.
- * The RANDOM should be a string of random characters to ensure that multiple instances
- of the application can be launched.
-
- It can be omitted in the case of a non-transient application services which can ensure
- multiple instances are not spawned, such as a DBus activated application.
+ * `<RANDOM>` should be a string of random characters to ensure that multiple instances
+ of the application can be launched. This can be omitted for service files of
+ non-transient applications, which ensure multiple instances cannot be
+ spawned. For scope files `<RANDOM>` is mandatory, as the format would be
+ ambiguous otherwise.
* If no application ID is available, the launcher should generate a reasonable
name when possible (e.g. using `basename(argv[0])`). This name must not