From: Zbigniew Jędrzejewski-Szmek <zbyszek@amutable.com>
Date: Tue, 17 Feb 2026 14:41:24 +0000 (+0100)
Subject: NEWS,man: mark systemd-report as experimental
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c44446fe31a437cb391bb408ffac3d0b8c26beb0;p=thirdparty%2Fsystemd.git

NEWS,man: mark systemd-report as experimental

I expect that we'll need to make incompatible changes to
all of this, so let's mark things appropriately.
---

diff --git a/NEWS b/NEWS
index 3c94a8c7aee..d3d19896e01 100644
--- a/NEWS
+++ b/NEWS
@@ -77,6 +77,10 @@ CHANGES WITH 260 in spe:
           systemd-report is a new command line tool which collects the reports
           from all endpoints and prints them in JSON format.
 
+          The details of the structure of the reports should be considered
+          EXPERIMENTAL at this point. We reserve the right to make incompatible
+          changes to the JSON structure and/or place additional requirements.
+
         Changes in the system and user managers:
 
         * Systemd now uses ANSI CSI 18 sequence to query terminal size. This
diff --git a/man/systemd-report.xml b/man/systemd-report.xml
index c35993372ae..f786f0eb72c 100644
--- a/man/systemd-report.xml
+++ b/man/systemd-report.xml
@@ -30,6 +30,9 @@
   <refsect1>
     <title>Description</title>
 
+    <para><emphasis>Note: this command is experimental for now. While it is likely to become a regular
+    component of systemd, it might still change in behaviour and interface.</emphasis></para>
+
     <para><command>systemd-report</command> requests facts and metrics from the system and writes them to
     standard output.</para>
   </refsect1>