From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:52784) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dfji1-0006lI-4Z for qemu-devel@nongnu.org; Thu, 10 Aug 2017 05:24:54 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dfjhw-0005zZ-GF for qemu-devel@nongnu.org; Thu, 10 Aug 2017 05:24:53 -0400 Received: from mx1.redhat.com ([209.132.183.28]:50154) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1dfjhw-0005z9-8w for qemu-devel@nongnu.org; Thu, 10 Aug 2017 05:24:48 -0400 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 3555A7F7AB for ; Thu, 10 Aug 2017 09:24:47 +0000 (UTC) References: <1502354790-16927-1-git-send-email-thuth@redhat.com> <20170810092356.GD12980@redhat.com> From: Paolo Bonzini Message-ID: Date: Thu, 10 Aug 2017 11:24:44 +0200 MIME-Version: 1.0 In-Reply-To: <20170810092356.GD12980@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: "Daniel P. Berrange" , Thomas Huth Cc: qemu-devel@nongnu.org, Jeff Cody 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 >> --- >> 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