Re: [Qemu-devel] [PATCH] qemu-doc: Rework the network options chapter to make "-net" less prominent

[Thomas Huth <thuth@redhat.com>]

On 09.03.2018 20:00, Eric Blake wrote:
> On 03/09/2018 11:41 AM, Thomas Huth wrote:
>> On 09.03.2018 15:36, Eric Blake wrote:
>>> On 03/09/2018 12:13 AM, Thomas Huth wrote:
>>>> "-net" is clearly a legacy option. Yet we still use it in almost all
>>>> examples in the qemu documentation, and many other spots in the network
>>>> chapter. We should make it less prominent that users are not lured into
>>>> using it so often anymore. So instead of starting the network chapter
>>>> with
>>>> "-net nic" and documenting "-net <backend>" below "-netdev <backend>"
>>>> everywhere, all the "-net" related documentation is now moved to the
>>>> end
>>>> of the chapter. The new "--nic" option is moved to the beginning of the
>>>> chapter instead, with a new example that should demonstrate how "--nic"
>>>> can be used to shortcut "--device" with "--netdev".
>>>> And the examples in this chapter are changed to use the "--device" and
>>>> "--netdev" options or "--nic" instead of "-net nic -net <backend>".
>>>>
> 
>>>> +@example
>>>> +qemu-system-i386 --netdev user,id=n1,ipv6=off
>>>> --device=e1000,netdev=n1,mac=52:54:98:76:54:32
>>>> +qemu-system-i386 --nic user,ipv6=off,model=e1000,mac=52:54:98:76:54:32
>>>> +@end example
>>>
>>> Nice example.
>>
>> ... but looks like I even got it wrong - it should be "--device e1000",
>> without "=". Will fix it.
> 
> Really?  As I understand it, both long-opt spellings work ('--long=opt'
> as one arg, and '--long' 'opt' as two args).  So the only reason to drop
> '=' would be consistency with other examples.

$ qemu-system-x86_64 --device=e1000
qemu-system-x86_64: --device=e1000: invalid option

Does at least not work for me.

 Thomas