From 260f39b690cfea12532b988a98320ca99c55f429 Mon Sep 17 00:00:00 2001
From: Julian Andres Klode <jak@debian.org>
Date: Thu, 5 Mar 2026 07:14:06 +0000
Subject: Document inhibitors (see Bug#112933)

---
 doc/apt.conf.5.xml | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

(limited to 'doc/apt.conf.5.xml')

diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml
index fb7a1b030..261c5e919 100644
--- a/doc/apt.conf.5.xml
+++ b/doc/apt.conf.5.xml
@@ -942,6 +942,22 @@ APT::Compressor::rev {
    </variablelist>
  </refsect1>
 
+ <refsect1><title>Systemd inhibitors</title>
+   <para>APT will communicate with systemd to inhibit conflicting system operations while running &dpkg;, to
+   avoid systems ending up with partial upgrades and broken packages.</para>
+
+   <variablelist>
+     <varlistentry><term><option>DPkg::Inhibit-Shutdown</option></term>
+         <listitem><para>This boolean option, set by default, causes apt to inhbit shutdown</para></listitem>
+     </varlistentry>
+     <varlistentry><term><option>DPkg::Inhibit-Sleep</option></term>
+         <listitem><para>This boolean option, set by default, causes apt to inhbit sleep</para></listitem>
+     </varlistentry>
+   </variablelist>
+
+   <para>See <ulink url="https://systemd.io/INHIBITOR_LOCKS/" /> for further information.</para>
+ </refsect1>
+
  <refsect1>
    <title>Periodic and Archives options</title>
    <para><literal>APT::Periodic</literal> and <literal>APT::Archives</literal>
-- 
cgit v1.2.3-70-g09d2