Re: [PATCH] docs/system: Deprecate raspi2/raspi3 machine aliases

On Mon, 19 Oct 2020 at 09:23, Philippe Mathieu-Daudé <f4bug(a)amsat.org&gt; wrote: > > Since commit aa35ec2213b ("hw/arm/raspi: Use more > specific machine names") the raspi2/raspi3 machines > have been renamed as raspi2b/raspi3b. > > As more Raspberry Pi 2/3 models are emulated, in order > to avoid confusion deprecate the raspi2/raspi3 machine > aliases. > > Signed-off-by: Philippe Mathieu-Daudé <f4bug(a)amsat.org&gt; > --- > docs/system/deprecated.rst | 5 +++++ > 1 file changed, 5 insertions(+) > > diff --git a/docs/system/deprecated.rst b/docs/system/deprecated.rst > index 905628f3a0c..f0c7aaeb2ff 100644 > --- a/docs/system/deprecated.rst > +++ b/docs/system/deprecated.rst > @@ -355,6 +355,11 @@ This machine has been renamed ``fuloong2e``. > These machine types are very old and likely can not be used for live migration > from old QEMU versions anymore. A newer machine type should be used instead. > > +Raspberry Pi ``raspi2`` and ``raspi3`` machines (since 5.2) > +''''''''''''''''''''''''''''''''''''' > + > +These machines have been respectively renamed ``raspi2b`` and ``raspi3b``. > + This isn't valid rST syntax, which requires the underlining to be exactly the same length as the title string it underlines: Warning, treated as error: /home/petmay01/linaro/qemu-from-laptop/qemu/docs/system/deprecated.rst:348:Title underline too short. Raspberry Pi ``raspi2`` and ``raspi3`` machines (since 5.2) ''''''''''''''''''''''''''''''''''''' I also think it would be helpful to have at least a sentence saying why we've renamed the machines.