Re: [Qemu-block] RFC: unified --help information

[Paolo Bonzini]

On 26/07/2017 12:53, Eric Blake wrote:
> 
> GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
> Full documentation at: <http://www.gnu.org/software/coreutils/ls>
> or available locally via: info '(coreutils) ls invocation'
> 
> or 'm4 --help | tail -n3':
> Report bugs to: address@hidden
> GNU M4 home page: <http://www.gnu.org/software/m4/>
> General help using GNU software: <http://www.gnu.org/gethelp/>
> 
> In our executables, we are rather inconsistent with --help
> 
> qemu-nbd mentions: Report bugs to <address@hidden>
> qemu-ga mentions: Report bugs to <address@hidden>
> 
> while qemu-system-*, qemu-img, and qemu-io mention nothing at all.  Is
> it worth unifying these to all mention address@hidden as the
> primary bug-report site, and/or to add mention of <http://qemu.org> as a
> site for further information?

I think we should point to a more specific bugreport URL.

Currently it's http://wiki.qemu.org/Contribute/ReportABug.  If we want
an URL on qemu.org, we can either add a redirect from qemu.org to the
wiki, or move the contents to qemu.org (it's static enough that it
shouldn't be a big issue).  I've sent out a patch for the latter.

> Likewise, with --version, qemu-io and qemu-ga lack the git suffix
> present in qemu-system-* and just added in qemu-nbd.
> 
> I can submit patches to make things consistent, and think it is 2.10
> material, but first want to get consensus on what the behavior should be.

I agree it's better to be consistent.

Paolo

signature.asc
Description: OpenPGP digital signature