docs/about/removed-features: Replace 'since' -> 'removed in'

[PATCH-for-11.0] docs/about/removed-features: Replace 'since' -> 'removed in'

Posted by Philippe Mathieu-Daudé 1 week, 4 days ago

We use "deprecated since ..." and "removed in ...".
Replace "since" by "removed in" for removed features.

Fixes: 762c8554394 ("vfio: Remove 'vfio-platform'")
Fixes: aeb1a50d4a7 ("vfio: Remove 'vfio-amd-xgbe' device")
Fixes: e50a021a451 ("hw/arm: Remove ast2700a0-evb machine")
Fixes: 4af2433a81b ("docs: Mention 32-bit PPC host as removed")
Fixes: 8ebc416ac17 ("vfio: Remove 'vfio-calxeda-xgmac' device")
Fixes: a80151c9da1 ("hw/sd/sdcard: Remove support for spec v1.10")
Fixes: 269ffaabc84 ("buildsys: Remove support for 32-bit MIPS hosts")
Fixes: fc37c122fff ("migration: Drop deprecated QMP migrate argument @detach")
Signed-off-by: Philippe Mathieu-Daudé <philmd@linaro.org>
---
 docs/about/removed-features.rst | 32 ++++++++++++++++----------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/docs/about/removed-features.rst b/docs/about/removed-features.rst
index 557a24679a1..e75db084108 100644
--- a/docs/about/removed-features.rst
+++ b/docs/about/removed-features.rst
@@ -782,8 +782,8 @@ without reporting any destination threads, or non-multifd source
 threads).  For debugging purpose, please use ``-name
 $VM,debug-threads=on`` instead.
 
-``migrate`` argument ``detach`` (since 11.0)
-''''''''''''''''''''''''''''''''''''''''''''
+``migrate`` argument ``detach`` (removed in 11.0)
+''''''''''''''''''''''''''''''''''''''''''''''''''
 
 This argument has always been ignored.
 
@@ -932,14 +932,14 @@ work around the atomicity issues in system mode by running all vCPUs
 in a single thread context; in user mode atomicity was simply broken.
 From 10.0, QEMU has disabled configuration of 64-bit guests on 32-bit hosts.
 
-32-bit MIPS (since 10.2)
-''''''''''''''''''''''''
+32-bit MIPS (removed in 10.2)
+'''''''''''''''''''''''''''''
 
 Debian 12 "Bookworm" removed support for 32-bit MIPS, making it hard to
 maintain our cross-compilation CI tests of the architecture.
 
-32-bit PPC (since 10.2)
-'''''''''''''''''''''''
+32-bit PPC (removed in 10.2)
+''''''''''''''''''''''''''''
 
 The QEMU project no longer supports 32-bit host builds.
 
@@ -1172,8 +1172,8 @@ Mips ``mipssim`` machine (removed in 10.2)
 Linux dropped support for this virtual machine type in kernel v3.7, and
 there was also no binary available online to use with that board.
 
-Arm ``ast2700a0-evb`` machine (since 11.0)
-''''''''''''''''''''''''''''''''''''''''''
+Arm ``ast2700a0-evb`` machine (removed in 11.0)
+'''''''''''''''''''''''''''''''''''''''''''''''
 
 The ``ast2700a0-evb`` machine represents the first revision of the AST2700
 and serves as the initial engineering sample rather than a production version.
@@ -1290,8 +1290,8 @@ by using ``-machine graphics=off``.
 
 The 'pvrdma' device and the whole RDMA subsystem have been removed.
 
-``-device sd-card,spec_version=1`` (since 10.2)
-'''''''''''''''''''''''''''''''''''''''''''''''
+``-device sd-card,spec_version=1`` (removed in 10.2)
+''''''''''''''''''''''''''''''''''''''''''''''''''''
 
 SD physical layer specification v2.00 supersedes the v1.10 one.
 
@@ -1396,21 +1396,21 @@ device driver such as RBD.
 VFIO devices
 ------------
 
