Re: [RFC] Move tools sources to the tools directory (was Re: [PATCH v2] MAINTAINERS: Fix the location of tools manuals)

[Daniel P . Berrangé]

On Thu, Feb 04, 2021 at 03:40:06PM +0100, Kevin Wolf wrote:
> Am 04.02.2021 um 15:31 hat Peter Maydell geschrieben:
> > On Thu, 4 Feb 2021 at 14:23, Wainer dos Santos Moschetta
> > <wainersm@redhat.com> wrote:
> > > Unrelated too, but allow me to ask:
> > >
> > > Should we move the tools (qemu-img, qemu-io, qemu-nbd...etc) to the
> > > tools directory (virtiofsd seems to feel alone there)?
> > 
> > I think that would be a good thing, yes (things documented in docs/tools
> > should have their source code in tools).
> 
> Maybe we should define then what a tool is. I think contrib/ has a few
> more things that could be considered tools.

The distinction of contrib/ vs tools/ is supposed to be more a
reflection on the quality of the program.

contrib/ should be considered demo-ware, no back compat guaranteed,
may or may not work, no testing guaranteed, no man pages.

tools/ should be for any program that we intend end users to actively
use in real world, with an expectation of quality and stable CLI and
man pages.


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 :|