On Wed, Feb 24, 2021 at 02:25:46PM +0100, Paolo Bonzini wrote: > On 24/02/21 14:11, Daniel P. Berrangé wrote: > > This was replaced by the '-device usb-DEV' option. > > > > Signed-off-by: Daniel P. Berrangé <berrange@xxxxxxxxxx> > > This is probably used in many tutorial as "-usbdevice tablet" (for example > https://wiki.gentoo.org/wiki/QEMU/Options). It has been deprecated, printing a warning message, for almost 4 years now, and had your ack originally :-) commit a358a3af4558a24398a541951cad7a6c458df72b Author: Thomas Huth <thuth@xxxxxxxxxx> Date: Fri May 19 08:35:16 2017 +0200 usb: Deprecate the legacy -usbdevice option The '-usbdevice' option is considered as deprecated nowadays and we might want to remove these options in a future version of QEMU. So mark this options as deprecated in the documenation and print out a warning if it is used to tell the user what to use instead. While we're at it, improve also some other minor USB-related spots in qemu-options.hx that were not up to date anymore. Signed-off-by: Thomas Huth <thuth@xxxxxxxxxx> Reviewed-by: Paolo Bonzini <pbonzini@xxxxxxxxxx> Message-id: 1495175716-12735-1-git-send-email-thuth@xxxxxxxxxx Signed-off-by: Gerd Hoffmann <kraxel@xxxxxxxxxx> There's some tradeoff to be had. The 3rd party docs will be unlikely to be updated to the new syntax as long as the old syntax still works. So we get ourselves into a chicken & egg scenario. Overall the -usbdevice doesn't add significant syntax sugar benefits over -device, as compared benefits of other syntax sugar args we have. > > --- > > docs/system/deprecated.rst | 9 ------- > > docs/system/removed-features.rst | 9 +++++++ > > softmmu/vl.c | 42 -------------------------------- > > 3 files changed, 9 insertions(+), 51 deletions(-) It seems this is incomplete though, I missed qemu-options.hx, docs/qdev-device-use.txt and hw/usb/bus.c updates to remove associated cruft. Regards, Daniel -- |: https://berrange.com -o- https://www.flickr.com/photos/dberrange :| |: https://libvirt.org -o- https://fstop138.berrange.com :| |: https://entangle-photo.org -o- https://www.instagram.com/dberrange :|
