From patchwork Thu Aug 10 08:46:30 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas Huth X-Patchwork-Id: 9893055 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 63CA160384 for ; Thu, 10 Aug 2017 08:47:53 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 5D966289D6 for ; Thu, 10 Aug 2017 08:47:53 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 522FB28A1F; Thu, 10 Aug 2017 08:47:53 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=2.0 tests=BAYES_00,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 9347D289E6 for ; Thu, 10 Aug 2017 08:47:51 +0000 (UTC) Received: from localhost ([::1]:51711 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dfj86-00018e-C8 for patchwork-qemu-devel@patchwork.kernel.org; Thu, 10 Aug 2017 04:47:46 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:42542) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dfj72-000152-6u for qemu-devel@nongnu.org; Thu, 10 Aug 2017 04:46:41 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dfj6z-00013k-1Y for qemu-devel@nongnu.org; Thu, 10 Aug 2017 04:46:40 -0400 Received: from mx1.redhat.com ([209.132.183.28]:59712) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1dfj6y-000135-Rt for qemu-devel@nongnu.org; Thu, 10 Aug 2017 04:46:36 -0400 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 99FD34F1BD for ; Thu, 10 Aug 2017 08:46:33 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mx1.redhat.com 99FD34F1BD Authentication-Results: ext-mx02.extmail.prod.ext.phx2.redhat.com; dmarc=none (p=none dis=none) header.from=redhat.com Authentication-Results: ext-mx02.extmail.prod.ext.phx2.redhat.com; spf=fail smtp.mailfrom=thuth@redhat.com Received: from thh440s.redhat.com (ovpn-116-37.ams2.redhat.com [10.36.116.37]) by smtp.corp.redhat.com (Postfix) with ESMTP id 9607587F82; Thu, 10 Aug 2017 08:46:31 +0000 (UTC) From: Thomas Huth To: qemu-devel@nongnu.org, Paolo Bonzini Date: Thu, 10 Aug 2017 10:46:30 +0200 Message-Id: <1502354790-16927-1-git-send-email-thuth@redhat.com> X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.26]); Thu, 10 Aug 2017 08:46:34 +0000 (UTC) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 209.132.183.28 Subject: [Qemu-devel] [qemu-web PATCH v2] Add a blog post about deprecation of old interfaces and features X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Jeff Cody Errors-To: qemu-devel-bounces+patchwork-qemu-devel=patchwork.kernel.org@nongnu.org Sender: "Qemu-devel" X-Virus-Scanned: ClamAV using ClamSMTP 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.