From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:50145) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dfjZC-0001nN-AF for qemu-devel@nongnu.org; Thu, 10 Aug 2017 05:15:47 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dfjZ9-0000eM-3V for qemu-devel@nongnu.org; Thu, 10 Aug 2017 05:15:46 -0400 Received: from mx1.redhat.com ([209.132.183.28]:33098) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1dfjZ8-0000dm-KE for qemu-devel@nongnu.org; Thu, 10 Aug 2017 05:15:43 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 8914F24FF4B for ; Thu, 10 Aug 2017 09:15:41 +0000 (UTC) References: <1502354790-16927-1-git-send-email-thuth@redhat.com> From: Paolo Bonzini Message-ID: Date: Thu, 10 Aug 2017 11:15:37 +0200 MIME-Version: 1.0 In-Reply-To: <1502354790-16927-1-git-send-email-thuth@redhat.com> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit Subject: Re: [Qemu-devel] [qemu-web PATCH v2] Add a blog post about deprecation of old interfaces and features List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Thomas Huth , qemu-devel@nongnu.org Cc: Daniel Berrange , Jeff Cody 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 > --- > 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