[PATCH for-9.2 36/53] docs: Document removal of old Arm boards

Peter Maydell posted 53 patches 2 months, 3 weeks ago
[PATCH for-9.2 36/53] docs: Document removal of old Arm boards
Posted by Peter Maydell 2 months, 3 weeks ago
Now we have removed all the board types that it covers, we can move
the text about old Arm boards from deprecated.rst to
removed-features.rst, tweaking it appropriately.

Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
---
 docs/about/deprecated.rst       | 15 ---------------
 docs/about/removed-features.rst | 15 +++++++++++++++
 2 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/docs/about/deprecated.rst b/docs/about/deprecated.rst
index 88f0f037865..bb04daa52b3 100644
--- a/docs/about/deprecated.rst
+++ b/docs/about/deprecated.rst
@@ -246,21 +246,6 @@ to correct issues, mostly regarding migration compatibility. These are
 no longer maintained and removing them will make the code easier to
 read and maintain. Use versions 3.0 and above as a replacement.
 
-Arm machines ``akita``, ``borzoi``, ``cheetah``, ``connex``, ``mainstone``, ``n800``, ``n810``, ``spitz``, ``terrier``, ``tosa``, ``verdex``, ``z2`` (since 9.0)
-''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
-
-QEMU includes models of some machine types where the QEMU code that
-emulates their SoCs is very old and unmaintained. This code is now
-blocking our ability to move forward with various changes across
-the codebase, and over many years nobody has been interested in
-trying to modernise it. We don't expect any of these machines to have
-a large number of users, because they're all modelling hardware that
-has now passed away into history. We are therefore dropping support
-for all machine types using the PXA2xx and OMAP2 SoCs. We are also
-dropping the ``cheetah`` OMAP1 board, because we don't have any
-test images for it and don't know of anybody who does; the ``sx1``
-and ``sx1-v1`` OMAP1 machines remain supported for now.
-
 PPC 405 ``ref405ep`` machine (since 9.1)
 ''''''''''''''''''''''''''''''''''''''''
 
diff --git a/docs/about/removed-features.rst b/docs/about/removed-features.rst
index fc7b28e6373..815d63f5941 100644
--- a/docs/about/removed-features.rst
+++ b/docs/about/removed-features.rst
@@ -978,6 +978,21 @@ Nios II ``10m50-ghrd`` and ``nios2-generic-nommu`` machines (removed in 9.1)
 
 The Nios II architecture was orphan.
 
+Arm machines ``akita``, ``borzoi``, ``cheetah``, ``connex``, ``mainstone``, ``n800``, ``n810``, ``spitz``, ``terrier``, ``tosa``, ``verdex``, ``z2`` (removed in 9.2)
+'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+
+QEMU included models of some machine types where the QEMU code that
+emulates their SoCs was very old and unmaintained. This code was
+blocking our ability to move forward with various changes across
+the codebase, and over many years nobody has been interested in
+trying to modernise it. We don't expect any of these machines to have
+a large number of users, because they're all modelling hardware that
+has now passed away into history. We are therefore dropping support
+for all machine types using the PXA2xx and OMAP2 SoCs. We are also
+dropping the ``cheetah`` OMAP1 board, because we don't have any
+test images for it and don't know of anybody who does; the ``sx1``
+and ``sx1-v1`` OMAP1 machines remain supported for now.
+
 linux-user mode CPUs
 --------------------
 
-- 
2.34.1
Re: [PATCH for-9.2 36/53] docs: Document removal of old Arm boards
Posted by Philippe Mathieu-Daudé 2 months, 3 weeks ago
On 3/9/24 18:07, Peter Maydell wrote:
> Now we have removed all the board types that it covers, we can move
> the text about old Arm boards from deprecated.rst to
> removed-features.rst, tweaking it appropriately.
> 
> Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
> ---
>   docs/about/deprecated.rst       | 15 ---------------
>   docs/about/removed-features.rst | 15 +++++++++++++++
>   2 files changed, 15 insertions(+), 15 deletions(-)


> diff --git a/docs/about/removed-features.rst b/docs/about/removed-features.rst
> index fc7b28e6373..815d63f5941 100644
> --- a/docs/about/removed-features.rst
> +++ b/docs/about/removed-features.rst
> @@ -978,6 +978,21 @@ Nios II ``10m50-ghrd`` and ``nios2-generic-nommu`` machines (removed in 9.1)
>   
>   The Nios II architecture was orphan.
>   
> +Arm machines ``akita``, ``borzoi``, ``cheetah``, ``connex``, ``mainstone``, ``n800``, ``n810``, ``spitz``, ``terrier``, ``tosa``, ``verdex``, ``z2`` (removed in 9.2)
> +'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
> +
> +QEMU included models of some machine types where the QEMU code that
> +emulates their SoCs was very old and unmaintained. This code was
> +blocking our ability to move forward with various changes across
> +the codebase, and over many years nobody has been interested in
> +trying to modernise it. We don't expect any of these machines to have

Note, sx1 also contains "code blocking our ability to move forward
with various changes across the codebase".

> +a large number of users, because they're all modelling hardware that
> +has now passed away into history. We are therefore dropping support
> +for all machine types using the PXA2xx and OMAP2 SoCs. We are also
> +dropping the ``cheetah`` OMAP1 board, because we don't have any
> +test images for it and don't know of anybody who does; the ``sx1``
> +and ``sx1-v1`` OMAP1 machines remain supported for now.

I'd remove the "the ``sx1`` and ``sx1-v1`` OMAP1 machines remain 
supported for now." part which doesn't seem so relevant in the
removed-features.rst file.

Otherwise,
Reviewed-by: Philippe Mathieu-Daudé <philmd@linaro.org>