From 3fbd5f2007983a221468432db51d85165dfdac62 Mon Sep 17 00:00:00 2001
From: Luca Boccassi <bluca@debian.org>
Date: Wed, 9 Feb 2022 11:58:30 +0000
Subject: [PATCH] NEWS: note backward-incompatible MONITOR_METADATA change

---
 NEWS | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/NEWS b/NEWS
index 95ffc555a27..d0714157c55 100644
--- a/NEWS
+++ b/NEWS
@@ -17,6 +17,14 @@ CHANGES WITH 251:
           for breaking backward compatibility instead, as nobody should be
           affected, given the state of the current interface.
 
+        * Service monitor environment variables will only be passed to OnFailure=/OnSuccess=
+          handlers if exactly one unit lists the handler unit as OnFailure=/OnSuccess=.
+          Therefore, $MONITOR_METADATA is no longer used, and instead separate
+          variables are used: $MONITOR_SERVICE_RESULT, $MONITOR_EXIT_CODE,
+          $MONITOR_EXIT_STATUS, $MONITOR_INVOCATION_ID and $MONITOR_UNIT.
+          For cases when a single handler needs to watch multiple units, use a
+          templated handler.
+
         * Services with Restart=always and a failing ExecCondition= will no longer
           be restarted, to bring ExecCondition= in line with Condition*= settings.