-``-device vfio-calxeda-xgmac`` (since 10.2)
-'''''''''''''''''''''''''''''''''''''''''''
+``-device vfio-calxeda-xgmac`` (removed in 10.2)
+''''''''''''''''''''''''''''''''''''''''''''''''
 The vfio-calxeda-xgmac device allows to assign a host Calxeda Highbank
 10Gb XGMAC Ethernet controller device ("calxeda,hb-xgmac" compatibility
 string) to a guest. Calxeda HW has been ewasted now and there is no point
 keeping that device.
 
-``-device vfio-amd-xgbe`` (since 10.2)
-''''''''''''''''''''''''''''''''''''''
+``-device vfio-amd-xgbe`` (removed in 10.2)
+'''''''''''''''''''''''''''''''''''''''''''
 The vfio-amd-xgbe device allows to assign a host AMD 10GbE controller
 to a guest ("amd,xgbe-seattle-v1a" compatibility string). AMD "Seattle"
 is not supported anymore and there is no point keeping that device.
 
-``-device vfio-platform`` (since 10.2)
-''''''''''''''''''''''''''''''''''''''
+``-device vfio-platform`` (removed in 10.2)
+'''''''''''''''''''''''''''''''''''''''''''
 The vfio-platform device allows to assign a host platform device
 to a guest in a generic manner. Integrating a new device into
 the vfio-platform infrastructure requires some adaptation at
-- 
2.53.0

Re: [PATCH-for-11.0] docs/about/removed-features: Replace 'since' -> 'removed in'

Posted by Pierrick Bouvier 1 week, 3 days ago

