From: Luca Boccassi <bluca@debian.org>
Date: Wed, 17 Jan 2024 17:00:35 +0000 (+0000)
Subject: man: explicitly say that portable1's Attach/Detach are synchronous
X-Git-Tag: v256-rc1~1111^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=803bcc434f2bcd2c76f6d098277ebc61438c7b43;p=thirdparty%2Fsystemd.git

man: explicitly say that portable1's Attach/Detach are synchronous
---

diff --git a/man/org.freedesktop.portable1.xml b/man/org.freedesktop.portable1.xml
index f3c5597442a..e0070d33b6e 100644
--- a/man/org.freedesktop.portable1.xml
+++ b/man/org.freedesktop.portable1.xml
@@ -249,7 +249,8 @@ node /org/freedesktop/portable1 {
         <listitem><para>mkdir</para></listitem>
       </itemizedlist>
       Note that an image cannot be attached if a unit that it contains is already present
-      on the system.</para>
+      on the system. Note that this method returns only after all the listed operations are completed,
+      and due to the I/O involved it might take some time.</para>
 
       <para><function>AttachImageWithExtensions()</function> attaches a portable image to the system.
       This method is a superset of <function>AttachImage()</function> with the addition of
@@ -271,7 +272,9 @@ node /org/freedesktop/portable1 {
       <itemizedlist>
         <listitem><para>unlink</para></listitem>
       </itemizedlist>
-      Note that an image cannot be detached if a unit that it contains is running.</para>
+      Note that an image cannot be detached if a unit that it contains is running. Note that this method
+      returns only after all the listed operations are completed, and due to the I/O involved it might take
+      some time.</para>
 
       <para><function>DetachImageWithExtensions()</function> detaches a portable image from the system.
       This method is a superset of <function>DetachImage()</function> with the addition of