From fcaf7cff449863eefde42b3d8b71c1dda780a88a Mon Sep 17 00:00:00 2001
From: Laurent Bercot <ska-skaware@skarnet.org>
Date: Sun, 18 Jan 2026 05:36:49 +0000
Subject:  Add some explanation of masking

---
 doc/s6_set.html | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

(limited to 'doc/s6_set.html')

diff --git a/doc/s6_set.html b/doc/s6_set.html
index fd20775..08857d7 100644
--- a/doc/s6_set.html
+++ b/doc/s6_set.html
@@ -188,7 +188,11 @@ default. </dd>
 thing: they move the services listed in <em>services...</em> from their
 current subs to another.
   <ul>
-   <li> <tt>mask</tt> masks the services. </li>
+   <li> <tt>mask</tt> masks the services. Masking means that the service will not appear in the live
+service database <em>at all</em>, it will not be listed, it will not be usable until it is unmasked in
+a new working set that is subsequently committed and installed. Masking is useful when the stores
+provide services that come from random installed packages, and the user never wants to run these
+services and it's just better not to see them. </li>
    <li> <tt>unmask</tt> and <tt>disable</tt> put the services in the <tt>usable</tt> sub, i.e. unmasked and disabled. </li>
    <li> <tt>enable</tt> enables the services. </li>
    <li> <tt>make-essential</tt> enables the services and marks them as essential. This command should normally not
-- 
cgit v1.3.1