| Message ID | 1502354790-16927-1-git-send-email-thuth@redhat.com (mailing list archive) |
|---|---|
| State | New, archived |
| Headers | show |
On 10/08/2017 10:46, Thomas Huth wrote: > Now that we've got a list of deprecated interfaces/features in the QEMU > documentation, it is time to draw some more public attention to our plans > of removing certain interfaces/features in future releases. > > Signed-off-by: Thomas Huth <thuth@redhat.com> > --- > v2: Use a link to the qemu-doc instead of pointing to the Wiki > > _posts/2017-08-10-deprecation.md | 26 ++++++++++++++++++++++++++ > 1 file changed, 26 insertions(+) > create mode 100644 _posts/2017-08-10-deprecation.md > > diff --git a/_posts/2017-08-10-deprecation.md b/_posts/2017-08-10-deprecation.md > new file mode 100644 > index 0000000..784fb79 > --- /dev/null > +++ b/_posts/2017-08-10-deprecation.md > @@ -0,0 +1,26 @@ > +--- > +layout: post > +title: "Deprecation of old parameters and features" > +date: 2017-08-10 10:45:00 +0200 > +author: Thomas Huth > +categories: [features, 'web site'] > +--- > +QEMU has a lot of interfaces (like command line options or HMP commands) and > +old features (like certain devices) which are considered as deprecated > +since other more generic or better interfaces/features have been established > +instead. While the QEMU developers are generally trying to keep each QEMU > +release compatible with the previous ones, the old legacy sometimes gets into > +the way when developing new code and/or causes quite some burden of maintaining > +it. > + > +Thus we are currently considering to get rid of some of the old interfaces > +and features in a future release and have started to collect a list of such > +old items in our > +[QEMU documentation](https://qemu.weilnetz.de/doc/qemu-doc.html#Deprecated-features). > +If you are running QEMU directly, please have a look at this deprecation > +chapter of the QEMU documentation to see whether you are still using one of > +these old interfaces or features, so you can adapt your setup to use the new > +interfaces/features instead. Or if you rather think that one of the items > +should *not* be removed from QEMU at all, please speak up on the > +[qemu-devel mailing list](http://wiki.qemu.org/Contribute/MailingLists) > +to explain why the interface or feature is still required. > Pushed, thanks. Paolo
On Thu, Aug 10, 2017 at 10:46:30AM +0200, Thomas Huth wrote: > Now that we've got a list of deprecated interfaces/features in the QEMU > documentation, it is time to draw some more public attention to our plans > of removing certain interfaces/features in future releases. > > Signed-off-by: Thomas Huth <thuth@redhat.com> > --- > v2: Use a link to the qemu-doc instead of pointing to the Wiki > > _posts/2017-08-10-deprecation.md | 26 ++++++++++++++++++++++++++ > 1 file changed, 26 insertions(+) > create mode 100644 _posts/2017-08-10-deprecation.md > > diff --git a/_posts/2017-08-10-deprecation.md b/_posts/2017-08-10-deprecation.md > new file mode 100644 > index 0000000..784fb79 > --- /dev/null > +++ b/_posts/2017-08-10-deprecation.md > @@ -0,0 +1,26 @@ > +--- > +layout: post > +title: "Deprecation of old parameters and features" > +date: 2017-08-10 10:45:00 +0200 > +author: Thomas Huth > +categories: [features, 'web site'] > +--- > +QEMU has a lot of interfaces (like command line options or HMP commands) and > +old features (like certain devices) which are considered as deprecated > +since other more generic or better interfaces/features have been established > +instead. While the QEMU developers are generally trying to keep each QEMU > +release compatible with the previous ones, the old legacy sometimes gets into > +the way when developing new code and/or causes quite some burden of maintaining > +it. > + > +Thus we are currently considering to get rid of some of the old interfaces > +and features in a future release and have started to collect a list of such > +old items in our > +[QEMU documentation](https://qemu.weilnetz.de/doc/qemu-doc.html#Deprecated-features). Unrelated to your post - it would be nice to have the qemu docs hosted on qemu.org, and even nicer if someone figures out how to theme them to fit in with the website style instead of being bare black & white pages with no navigation :-) Regards, Daniel
On 10/08/2017 11:23, Daniel P. Berrange wrote: > On Thu, Aug 10, 2017 at 10:46:30AM +0200, Thomas Huth wrote: >> Now that we've got a list of deprecated interfaces/features in the QEMU >> documentation, it is time to draw some more public attention to our plans >> of removing certain interfaces/features in future releases. >> >> Signed-off-by: Thomas Huth <thuth@redhat.com> >> --- >> v2: Use a link to the qemu-doc instead of pointing to the Wiki >> >> _posts/2017-08-10-deprecation.md | 26 ++++++++++++++++++++++++++ >> 1 file changed, 26 insertions(+) >> create mode 100644 _posts/2017-08-10-deprecation.md >> >> diff --git a/_posts/2017-08-10-deprecation.md b/_posts/2017-08-10-deprecation.md >> new file mode 100644 >> index 0000000..784fb79 >> --- /dev/null >> +++ b/_posts/2017-08-10-deprecation.md >> @@ -0,0 +1,26 @@ >> +--- >> +layout: post >> +title: "Deprecation of old parameters and features" >> +date: 2017-08-10 10:45:00 +0200 >> +author: Thomas Huth >> +categories: [features, 'web site'] >> +--- >> +QEMU has a lot of interfaces (like command line options or HMP commands) and >> +old features (like certain devices) which are considered as deprecated >> +since other more generic or better interfaces/features have been established >> +instead. While the QEMU developers are generally trying to keep each QEMU >> +release compatible with the previous ones, the old legacy sometimes gets into >> +the way when developing new code and/or causes quite some burden of maintaining >> +it. >> + >> +Thus we are currently considering to get rid of some of the old interfaces >> +and features in a future release and have started to collect a list of such >> +old items in our >> +[QEMU documentation](https://qemu.weilnetz.de/doc/qemu-doc.html#Deprecated-features). > > Unrelated to your post - it would be nice to have the qemu docs hosted > on qemu.org, and even nicer if someone figures out how to theme them > to fit in with the website style instead of being bare black & white > pages with no navigation :-) My hope is still to host them on readthedocs sooner or later (though then they'd have the readthedocs theme). Paolo
diff --git a/_posts/2017-08-10-deprecation.md b/_posts/2017-08-10-deprecation.md new file mode 100644 index 0000000..784fb79 --- /dev/null +++ b/_posts/2017-08-10-deprecation.md @@ -0,0 +1,26 @@ +--- +layout: post +title: "Deprecation of old parameters and features" +date: 2017-08-10 10:45:00 +0200 +author: Thomas Huth +categories: [features, 'web site'] +--- +QEMU has a lot of interfaces (like command line options or HMP commands) and +old features (like certain devices) which are considered as deprecated +since other more generic or better interfaces/features have been established +instead. While the QEMU developers are generally trying to keep each QEMU +release compatible with the previous ones, the old legacy sometimes gets into +the way when developing new code and/or causes quite some burden of maintaining +it. + +Thus we are currently considering to get rid of some of the old interfaces +and features in a future release and have started to collect a list of such +old items in our +[QEMU documentation](https://qemu.weilnetz.de/doc/qemu-doc.html#Deprecated-features). +If you are running QEMU directly, please have a look at this deprecation +chapter of the QEMU documentation to see whether you are still using one of +these old interfaces or features, so you can adapt your setup to use the new +interfaces/features instead. Or if you rather think that one of the items +should *not* be removed from QEMU at all, please speak up on the +[qemu-devel mailing list](http://wiki.qemu.org/Contribute/MailingLists) +to explain why the interface or feature is still required.
Now that we've got a list of deprecated interfaces/features in the QEMU documentation, it is time to draw some more public attention to our plans of removing certain interfaces/features in future releases. Signed-off-by: Thomas Huth <thuth@redhat.com> --- v2: Use a link to the qemu-doc instead of pointing to the Wiki _posts/2017-08-10-deprecation.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 _posts/2017-08-10-deprecation.md