From d81edcf73dff76022312879614c7ced22b497770 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= Date: Mon, 5 Oct 2026 10:25:58 +0200 Subject: [PATCH] man: reuse the shared "experimental" blurbs The blurbs were added to be shared, but no sharing was actually done. Also, rename "singular"/"plural" to "option"/"options", so that we can later have "component"/"components" and possibly other variants. The text were a bit different in various places, but I don't think it was a useful distinction. (cherry picked from commit 69dd30fddf2bbf358e05a632b0ef3383eb46b028) --- man/experimental.xml | 4 ++-- man/systemd-measure.xml | 5 ++--- man/systemd-pcrlock.xml | 5 ++--- man/systemd-report.xml | 5 ++--- 4 files changed, 8 insertions(+), 11 deletions(-) diff --git a/man/experimental.xml b/man/experimental.xml index b2f412f6ca..0c3db27971 100644 --- a/man/experimental.xml +++ b/man/experimental.xml @@ -9,10 +9,10 @@ <!-- for individual section(s) of a manpage --> - <para id="singular">This option is experimental and subject to change at any given moment without notice. + <para id="option">This option is experimental and subject to change at any given moment without notice. It will be stabilized and given a backward-compatibility guarantee in a future release.</para> - <para id="plural">These options are experimental and subject to change at any given moment without notice. + <para id="options">These options are experimental and subject to change at any given moment without notice. They will be stabilized and given a backward-compatibility guarantee in a future release.</para> <!-- for a whole manpage --> diff --git a/man/systemd-measure.xml b/man/systemd-measure.xml index d5a2f4120a..a014571aee 100644 --- a/man/systemd-measure.xml +++ b/man/systemd-measure.xml @@ -26,12 +26,11 @@ </cmdsynopsis> </refsynopsisdiv> + <xi:include href="experimental.xml" xpointer="component" /> + <refsect1> <title>Description - 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. - systemd-measure is a tool that may be used to pre-calculate and sign the expected TPM2 PCR 11 values that should be seen when a Linux UAPI.5 Unified Kernel Image diff --git a/man/systemd-pcrlock.xml b/man/systemd-pcrlock.xml index dbb59f2e12..5825949d0e 100644 --- a/man/systemd-pcrlock.xml +++ b/man/systemd-pcrlock.xml @@ -34,12 +34,11 @@ + + Description - 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. - systemd-pcrlock is a tool that may be used to analyze and predict TPM2 PCR measurements, and generate TPM2 access policies from the prediction which it stores in a TPM2 NV index (i.e. in the TPM2 non-volatile memory). This may then be used to restrict access to TPM2 objects (such as diff --git a/man/systemd-report.xml b/man/systemd-report.xml index f3d21526ef..baafbb4104 100644 --- a/man/systemd-report.xml +++ b/man/systemd-report.xml @@ -30,12 +30,11 @@ + + Description - 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. - systemd-report requests metrics from the system and writes them to standard output.