[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] [PATCH v2 8/8] qemu-doc: Make "-net" less prominent
From: |
Paolo Bonzini |
Subject: |
Re: [Qemu-devel] [PATCH v2 8/8] qemu-doc: Make "-net" less prominent |
Date: |
Tue, 20 Feb 2018 19:37:22 +0100 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.6.0 |
On 20/02/2018 18:40, 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. And the examples are changed to use the "--device" and
> "--netdev" options instead of "-net nic -net <backend>".
Do we want to change them to "-nic" instead? The proof is in the
pudding, they say, :) and "-nic" is way easier to learn than "-device
-netdev".
And maybe we *should* go the extra mile and deprecate "-net" altogether.
The only case where the newer syntax is a bit more uncomfortable is for
"-net nic -net nic -net tap|user", which however does work with "-nic
hubport -nic hubport -netdev tap|user,id=x -netdev hubport,netdev=x".
For now I suggest dropping this patch.
Paolo
- [Qemu-devel] [PATCH v2 1/8] net: Move error reporting from net_init_client/netdev to the calling site, (continued)
- [Qemu-devel] [PATCH v2 1/8] net: Move error reporting from net_init_client/netdev to the calling site, Thomas Huth, 2018/02/20
- [Qemu-devel] [PATCH v2 3/8] net: Only show vhost-user in the help text if CONFIG_POSIX is defined, Thomas Huth, 2018/02/20
- [Qemu-devel] [PATCH v2 4/8] net: Make net_client_init() static, Thomas Huth, 2018/02/20
- [Qemu-devel] [PATCH v2 6/8] net: Remove the deprecated 'host_net_add' and 'host_net_remove' HMP commands, Thomas Huth, 2018/02/20
- [Qemu-devel] [PATCH v2 5/8] net: Remove the deprecated way of dumping network packets, Thomas Huth, 2018/02/20
- [Qemu-devel] [PATCH v2 7/8] net: Add a new convenience option "--nic" to configure default/on-board NICs, Thomas Huth, 2018/02/20
- [Qemu-devel] [PATCH v2 8/8] qemu-doc: Make "-net" less prominent, Thomas Huth, 2018/02/20
- Re: [Qemu-devel] [PATCH v2 8/8] qemu-doc: Make "-net" less prominent,
Paolo Bonzini <=