SymbX/systemd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

man: reword "experimental" blurbs to be more accurate

Browse Source 
The text implied that the changes may happen randomly at any time.
Obviously, they can only happen after an update, but also we're unlikely
to do that not on a major release boundary. So town down that part of the
message. At the same time, it's important that the change might just
happen. For stable features, we also sometimes implement incompatible
changes, but this is preceded by announcements and lengthy deprecation
periods. So use the phrase "without advance notice".

OTOH, the text implicitly promised future stabilization. This might or
might not happen, so remind the users that it might not.

(cherry picked from commit 96cb6a5c74c8cd64334c48ddcca18e128e9a40ea)
This commit is contained in:
Zbigniew Jędrzejewski-Szmek
2026-10-16 11:36:33 +01:00
committed by Luca Boccassi
parent d81edcf73d
commit bc97e77ba7
1 changed files with 10 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
man/experimental.xml
+10 -7
View File
@@ -8,16 +8,19 @@
<refsect1>
<title/>
<!-- for individual section(s) of a manpage -->
<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>
<!-- for individual sections of a manpage -->
<para id="option">This option is experimental and subject to change without advance notice.
It will be stabilized and given a backward-compatibility guarantee in a future release,
but may also possibly be removed.</para>
<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>
<para id="options">These options are experimental and subject to change without advance notice.
They will be stabilized and given a backward-compatibility guarantee in a future release,
but may also possibly be removed.</para>
<!-- for a whole manpage -->
<refsect1 id="component"><title>Experimental</title>
<para>This component 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>This component is experimental and subject to change without advance notice.
It will be stabilized and given a backward-compatibility guarantee in a future release,
but may also possibly be removed.</para>
</refsect1>
</refsect1>