From db6d9e864083b3ce8206a065e9edaa5fd19bab39 Mon Sep 17 00:00:00 2001
From: Lennart Poettering <lennart@poettering.net>
Date: Thu, 3 Jul 2014 20:37:10 +0200
Subject: [PATCH] man: document that systemctl's -H may now be used to connect
 directly to a container on a remote host

---
 man/user-system-options.xml | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/man/user-system-options.xml b/man/user-system-options.xml
index cca5c79a7..8616c5424 100644
--- a/man/user-system-options.xml
+++ b/man/user-system-options.xml
@@ -26,10 +26,15 @@
     <term><option>--host=</option></term>
 
     <listitem id='host-text'>
-      <para>Execute the operation remotely. Specify a hostname, or
+      <para>Execute the operation remotely. Specify a hostname, or a
       username and hostname separated by <literal>@</literal>, to
-      connect to. This will use SSH to talk to the remote machine
-      manager instance.</para>
+      connect to. The hostname may optionally be suffixed by a
+      container name, separated by <literal>:</literal>, which
+      connects directly to a specific container on the specified
+      host. This will use SSH to talk to the remote machine manager
+      instance. Container names may be enumerated with
+      <command>machinectl -H
+      <replaceable>HOST</replaceable></command>.</para>
     </listitem>
   </varlistentry>
 
-- 
2.30.2