On 3/23/26 8:19 AM, Philippe Mathieu-Daudé wrote:
> We use "deprecated since ..." and "removed in ...".
> Replace "since" by "removed in" for removed features.
> 
> Fixes: 762c8554394 ("vfio: Remove 'vfio-platform'")
> Fixes: aeb1a50d4a7 ("vfio: Remove 'vfio-amd-xgbe' device")
> Fixes: e50a021a451 ("hw/arm: Remove ast2700a0-evb machine")
> Fixes: 4af2433a81b ("docs: Mention 32-bit PPC host as removed")
> Fixes: 8ebc416ac17 ("vfio: Remove 'vfio-calxeda-xgmac' device")
> Fixes: a80151c9da1 ("hw/sd/sdcard: Remove support for spec v1.10")
> Fixes: 269ffaabc84 ("buildsys: Remove support for 32-bit MIPS hosts")
> Fixes: fc37c122fff ("migration: Drop deprecated QMP migrate argument @detach")
> Signed-off-by: Philippe Mathieu-Daudé <philmd@linaro.org>
> ---
>   docs/about/removed-features.rst | 32 ++++++++++++++++----------------
>   1 file changed, 16 insertions(+), 16 deletions(-)
> 
> diff --git a/docs/about/removed-features.rst b/docs/about/removed-features.rst
> index 557a24679a1..e75db084108 100644
> --- a/docs/about/removed-features.rst
> +++ b/docs/about/removed-features.rst
> @@ -782,8 +782,8 @@ without reporting any destination threads, or non-multifd source
>   threads).  For debugging purpose, please use ``-name
>   $VM,debug-threads=on`` instead.
>   
> -``migrate`` argument ``detach`` (since 11.0)
> -''''''''''''''''''''''''''''''''''''''''''''
> +``migrate`` argument ``detach`` (removed in 11.0)
> +''''''''''''''''''''''''''''''''''''''''''''''''''
>   
>   This argument has always been ignored.
>   
> @@ -932,14 +932,14 @@ work around the atomicity issues in system mode by running all vCPUs
>   in a single thread context; in user mode atomicity was simply broken.
>   From 10.0, QEMU has disabled configuration of 64-bit guests on 32-bit hosts.
>   
> -32-bit MIPS (since 10.2)
> -''''''''''''''''''''''''
> +32-bit MIPS (removed in 10.2)
> +'''''''''''''''''''''''''''''
>   
>   Debian 12 "Bookworm" removed support for 32-bit MIPS, making it hard to
>   maintain our cross-compilation CI tests of the architecture.
>   
> -32-bit PPC (since 10.2)
> -'''''''''''''''''''''''
> +32-bit PPC (removed in 10.2)
> +''''''''''''''''''''''''''''
>   
>   The QEMU project no longer supports 32-bit host builds.
>   
> @@ -1172,8 +1172,8 @@ Mips ``mipssim`` machine (removed in 10.2)
>   Linux dropped support for this virtual machine type in kernel v3.7, and
>   there was also no binary available online to use with that board.
>   
> -Arm ``ast2700a0-evb`` machine (since 11.0)
> -''''''''''''''''''''''''''''''''''''''''''
> +Arm ``ast2700a0-evb`` machine (removed in 11.0)
> +'''''''''''''''''''''''''''''''''''''''''''''''
>   
>   The ``ast2700a0-evb`` machine represents the first revision of the AST2700
>   and serves as the initial engineering sample rather than a production version.
> @@ -1290,8 +1290,8 @@ by using ``-machine graphics=off``.
>   
>   The 'pvrdma' device and the whole RDMA subsystem have been removed.
>   
> -``-device sd-card,spec_version=1`` (since 10.2)
> -'''''''''''''''''''''''''''''''''''''''''''''''
> +``-device sd-card,spec_version=1`` (removed in 10.2)
> +''''''''''''''''''''''''''''''''''''''''''''''''''''
>   
>   SD physical layer specification v2.00 supersedes the v1.10 one.
>   
> @@ -1396,21 +1396,21 @@ device driver such as RBD.
>   VFIO devices
>   ------------
>   
> -``-device vfio-calxeda-xgmac`` (since 10.2)
> -'''''''''''''''''''''''''''''''''''''''''''
> +``-device vfio-calxeda-xgmac`` (removed in 10.2)
> +''''''''''''''''''''''''''''''''''''''''''''''''
>   The vfio-calxeda-xgmac device allows to assign a host Calxeda Highbank
>   10Gb XGMAC Ethernet controller device ("calxeda,hb-xgmac" compatibility
>   string) to a guest. Calxeda HW has been ewasted now and there is no point
>   keeping that device.
>   
> -``-device vfio-amd-xgbe`` (since 10.2)
> -''''''''''''''''''''''''''''''''''''''
> +``-device vfio-amd-xgbe`` (removed in 10.2)
> +'''''''''''''''''''''''''''''''''''''''''''
>   The vfio-amd-xgbe device allows to assign a host AMD 10GbE controller
>   to a guest ("amd,xgbe-seattle-v1a" compatibility string). AMD "Seattle"
>   is not supported anymore and there is no point keeping that device.
>   
> -``-device vfio-platform`` (since 10.2)
> -''''''''''''''''''''''''''''''''''''''
> +``-device vfio-platform`` (removed in 10.2)
> +'''''''''''''''''''''''''''''''''''''''''''
>   The vfio-platform device allows to assign a host platform device
>   to a guest in a generic manner. Integrating a new device into
>   the vfio-platform infrastructure requires some adaptation at

Reviewed-by: Pierrick Bouvier <pierrick.bouvier@linaro.org>

Good for me, do you want me to pull this patch, or you feel ok 
integrating in one of your series?

Regards,
Pierrick

Re: [PATCH-for-11.0] docs/about/removed-features: Replace 'since' -> 'removed in'

Posted by Peter Maydell 1 week, 4 days ago

On Mon, 23 Mar 2026 at 15:20, Philippe Mathieu-Daudé <philmd@linaro.org> wrote:
>
> We use "deprecated since ..." and "removed in ...".
> Replace "since" by "removed in" for removed features.
>
> Fixes: 762c8554394 ("vfio: Remove 'vfio-platform'")
> Fixes: aeb1a50d4a7 ("vfio: Remove 'vfio-amd-xgbe' device")
> Fixes: e50a021a451 ("hw/arm: Remove ast2700a0-evb machine")
> Fixes: 4af2433a81b ("docs: Mention 32-bit PPC host as removed")
> Fixes: 8ebc416ac17 ("vfio: Remove 'vfio-calxeda-xgmac' device")
> Fixes: a80151c9da1 ("hw/sd/sdcard: Remove support for spec v1.10")
> Fixes: 269ffaabc84 ("buildsys: Remove support for 32-bit MIPS hosts")
> Fixes: fc37c122fff ("migration: Drop deprecated QMP migrate argument @detach")
> Signed-off-by: Philippe Mathieu-Daudé <philmd@linaro.org>

