[libvirt] [PATCH] docs: attempt to document the general libvirt dev strategy
Daniel P. Berrangé
berrange at redhat.com
Mon Sep 23 10:10:53 UTC 2019
On Fri, Sep 20, 2019 at 07:33:08PM +0200, Pavel Hrdina wrote:
> On Fri, Sep 20, 2019 at 03:12:01PM +0100, Daniel P. Berrangé wrote:
> > There are various ideas / plans floating around for future libvirt work,
> > some of which is actively in progress. Historically we've never captured
> > this kind of information anywhere, except in mailing list discussions.
> > In particular guidelines in hacking.html.in don't appear until a policy
> > is actively applied.
> >
> > This patch attempts to fill the documentation gap, by creating a new
> > "strategy" page which outlines the general vision for some notable
> > future changes. The key thing to note is that none of the stuff on this
> > page is guaranteed, plans may change as new information arises. IOW this
> > is a "best guess" as to the desired future.
> >
> > This doc has focused on three areas, related to the topic of language
> > usage / consolidation
> >
> > - Use of non-C languages for the library, daemons or helper tools
> > - Replacement of autotools with meson
> > - Use of RST and Sphinx for documentation (website + man pages)
> >
> > Signed-off-by: Daniel P. Berrangé <berrange at redhat.com>
> > ---
> > docs/docs.html.in | 3 +
> > docs/strategy.html.in | 143 ++++++++++++++++++++++++++++++++++++++++++
> > 2 files changed, 146 insertions(+)
> > create mode 100644 docs/strategy.html.in
>
> [...]
>
> > + <p>
> > + The meson build system is written in Python, at time of writing,
> > + requiring version 3.4 or later. This directly informs the choice to use
> > + Python 3.4 as the language for all supporting build scripts, re-inforcing
> > + the other benefits of Python, over Perl, Shell, M4, automake, etc.
> > + </p>
>
> In addition to all comments, Meson since version 0.45.0 requires
> Python 3.5 and we will most likely use at least 0.49.0.
Perhaps I'll just say Python 3, otherwise we'll be chasing ever changing
minor versions in this doc.
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 :|
More information about the libvir-list
mailing list