Re: [PATCH 17/41] doc/build-platforms: document supported compilers

[Marc-André Lureau]

Hi

On Wed, Apr 20, 2022 at 6:10 PM Daniel P. Berrangé <berrange@redhat.com> wrote:
>
> On Wed, Apr 20, 2022 at 05:26:00PM +0400, marcandre.lureau@redhat.com wrote:
> > From: Marc-André Lureau <marcandre.lureau@redhat.com>
> >
> > According to our configure checks, this is the list of supported
> > compilers.
> >
> > Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
> > Reviewed-by: Damien Hedde <damien.hedde@greensocs.com>
> > ---
> >  docs/about/build-platforms.rst | 10 ++++++++++
> >  1 file changed, 10 insertions(+)
> >
> > diff --git a/docs/about/build-platforms.rst b/docs/about/build-platforms.rst
> > index c29a4b8fe649..1980c5d2476f 100644
> > --- a/docs/about/build-platforms.rst
> > +++ b/docs/about/build-platforms.rst
> > @@ -92,6 +92,16 @@ hosted on Linux (Debian/Fedora).
> >  The version of the Windows API that's currently targeted is Vista / Server
> >  2008.
> >
> > +Supported compilers
> > +-------------------
> > +
> > +To compile, QEMU requires either:
> > +
> > +- GCC >= 7.4.0
> > +- Clang >= 6.0
> > +- XCode Clang >= 10.0
>
> Do we need to spell out the versions explicitly ? These versions are
> all derived from what's available in the repos of the supported build
> platforms, similar to any other build deps we have. I don't think we
> want to start a precedent of duplicating versions in this doc for
> build deps we have, and there's nothing particularly special about
> compilers in this respect.

We have checks in configure for those, I wanted a more human-readable
and readily available version.

The set of supported platforms is not rigid, so imho it helps to
document the basic build requirements.

If/when we introduce Rust and/or C++ etc, I would also expect an
explicit doc section about it.

> With regards,
> Daniel
> --
> |: https://berrange.com      -o-    https://www.flickr.com/photos/dberrange :|
> |: https://libvirt.org         -o-            https://fstop138.berrange.com :|
> |: https://entangle-photo.org    -o-    https://www.instagram.com/dberrange :|
>