Commit Graph
4 Commits
Author SHA1 Message Date
Zbigniew Jędrzejewski-Szmek 945e223a6c man: add a shared "experimental" blurb for features
(cherry picked from commit a6eb2b4d2e7f747bbfb0f5f3ebb1421855113d36)
2026-10-16 11:36:33 +01:00
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
Zbigniew Jędrzejewski-Szmek d81edcf73d 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)
2026-10-16 11:36:33 +01:00
Luca Boccassi 1637c093d3 man: add 'experimental feature' XML snippet 2026-08-26 15:02:55 +01:00