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 <th...@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
