Re: [PATCH] docs/system/ppc: Document running Linux on AmigaNG machines

[BALATON Zoltan]

On Fri, 16 Feb 2024, Thomas Huth wrote:
> On 16/02/2024 01.10, BALATON Zoltan wrote:
> > Documentation on how to run Linux on the amigaone, pegasos2 and
> > sam460ex machines is currently burried in the depths of the qemu-devel
>
> s/burried/buried/
>
> > mailing list and in the source code. Let's collect the information in
> > the QEMU handbook for a one stop solution.
> >
> > Co-authored-by: Bernhard Beschow <shentey@gmail.com>
> > Signed-off-by: BALATON Zoltan <balaton@eik.bme.hu>
> > ---
> > Supersedes: <20231216123013.67978-1-shentey@gmail.com>
> >
> >   MAINTAINERS                 |   1 +
> >   docs/system/ppc/amigang.rst | 160 ++++++++++++++++++++++++++++++++++++
> >   docs/system/target-ppc.rst  |   1 +
> >   3 files changed, 162 insertions(+)
> >   create mode 100644 docs/system/ppc/amigang.rst
> >
> > diff --git a/MAINTAINERS b/MAINTAINERS
> > index a24c2b51b6..8e5b47e7b4 100644
> > --- a/MAINTAINERS
> > +++ b/MAINTAINERS
> > @@ -1560,6 +1560,7 @@ F: hw/rtc/m41t80.c
> >   F: pc-bios/canyonlands.dt[sb]
> >   F: pc-bios/u-boot-sam460ex-20100605.bin
> >   F: roms/u-boot-sam460ex
> > +F: docs/system/ppc/amigang.rst
> >     pegasos2
> >   M: BALATON Zoltan <balaton@eik.bme.hu>
> > diff --git a/docs/system/ppc/amigang.rst b/docs/system/ppc/amigang.rst
> > new file mode 100644
> > index 0000000000..c03a7e0d66
> > --- /dev/null
> > +++ b/docs/system/ppc/amigang.rst
> > @@ -0,0 +1,160 @@
> > +AmigaNG boards (``amigaone``, ``pegasos2``, ``sam460ex``)
> > +=========================================================
> > +
> > +These PowerPC machines emulate boards that are primarily used for
> > +running Amiga like OSes (AmigaOS 4, MorphOS and AROS) but these can
> > +also run Linux which is what this section documents.
> > +
> > +Eyetech AmigaOne/Mai Logic Teron (``amigaone``)
> > +===============================================
>
> Wouldn't it be better to use a subsection here (i.e. "----" instead of 
> "====") ? And also adjust the subsections below to subsubsections?

Inspired by the pseries.rst I've instead elevated to top level title one 
level up so it should then get sorted correctly in TOC to the same effect 
as your suggestion here. Sent a v2 with that. Thanks.

Regards,
BALATON Zoltan