Re: [PATCH] docs: attempt to document the general libvirt dev strategy

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Mon, Sep 23, 2019 at 11:10:53AM +0100, Daniel P. Berrangé wrote:
> 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@xxxxxxxxxx>
> > > ---
> > >  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.

Sounds good, everyone can check requirements on Meson website or git
repository.

Pavel

Attachment: signature.asc
Description: PGP signature

--
libvir-list mailing list
libvir-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/libvir-list

[Index of Archives]     [Virt Tools]     [Libvirt Users]     [Lib OS Info]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Big List of Linux Books]     [Yosemite News]     [KDE Users]     [Fedora Tools]

  Powered by Linux