Re: [Qemu-devel] [PATCH] docs: update information for TLS certificate management

[Thomas Huth <thuth@redhat.com>]

On 12.12.2017 15:17, Daniel P. Berrange wrote:
> On Fri, Dec 08, 2017 at 10:16:50AM -0600, Eric Blake wrote:
>> On 12/08/2017 05:58 AM, Daniel P. Berrange wrote:
[...]
>>> +
>>> +@node tls_creds_setup
>>> +@subsection TLS x509 credential configuration
>>> +
>>> +QEMU has a standard mechanism for loading x509 credentials that will be
>>> +used for network services and clients. It requires specifying the
>>> +@code{tls-creds-x509} class name to the @code{-object} command line
>>> +argument for the system emulators. This also works for the helper tools
>>> +like @code{qemu-nbd} and @code{qemu-img}, but is named @code{--object}.
>>
>> You can use '--object' with qemu as well (getopt_long_only() accepts
>> double-dash form in addition to single dash).  If it makes it any easier
>> to only document the double-dash form, then go for it.
> 
> Since the QEMU -help text only mentions the single dash format, I'll
> stick with that.
> 
> Perhaps though, we should change the -help text (and all docs) to always
> use double dash format so we're consistent across QEMU codebase, and more
> normal CLI arg syntax for long options ?

Good idea!

... and maybe we could also introduce some more short options for the
most popular parameters one day? A short option for "--device" would be
really handy, for example.

 Thomas