On Fri, Sep 24, 2021 at 11:04:27AM +0200, Kevin Wolf wrote: > We want to switch both from QemuOpts to the keyval parser in the future, > which results in some incompatibilities, mainly around list handling. > Mark the non-JSON version of both as unstable syntax so that management > tools switch to JSON and we can later make the change without breaking > things. > > Signed-off-by: Kevin Wolf <kw...@redhat.com> > --- > docs/about/deprecated.rst | 11 +++++++++++ > 1 file changed, 11 insertions(+)
Reviewed-by: Eric Blake <ebl...@redhat.com> > > diff --git a/docs/about/deprecated.rst b/docs/about/deprecated.rst > index 3c2be84d80..42f6a478fb 100644 > --- a/docs/about/deprecated.rst > +++ b/docs/about/deprecated.rst > @@ -160,6 +160,17 @@ Use ``-display sdl`` instead. > > Use ``-display curses`` instead. > > +Stable non-JSON ``-device`` and ``-object`` syntax (since 6.2) > +'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' > + > +If you rely on a stable interface for ``-device`` and ``-object`` that > doesn't > +change incompatibly between QEMU versions (e.g. because you are using the > QEMU > +command line as a machine interface in scripts rather than interactively), > use > +JSON syntax for these options instead. > + > +There is no intention to remove support for non-JSON syntax entirely, but > +future versions may change the way to spell some options. > + > > Plugin argument passing through ``arg=<string>`` (since 6.1) > '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' > -- > 2.31.1 > -- Eric Blake, Principal Software Engineer Red Hat, Inc. +1-919-301-3266 Virtualization: qemu.org | libvirt.org
