On Fri, 18 Jan 2019 09:35:05 -0300
Felipe Sateler <fsate...@debian.org> wrote:
> /var/run is a compatibility symlink to /run. This paragraph should
> reference /run directly.
Fixed in attached patch: reboot_required_v3.patch
Regards,
Karl <k...@meme.com>
Free Software: "You don't pay back, you pay forward."
-- Robert A. Heinlein
diff --git a/policy/ch-maintainerscripts.rst b/policy/ch-maintainerscripts.rst
index 707f2d4..fe39c56 100644
--- a/policy/ch-maintainerscripts.rst
+++ b/policy/ch-maintainerscripts.rst
@@ -92,6 +92,31 @@ for failure, since the package management system looks for the exit
status of these scripts and determines what action to take next based on
that datum.
+.. index::
+ pair: signaling; reboot
+
+.. _s-signalingreboot
+
+Signaling that a reboot is required
+-----------------------------------
+
+.. index::
+ single: reboot-required
+ single: reboot-required.pkgs
+
+Maintainer scripts can signal that a reboot is required to fully apply
+the changes to the system by touching ``/run/reboot-required`` and
+adding the package name to ``/run/reboot-required.pkgs``. Maintainer
+scripts should not add the package name to
+``/run/reboot-required.pkgs`` if it is already present there.
+
+The appropriate place to do this is expected to be when the
+``postinst`` script is called as ``postinst configure
+most-recently-configured-version``.
+
+Ordinary programs may manipulate these files to signal that a reboot
+is required.
+
.. _s-mscriptsinstact:
Summary of ways maintainer scripts are called
