Files
systemd/man/experimental.xml
T
Zbigniew Jędrzejewski-Szmek bc97e77ba7 man: reword "experimental" blurbs to be more accurate
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)
2026-10-16 11:36:33 +01:00

27 lines
1.0 KiB
XML

<?xml version="1.0"?>
<!DOCTYPE refsect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<!--
SPDX-License-Identifier: LGPL-2.1-or-later
-->
<refsect1>
<title/>
<!-- 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 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 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>