> 
> If qemu-system-gui package is already installed you can just look at the l
> in it, - the list gives a good hint.  It should, - I hope anyway - be 
> enough to read the
> description already.  At the very least, almost no one looks at READMEs 
> inside packages,
> but some do look at the descriptions, especially before installing something. 
>  Maybe
> the description should be improved a bit.

Okay... it sounds like we're approaching agreement here.  I _did_ read the 
package description of qemu-system-gui (before creating this bug) and I'm still 
not clear what the package is for, or whether I should install it.

I have a suspicion that this is an important (for qemu) package, but I'm 
unclear about how/why.

I created this bug to say in essence that I think the documentation of this 
package needs to be improved.  I don't have my heart set on README.Debian as 
the means of doing it.  I would be happy with an improved package description.

I would be willing to submit a patch, if/when I understand the package enough 
that I could compose such documentation.

> Let's use another example. qemu-system-arm recommends (or suggests, don't 
> but let's assume it is Recommends) samba.  The reason is that qemu can us
> mode to share a directory on the host to the guest system it is running.  
> samba should carry a README explaining how it is used with qemu-system-arm

To follow this example-- I think samba should contain documentation explaining 
its primary purpose.  I suspect it does.  If there was a package called 
something like qemu-system-samba, I would expect that its primary purpose would 
be something directly related to qemu, and I would hope its documentation would 
explain how to use it with qemu.

> Your question comes from the lack of understanding what qemu itself is 
> and how to use it.

That's for sure!  I've never used qemu before.  I've used virtualbox and VMWare 
in the past.

> (and this is obvious from the list of files in the package).

I've had a lot of people on the internet lately tell me that something I'm 
confused about is "obvious".  Usually it means "if you've used this thing for 
as many years as I have, it's obvious".

> https://www.qemu.org/docs/master/system/invocation.html#hxtool-3 is the 
> part relevant to
> this context - qemu-system-gui provides sdl and gtk *modules* for qemu-
> system-* packages

Ah, yes!  This URL (and the fact that you suggested it) are very informative.

Would it be correct to say:
  This package enables the "gtk" and "sdl" display types used with the
  "-display" argument of qemu
?

If that is accurate, I think a sentence like that would be exactly the kind of 
addition to the qemu-system-gui documentation that I'm looking for (whether 
it's the package description, or README.Debian, or some other place)

Reply via email to