Re: [PATCH 12/12] docs: add information on how to setup build environments

[Pierrick Bouvier]

On 11/4/24 08:08, Michael S. Tsirkin wrote:
> On Mon, Nov 04, 2024 at 03:58:19PM +0000, Peter Maydell wrote:
> > On Thu, 31 Oct 2024 at 04:07, Pierrick Bouvier
> > <pierrick.bouvier@linaro.org> wrote:
> > > MacOS and Linux are straightforward, but Windows needs a bit more
> > > details.
> > >
> > > Signed-off-by: Pierrick Bouvier <pierrick.bouvier@linaro.org>
> >
> > We have documentation on the wiki currently about how to
> > build on various platforms:
> >
> > https://wiki.qemu.org/Hosts/Linux
> > https://wiki.qemu.org/Hosts/Mac
> > https://wiki.qemu.org/Hosts/W32
> >
> > I agree that we ought to move this into the main documentation.
> > Some of the information in those wiki pages is probably
> > out of date, but some of it looks like useful extra detail
> > that we could incorporate here.
>
> Also, as that wiki notes:
>
> 32 bit Linux target on a 64 bit Linux host would be useful for build bots

IMHO, and regarding my previous message, I don't think adding details 
about cross compilation would help new comers.
Cross compilation is specific, and most of the people who do it know how 
to do it. Especially when setting up a build bot.
In more, we already have a docker container for this use case 
(debian-i686-cross), without needing to play with host machine.

> > > ---
> > >   docs/about/build-platforms.rst |   4 +-
> > >   docs/devel/build-system.rst    | 100 +++++++++++++++++++++++++++++++++
> >
> > I don't think this is the best place to put this information.
> > "How do I build from source?" is a question that most beginning
> > developers and some end users will have. The information in
> > build-system.rst is mostly about the internals of our
> > build system and how to modify it, which is a more niche topic.
> >
> > I would be inclined to put this in a new file, maybe even
> > in docs/about/ rather than docs/devel.
> >
> > thanks
> > -- PMM