I checked these commits to confirm that none of them were cases
where the "since X.Y" had just been moved over to removed.rst
without updating it from the "version we deprecated this in"
value to "version we actually removed it" value.

Reviewed-by: Peter Maydell <peter.maydell@linaro.org>

thanks
-- PMM

Re: [PATCH-for-11.0] docs/about/removed-features: Replace 'since' -> 'removed in'

Posted by Philippe Mathieu-Daudé 1 week, 4 days ago

On 23/3/26 17:30, Peter Maydell wrote:
> On Mon, 23 Mar 2026 at 15:20, Philippe Mathieu-Daudé <philmd@linaro.org> wrote:
>>
>> We use "deprecated since ..." and "removed in ...".
>> Replace "since" by "removed in" for removed features.
>>
>> Fixes: 762c8554394 ("vfio: Remove 'vfio-platform'")
>> Fixes: aeb1a50d4a7 ("vfio: Remove 'vfio-amd-xgbe' device")
>> Fixes: e50a021a451 ("hw/arm: Remove ast2700a0-evb machine")
>> Fixes: 4af2433a81b ("docs: Mention 32-bit PPC host as removed")
>> Fixes: 8ebc416ac17 ("vfio: Remove 'vfio-calxeda-xgmac' device")
>> Fixes: a80151c9da1 ("hw/sd/sdcard: Remove support for spec v1.10")
>> Fixes: 269ffaabc84 ("buildsys: Remove support for 32-bit MIPS hosts")
>> Fixes: fc37c122fff ("migration: Drop deprecated QMP migrate argument @detach")
>> Signed-off-by: Philippe Mathieu-Daudé <philmd@linaro.org>
> 
> I checked these commits to confirm that none of them were cases
> where the "since X.Y" had just been moved over to removed.rst
> without updating it from the "version we deprecated this in"
> value to "version we actually removed it" value.

Me too :D

> 
> Reviewed-by: Peter Maydell <peter.maydell@linaro.org>

Thanks!

Re: [PATCH-for-11.0] docs/about/removed-features: Replace 'since' -> 'removed in'

Posted by Cédric Le Goater 1 week, 4 days ago

