dilim/systemd
1
0 Fork 0
mirror of https://github.com/systemd/systemd.git synced 2026-11-06 05:17:24 +00:00
Code Issues 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.
This commit is contained in:
Zbigniew Jędrzejewski-Szmek committed 2026-10-05 10:47:01 +02:00
1 parent 69dd30fddf
commit 96cb6a5c74
1 file changed
+10 -7
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>