diff mbox

[PATCHv5,4/5] qemu-doc: deprecate query-cpus

Message ID 1518797321-28356-5-git-send-email-mihajlov@linux.vnet.ibm.com (mailing list archive)
State New, archived
Headers show

Commit Message

Viktor Mihajlovski Feb. 16, 2018, 4:08 p.m. UTC
Start the deprecation period for QAPI query-cpus (replaced by
query-cpus-fast) beginning with 2.12.0.

Signed-off-by: Viktor Mihajlovski <mihajlov@linux.vnet.ibm.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
---
 qapi-schema.json | 4 ++++
 qemu-doc.texi    | 4 ++++
 2 files changed, 8 insertions(+)

Comments

Cornelia Huck Feb. 19, 2018, 2:57 p.m. UTC | #1
On Fri, 16 Feb 2018 17:08:40 +0100
Viktor Mihajlovski <mihajlov@linux.vnet.ibm.com> wrote:

> Start the deprecation period for QAPI query-cpus (replaced by
> query-cpus-fast) beginning with 2.12.0.
> 
> Signed-off-by: Viktor Mihajlovski <mihajlov@linux.vnet.ibm.com>
> Reviewed-by: Eric Blake <eblake@redhat.com>
> ---
>  qapi-schema.json | 4 ++++
>  qemu-doc.texi    | 4 ++++
>  2 files changed, 8 insertions(+)

We need to remember updating the deprecation notes in the wiki as well.

Reviewed-by: Cornelia Huck <cohuck@redhat.com>
Viktor Mihajlovski Feb. 27, 2018, 1:41 p.m. UTC | #2
On 19.02.2018 15:57, Cornelia Huck wrote:
> On Fri, 16 Feb 2018 17:08:40 +0100
> Viktor Mihajlovski <mihajlov@linux.vnet.ibm.com> wrote:
> 
>> Start the deprecation period for QAPI query-cpus (replaced by
>> query-cpus-fast) beginning with 2.12.0.
>>
>> Signed-off-by: Viktor Mihajlovski <mihajlov@linux.vnet.ibm.com>
>> Reviewed-by: Eric Blake <eblake@redhat.com>
>> ---
>>  qapi-schema.json | 4 ++++
>>  qemu-doc.texi    | 4 ++++
>>  2 files changed, 8 insertions(+)
> 
> We need to remember updating the deprecation notes in the wiki as well.
> 
> Reviewed-by: Cornelia Huck <cohuck@redhat.com>
> 
Let me know whether you plan on doing that or I should take a crack at it.
Cornelia Huck Feb. 27, 2018, 7:06 p.m. UTC | #3
On Tue, 27 Feb 2018 14:41:38 +0100
Viktor Mihajlovski <mihajlov@linux.vnet.ibm.com> wrote:

> On 19.02.2018 15:57, Cornelia Huck wrote:
> > On Fri, 16 Feb 2018 17:08:40 +0100
> > Viktor Mihajlovski <mihajlov@linux.vnet.ibm.com> wrote:
> >   
> >> Start the deprecation period for QAPI query-cpus (replaced by
> >> query-cpus-fast) beginning with 2.12.0.
> >>
> >> Signed-off-by: Viktor Mihajlovski <mihajlov@linux.vnet.ibm.com>
> >> Reviewed-by: Eric Blake <eblake@redhat.com>
> >> ---
> >>  qapi-schema.json | 4 ++++
> >>  qemu-doc.texi    | 4 ++++
> >>  2 files changed, 8 insertions(+)  
> > 
> > We need to remember updating the deprecation notes in the wiki as well.
> > 
> > Reviewed-by: Cornelia Huck <cohuck@redhat.com>
> >   
> Let me know whether you plan on doing that or I should take a crack at it.
> 

If I haven't managed to update it by softfreeze, feel free to do so :)
Cornelia Huck March 2, 2018, 10:36 a.m. UTC | #4
On Tue, 27 Feb 2018 20:06:55 +0100
Cornelia Huck <cohuck@redhat.com> wrote:

> On Tue, 27 Feb 2018 14:41:38 +0100
> Viktor Mihajlovski <mihajlov@linux.vnet.ibm.com> wrote:
> 
> > On 19.02.2018 15:57, Cornelia Huck wrote:  
> > > On Fri, 16 Feb 2018 17:08:40 +0100
> > > Viktor Mihajlovski <mihajlov@linux.vnet.ibm.com> wrote:
> > >     
> > >> Start the deprecation period for QAPI query-cpus (replaced by
> > >> query-cpus-fast) beginning with 2.12.0.
> > >>
> > >> Signed-off-by: Viktor Mihajlovski <mihajlov@linux.vnet.ibm.com>
> > >> Reviewed-by: Eric Blake <eblake@redhat.com>
> > >> ---
> > >>  qapi-schema.json | 4 ++++
> > >>  qemu-doc.texi    | 4 ++++
> > >>  2 files changed, 8 insertions(+)    
> > > 
> > > We need to remember updating the deprecation notes in the wiki as well.
> > > 
> > > Reviewed-by: Cornelia Huck <cohuck@redhat.com>
> > >     
> > Let me know whether you plan on doing that or I should take a crack at it.
> >   
> 
> If I haven't managed to update it by softfreeze, feel free to do so :)

OK, added to the 2.12 changelog.
diff mbox

Patch

diff --git a/qapi-schema.json b/qapi-schema.json
index e6ca63f..cd98a94 100644
--- a/qapi-schema.json
+++ b/qapi-schema.json
@@ -587,6 +587,10 @@ 
 #       ]
 #    }
 #
+# Notes: This interface is deprecated (since 2.12.0), and it is strongly
+#        recommended that you avoid using it. Use @query-cpus-fast to
+#        obtain information about virtual CPUs.
+#
 ##
 { 'command': 'query-cpus', 'returns': ['CpuInfo'] }
 
diff --git a/qemu-doc.texi b/qemu-doc.texi
index 137f581..221f565 100644
--- a/qemu-doc.texi
+++ b/qemu-doc.texi
@@ -2764,6 +2764,10 @@  by the ``convert -l snapshot_param'' argument instead.
 "autoload" parameter is now ignored. All bitmaps are automatically loaded
 from qcow2 images.
 
+@subsection query-cpus (since 2.12.0)
+
+The ``query-cpus'' command is replaced by the ``query-cpus-fast'' command.
+
 @section System emulator human monitor commands
 
 @subsection host_net_add (since 2.10.0)