From 9c69cc8af6bc8c54b42313a30c92c27fda5de318 Mon Sep 17 00:00:00 2001
From: Laurent Bercot <ska-skaware@skarnet.org>
Date: Wed, 11 Jan 2023 12:58:45 +0000
Subject:  Mention -D/-U edge case in s6-supervise doc

Signed-off-by: Laurent Bercot <ska@appnovation.com>
---
 doc/s6-supervise.html | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/s6-supervise.html b/doc/s6-supervise.html
index 943a347..fde1da7 100644
--- a/doc/s6-supervise.html
+++ b/doc/s6-supervise.html
@@ -211,6 +211,12 @@ service. </li>
 subdirectory of <em>servicedir</em>. <em>servicedir</em> itself can be read-only,
 but both <em>servicedir</em><tt>/supervise</tt> and <em>servicedir</em><tt>/event</tt>
 need to be read-write. </li>
+ <li> If <em>servicedir</em> is read-only, then the <a href="s6-svc.html">s6-svc</a>
+<tt>-D</tt> and <tt>-U</tt> commands will not work properly since s6-supervise will
+be unable to create or delete a <em>servicedir<em><tt>/down</tt> file; in this case
+s6-supervise will print a warning on stderr, and perform the equivalent of <tt>-d</tt>
+and <tt>-u</tt> instead, but will be unable to change the permanent service
+configuration. </li>
 </ul>
 
 <h2> Implementation notes </h2>
-- 
cgit v1.2.3