On 3/23/26 16:19, Philippe Mathieu-Daudé wrote:
> We use "deprecated since ..." and "removed in ...".
> Replace "since" by "removed in" for removed features.
> 
> Fixes: 762c8554394 ("vfio: Remove 'vfio-platform'")
> Fixes: aeb1a50d4a7 ("vfio: Remove 'vfio-amd-xgbe' device")
> Fixes: e50a021a451 ("hw/arm: Remove ast2700a0-evb machine")
> Fixes: 4af2433a81b ("docs: Mention 32-bit PPC host as removed")
> Fixes: 8ebc416ac17 ("vfio: Remove 'vfio-calxeda-xgmac' device")
> Fixes: a80151c9da1 ("hw/sd/sdcard: Remove support for spec v1.10")
> Fixes: 269ffaabc84 ("buildsys: Remove support for 32-bit MIPS hosts")
> Fixes: fc37c122fff ("migration: Drop deprecated QMP migrate argument @detach")
> Signed-off-by: Philippe Mathieu-Daudé <philmd@linaro.org>
> ---
>   docs/about/removed-features.rst | 32 ++++++++++++++++----------------
>   1 file changed, 16 insertions(+), 16 deletions(-)
> 
> diff --git a/docs/about/removed-features.rst b/docs/about/removed-features.rst
> index 557a24679a1..e75db084108 100644
> --- a/docs/about/removed-features.rst
> +++ b/docs/about/removed-features.rst
> @@ -782,8 +782,8 @@ without reporting any destination threads, or non-multifd source
>   threads).  For debugging purpose, please use ``-name
>   $VM,debug-threads=on`` instead.
>   
> -``migrate`` argument ``detach`` (since 11.0)
> -''''''''''''''''''''''''''''''''''''''''''''
> +``migrate`` argument ``detach`` (removed in 11.0)
> +''''''''''''''''''''''''''''''''''''''''''''''''''
>   
>   This argument has always been ignored.
>   
> @@ -932,14 +932,14 @@ work around the atomicity issues in system mode by running all vCPUs
>   in a single thread context; in user mode atomicity was simply broken.
>   From 10.0, QEMU has disabled configuration of 64-bit guests on 32-bit hosts.
>   
> -32-bit MIPS (since 10.2)
> -''''''''''''''''''''''''
> +32-bit MIPS (removed in 10.2)
> +'''''''''''''''''''''''''''''
>   
>   Debian 12 "Bookworm" removed support for 32-bit MIPS, making it hard to
>   maintain our cross-compilation CI tests of the architecture.
>   
> -32-bit PPC (since 10.2)
> -'''''''''''''''''''''''
> +32-bit PPC (removed in 10.2)
> +''''''''''''''''''''''''''''
>   
>   The QEMU project no longer supports 32-bit host builds.
>   
> @@ -1172,8 +1172,8 @@ Mips ``mipssim`` machine (removed in 10.2)
>   Linux dropped support for this virtual machine type in kernel v3.7, and
>   there was also no binary available online to use with that board.
>   
> -Arm ``ast2700a0-evb`` machine (since 11.0)
> -''''''''''''''''''''''''''''''''''''''''''
> +Arm ``ast2700a0-evb`` machine (removed in 11.0)
> +'''''''''''''''''''''''''''''''''''''''''''''''
>   
>   The ``ast2700a0-evb`` machine represents the first revision of the AST2700
>   and serves as the initial engineering sample rather than a production version.
> @@ -1290,8 +1290,8 @@ by using ``-machine graphics=off``.
>   
>   The 'pvrdma' device and the whole RDMA subsystem have been removed.
>   
> -``-device sd-card,spec_version=1`` (since 10.2)
> -'''''''''''''''''''''''''''''''''''''''''''''''
> +``-device sd-card,spec_version=1`` (removed in 10.2)
> +''''''''''''''''''''''''''''''''''''''''''''''''''''
>   
>   SD physical layer specification v2.00 supersedes the v1.10 one.
>   
> @@ -1396,21 +1396,21 @@ device driver such as RBD.
>   VFIO devices
>   ------------
>   
> -``-device vfio-calxeda-xgmac`` (since 10.2)
> -'''''''''''''''''''''''''''''''''''''''''''
> +``-device vfio-calxeda-xgmac`` (removed in 10.2)
> +''''''''''''''''''''''''''''''''''''''''''''''''
>   The vfio-calxeda-xgmac device allows to assign a host Calxeda Highbank
>   10Gb XGMAC Ethernet controller device ("calxeda,hb-xgmac" compatibility
>   string) to a guest. Calxeda HW has been ewasted now and there is no point
>   keeping that device.
>   
> -``-device vfio-amd-xgbe`` (since 10.2)
> -''''''''''''''''''''''''''''''''''''''
> +``-device vfio-amd-xgbe`` (removed in 10.2)
> +'''''''''''''''''''''''''''''''''''''''''''
>   The vfio-amd-xgbe device allows to assign a host AMD 10GbE controller
>   to a guest ("amd,xgbe-seattle-v1a" compatibility string). AMD "Seattle"
>   is not supported anymore and there is no point keeping that device.
>   
> -``-device vfio-platform`` (since 10.2)
> -''''''''''''''''''''''''''''''''''''''
> +``-device vfio-platform`` (removed in 10.2)
> +'''''''''''''''''''''''''''''''''''''''''''
>   The vfio-platform device allows to assign a host platform device
>   to a guest in a generic manner. Integrating a new device into
>   the vfio-platform infrastructure requires some adaptation at

Reviewed-by: Cédric Le Goater <clg@redhat.com>

Thanks,

C.