| Message ID | 20250225200423.2350471-4-berrange@redhat.com (mailing list archive) |
|---|---|
| State | New |
| Headers | show |
| Series | docs: automated info about machine deprecation/removal info | expand |
On 25/02/2025 21.04, Daniel P. Berrangé wrote: > We remove versioned machine types on a fixed schedule. This allows us > to auto-generate a paragraph in the removed-features.rst document that > always has accurate version info. > > Signed-off-by: Daniel P. Berrangé <berrange@redhat.com> > --- > docs/about/removed-features.rst | 10 ++++++---- > docs/conf.py | 2 ++ > 2 files changed, 8 insertions(+), 4 deletions(-) > > diff --git a/docs/about/removed-features.rst b/docs/about/removed-features.rst > index 156c0c253c..c120d9ff4f 100644 > --- a/docs/about/removed-features.rst > +++ b/docs/about/removed-features.rst > @@ -972,10 +972,12 @@ from Linux in 2021, and is not supported anymore by QEMU either. > System emulator machines > ------------------------ > > -Note: Versioned machine types that have been introduced in a QEMU version > -that has initially been released more than 6 years before are considered > -obsolete and will be removed without further notice in this document. > -Please use newer machine types instead. > +Versioned machine types (aarch64, arm, i386, m68k, ppc, ppc64, s390x, x86_64) > +''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' > + > +In accordance with our versioned machine type deprecation policy, all machine > +types with version |VER_MACHINE_DELETION_VERSION|, or older, have been > +removed. > > ``s390-virtio`` (removed in 2.6) > '''''''''''''''''''''''''''''''' > diff --git a/docs/conf.py b/docs/conf.py > index 421ece1024..8b567787ce 100644 > --- a/docs/conf.py > +++ b/docs/conf.py > @@ -130,6 +130,7 @@ > minor += 1 > > ver_machine_deprecation_version = "%d.%d.%d" % (major - 3, minor, micro) > +ver_machine_deletion_version = "%d.%d.%d" % (major - 6, minor, micro) As in the previous patch, I think micro=0 would be better here. Thomas
diff --git a/docs/about/removed-features.rst b/docs/about/removed-features.rst index 156c0c253c..c120d9ff4f 100644 --- a/docs/about/removed-features.rst +++ b/docs/about/removed-features.rst @@ -972,10 +972,12 @@ from Linux in 2021, and is not supported anymore by QEMU either. System emulator machines ------------------------ -Note: Versioned machine types that have been introduced in a QEMU version -that has initially been released more than 6 years before are considered -obsolete and will be removed without further notice in this document. -Please use newer machine types instead. +Versioned machine types (aarch64, arm, i386, m68k, ppc, ppc64, s390x, x86_64) +''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' + +In accordance with our versioned machine type deprecation policy, all machine +types with version |VER_MACHINE_DELETION_VERSION|, or older, have been +removed. ``s390-virtio`` (removed in 2.6) '''''''''''''''''''''''''''''''' diff --git a/docs/conf.py b/docs/conf.py index 421ece1024..8b567787ce 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -130,6 +130,7 @@ minor += 1 ver_machine_deprecation_version = "%d.%d.%d" % (major - 3, minor, micro) +ver_machine_deletion_version = "%d.%d.%d" % (major - 6, minor, micro) # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. @@ -163,6 +164,7 @@ vars = { "CONFDIR": confdir, "VER_MACHINE_DEPRECATION_VERSION": ver_machine_deprecation_version, + "VER_MACHINE_DELETION_VERSION": ver_machine_deletion_version, } rst_epilog = "".join([
We remove versioned machine types on a fixed schedule. This allows us to auto-generate a paragraph in the removed-features.rst document that always has accurate version info. Signed-off-by: Daniel P. Berrangé <berrange@redhat.com> --- docs/about/removed-features.rst | 10 ++++++---- docs/conf.py | 2 ++ 2 files changed, 8 insertions(+), 4 deletions(-)