From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:59074) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1feyLP-0002Dk-M0 for qemu-devel@nongnu.org; Mon, 16 Jul 2018 03:55:00 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1feyLN-00073B-GP for qemu-devel@nongnu.org; Mon, 16 Jul 2018 03:54:55 -0400 Received: from mx3-rdu2.redhat.com ([66.187.233.73]:38204 helo=mx1.redhat.com) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1feyLN-00072f-4B for qemu-devel@nongnu.org; Mon, 16 Jul 2018 03:54:53 -0400 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.rdu2.redhat.com [10.11.54.6]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 0269281A4EAA for ; Mon, 16 Jul 2018 07:54:52 +0000 (UTC) Date: Mon, 16 Jul 2018 09:54:47 +0200 From: Cornelia Huck Message-ID: <20180716095447.1bf741c7.cohuck@redhat.com> In-Reply-To: <20180716073226.21127-2-armbru@redhat.com> References: <20180716073226.21127-1-armbru@redhat.com> <20180716073226.21127-2-armbru@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Subject: Re: [Qemu-devel] [PATCH 1/2] qemu-doc: Move appendix "Deprecated features" to its own file List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Markus Armbruster Cc: qemu-devel@nongnu.org, libvir-list@redhat.com, thuth@redhat.com, pkrempa@redhat.com, berrange@redhat.com On Mon, 16 Jul 2018 09:32:25 +0200 Markus Armbruster wrote: > Consumers of QEMU need to track feature deprecation. Keeping > deprecation documentation in its own file helps in two small ways: > > * You can track changes the easy and obvious way, with git-log. > Before, you had to resort to more complex gittery like "git-log > --oneline -L '/@node Deprecated features/,/@node Supported build > platforms/:qemu-doc.texi'" > > * It lets us use MAINTAINERS to copy interested parties on deprecation > patches, so they can advise or object before they're a done deal. > The next commit will do that for libvirt. > > Signed-off-by: Markus Armbruster > --- > qemu-deprecated.texi | 234 ++++++++++++++++++++++++++++++++++++++++++ > qemu-doc.texi | 235 +------------------------------------------ > 2 files changed, 235 insertions(+), 234 deletions(-) > create mode 100644 qemu-deprecated.texi Reviewed-by: Cornelia Huck