From f0f7cbd488fd0e00c5b77baf3b1324240fd7d72d Mon Sep 17 00:00:00 2001
From: Luca Boccassi <bluca@debian.org>
Date: Sat, 22 Apr 2023 12:47:20 +0100
Subject: man: clarify sd_bus_default

It picks the bus based on the cgroup slice.
---
 man/sd_bus_default.xml | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

(limited to 'man')

diff --git a/man/sd_bus_default.xml b/man/sd_bus_default.xml
index 48d9c9a108..8be4254be1 100644
--- a/man/sd_bus_default.xml
+++ b/man/sd_bus_default.xml
@@ -110,13 +110,14 @@
     <title>Description</title>
 
     <para><function>sd_bus_default()</function> acquires a bus
-    connection object to the user bus when invoked in user context, or
-    to the system bus otherwise. The connection object is associated
-    with the calling thread. Each time the function is invoked from
-    the same thread, the same object is returned, but its reference
-    count is increased by one, as long as at least one reference is
-    kept. When the last reference to the connection is dropped (using
-    the
+    connection object to the user bus when invoked from within a user
+    slice (any session under <literal>user-*.slice</literal>, e.g.:
+    <literal>user@1000.service</literal>), or to the system bus
+    otherwise. The connection object is associated with the calling
+    thread. Each time the function is invoked from the same thread,
+    the same object is returned, but its reference count is increased
+    by one, as long as at least one reference is kept. When the last
+    reference to the connection is dropped (using the
     <citerefentry><refentrytitle>sd_bus_unref</refentrytitle><manvolnum>3</manvolnum></citerefentry>
     call), the connection is terminated. Note that the connection is
     not automatically terminated when the associated thread ends. It
-- 
cgit v1.2.1