diff --git a/man/sd_bus_default.xml b/man/sd_bus_default.xml
index 6d5a90de72..d9102a36ce 100644
--- a/man/sd_bus_default.xml
+++ b/man/sd_bus_default.xml
@@ -165,13 +165,17 @@
not set, a suitable default for the default system D-Bus instance
will be used.
- sd_bus_open_system_remote() connects to
- the system bus on the specified host using
- ssh1. host
- consists of an optional user name followed by the
- @ symbol, and the hostname.
-
+ sd_bus_open_system_remote() connects to the system bus on
+ the specified host using
+ ssh1.
+ host consists of an optional user name followed by the
+ @ symbol, and the hostname, optionally followed by a
+ : and a machine name. If the machine name is given, a connection
+ is created to the system bus in the specified container on the remote machine, and
+ otherwise a connection to the system bus on the specified host is created.
+
+ Note that entering a container is a privileged operation, and will likely only
+ work for the root user on the remote machine.
sd_bus_open_system_machine() connects
to the system bus in the specified machine,