Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/1.1/patches/2227541/?format=api
{ "id": 2227541, "url": "http://patchwork.ozlabs.org/api/1.1/patches/2227541/?format=api", "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/patch/20260423220022.2180059-7-jsnow@redhat.com/", "project": { "id": 14, "url": "http://patchwork.ozlabs.org/api/1.1/projects/14/?format=api", "name": "QEMU Development", "link_name": "qemu-devel", "list_id": "qemu-devel.nongnu.org", "list_email": "qemu-devel@nongnu.org", "web_url": "", "scm_url": "", "webscm_url": "" }, "msgid": "<20260423220022.2180059-7-jsnow@redhat.com>", "date": "2026-04-23T22:00:15", "name": "[06/12] qapi/docs: remove implicit Plain section", "commit_ref": null, "pull_url": null, "state": "new", "archived": false, "hash": "57756bc7e04953348551cc89ba5292a473cf8899", "submitter": { "id": 64343, "url": "http://patchwork.ozlabs.org/api/1.1/people/64343/?format=api", "name": "John Snow", "email": "jsnow@redhat.com" }, "delegate": null, "mbox": "http://patchwork.ozlabs.org/project/qemu-devel/patch/20260423220022.2180059-7-jsnow@redhat.com/mbox/", "series": [ { "id": 501255, "url": "http://patchwork.ozlabs.org/api/1.1/series/501255/?format=api", "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/list/?series=501255", "date": "2026-04-23T22:00:11", "name": "qapi: add formal \"intro\" section", "version": 1, "mbox": "http://patchwork.ozlabs.org/series/501255/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/2227541/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/2227541/checks/", "tags": {}, "headers": { "Return-Path": "<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>", "X-Original-To": "incoming@patchwork.ozlabs.org", "Delivered-To": "patchwork-incoming@legolas.ozlabs.org", "Authentication-Results": [ "legolas.ozlabs.org;\n\tdkim=pass (1024-bit key;\n unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256\n header.s=mimecast20190719 header.b=R6umKON9;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=nongnu.org\n (client-ip=209.51.188.17; helo=lists1p.gnu.org;\n envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n receiver=patchwork.ozlabs.org)" ], "Received": [ "from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17])\n\t(using TLSv1.2 with cipher ECDHE-ECDSA-AES256-GCM-SHA384 (256/256 bits))\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4g1qmd0g0Bz1yJF\n\tfor <incoming@patchwork.ozlabs.org>; Fri, 24 Apr 2026 08:01:19 +1000 (AEST)", "from localhost ([::1] helo=lists1p.gnu.org)\n\tby lists1p.gnu.org with esmtp (Exim 4.90_1)\n\t(envelope-from <qemu-devel-bounces@nongnu.org>)\n\tid 1wG26S-0005i4-DC; Thu, 23 Apr 2026 18:00:56 -0400", "from eggs.gnu.org ([2001:470:142:3::10])\n by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from <jsnow@redhat.com>) id 1wG26R-0005ht-0H\n for qemu-devel@nongnu.org; Thu, 23 Apr 2026 18:00:55 -0400", "from us-smtp-delivery-124.mimecast.com ([170.10.129.124])\n by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from <jsnow@redhat.com>) id 1wG26P-0005nu-Ff\n for qemu-devel@nongnu.org; Thu, 23 Apr 2026 18:00:54 -0400", "from mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com\n (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by\n relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3,\n cipher=TLS_AES_256_GCM_SHA384) id us-mta-37-iIoNmoObMHy7396BV1NJ_g-1; Thu,\n 23 Apr 2026 18:00:48 -0400", "from mx-prod-int-01.mail-002.prod.us-west-2.aws.redhat.com\n (mx-prod-int-01.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.4])\n (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest\n SHA256)\n (No client certificate requested)\n by mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS\n id 912B21800352; Thu, 23 Apr 2026 22:00:47 +0000 (UTC)", "from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.64.143])\n by mx-prod-int-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP\n id DAC463007572; Thu, 23 Apr 2026 22:00:44 +0000 (UTC)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;\n s=mimecast20190719; t=1776981652;\n h=from:from:reply-to:subject:subject:date:date:message-id:message-id:\n to:to:cc:cc:mime-version:mime-version:\n content-transfer-encoding:content-transfer-encoding:\n in-reply-to:in-reply-to:references:references;\n bh=RYJ7B+a5vootVUaV3wOdTFwQv+RoXbr1yfxq1QKp8Ng=;\n b=R6umKON9HhG9gP33PdfLRIvanrcXtAGu8aot6kbJGFLnufPSkzHx+jJLuqCmFRa6Q4fUX0\n 2RajXjA0+b1/9D3XFo4TWqEOSJXmih+za49qTbSbV2zTu7poVYoJgunQLUHtY4fw8bfJ7D\n iuDIkaNAgkgrP4svK/BXHXzkbiwdSRg=", "X-MC-Unique": "iIoNmoObMHy7396BV1NJ_g-1", "X-Mimecast-MFC-AGG-ID": "iIoNmoObMHy7396BV1NJ_g_1776981647", "From": "John Snow <jsnow@redhat.com>", "To": "qemu-devel@nongnu.org", "Cc": "Igor Mammedov <imammedo@redhat.com>,\n Mauro Carvalho Chehab <mchehab+huawei@kernel.org>,\n \"Michael S. Tsirkin\" <mst@redhat.com>, Michael Roth <michael.roth@amd.com>,\n Markus Armbruster <armbru@redhat.com>, Ani Sinha <anisinha@redhat.com>,\n Gerd Hoffmann <kraxel@redhat.com>, Eric Blake <eblake@redhat.com>,\n Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com>, =?utf-8?q?Philippe_Ma?=\n\t=?utf-8?q?thieu-Daud=C3=A9?= <philmd@linaro.org>, =?utf-8?q?Marc-Andr=C3=A9?=\n\t=?utf-8?q?_Lureau?= <marcandre.lureau@redhat.com>,\n Richard Henderson <richard.henderson@linaro.org>,\n Paolo Bonzini <pbonzini@redhat.com>,\n Peter Maydell <peter.maydell@linaro.org>, John Snow <jsnow@redhat.com>", "Subject": "[PATCH 06/12] qapi/docs: remove implicit Plain section", "Date": "Thu, 23 Apr 2026 18:00:15 -0400", "Message-ID": "<20260423220022.2180059-7-jsnow@redhat.com>", "In-Reply-To": "<20260423220022.2180059-1-jsnow@redhat.com>", "References": "<20260423220022.2180059-1-jsnow@redhat.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "X-Scanned-By": "MIMEDefang 3.4.1 on 10.30.177.4", "Received-SPF": "pass client-ip=170.10.129.124; envelope-from=jsnow@redhat.com;\n helo=us-smtp-delivery-124.mimecast.com", "X-Spam_score_int": "-20", "X-Spam_score": "-2.1", "X-Spam_bar": "--", "X-Spam_report": "(-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001,\n DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,\n RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001,\n SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no", "X-Spam_action": "no action", "X-BeenThere": "qemu-devel@nongnu.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "qemu development <qemu-devel.nongnu.org>", "List-Unsubscribe": "<https://lists.nongnu.org/mailman/options/qemu-devel>,\n <mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>", "List-Archive": "<https://lists.nongnu.org/archive/html/qemu-devel>", "List-Post": "<mailto:qemu-devel@nongnu.org>", "List-Help": "<mailto:qemu-devel-request@nongnu.org?subject=help>", "List-Subscribe": "<https://lists.nongnu.org/mailman/listinfo/qemu-devel>,\n <mailto:qemu-devel-request@nongnu.org?subject=subscribe>", "Errors-To": "qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org", "Sender": "qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org" }, "content": "Prior to this patch, we always instantiate an empty Plain\nsection. Removing this allows us to gradually phase out the \"Plain\"\nsection in favor of \"Intro\" and \"Details\" sections while keeping \"Plain\"\naround for the interim churn during the series - meaning that we don't\nactually know at __init__ time which type of section we'll have first.\n\nSigned-off-by: John Snow <jsnow@redhat.com>\n---\n scripts/qapi/parser.py | 4 +---\n tests/qapi-schema/doc-good.out | 14 --------------\n 2 files changed, 1 insertion(+), 17 deletions(-)", "diff": "diff --git a/scripts/qapi/parser.py b/scripts/qapi/parser.py\nindex b21796b3e80..6612f471bb8 100644\n--- a/scripts/qapi/parser.py\n+++ b/scripts/qapi/parser.py\n@@ -730,9 +730,7 @@ def __init__(self, info: QAPISourceInfo, symbol: Optional[str] = None):\n # definition doc's symbol, None for free-form doc\n self.symbol: Optional[str] = symbol\n # the sections in textual order\n- self.all_sections: List[QAPIDoc.Section] = [\n- QAPIDoc.Section(info, QAPIDoc.Kind.PLAIN)\n- ]\n+ self.all_sections: List[QAPIDoc.Section] = []\n # dicts mapping parameter/feature names to their description\n self._args: Dict[str, QAPIDoc.ArgSection] = {}\n self._features: Dict[str, QAPIDoc.ArgSection] = {}\ndiff --git a/tests/qapi-schema/doc-good.out b/tests/qapi-schema/doc-good.out\nindex e2be6f96bbf..6fcc8175cfe 100644\n--- a/tests/qapi-schema/doc-good.out\n+++ b/tests/qapi-schema/doc-good.out\n@@ -106,8 +106,6 @@ Examples:\n - *verbatim*\n - {braces}\n doc symbol=Enum\n- section=Plain\n-\n arg=one\n The _one_ {and only}, description on the same line\n arg=two\n@@ -119,8 +117,6 @@ a member feature\n section=Plain\n @two is undocumented\n doc symbol=Base\n- section=Plain\n-\n arg=base1\n description starts on a new line,\n minimally indented\n@@ -138,16 +134,10 @@ a feature\n feature=member-feat\n a member feature\n doc symbol=Variant2\n- section=Plain\n-\n doc symbol=Object\n- section=Plain\n-\n feature=union-feat1\n a feature\n doc symbol=Alternate\n- section=Plain\n-\n arg=i\n description starts on the same line\n remainder indented the same\n@@ -161,8 +151,6 @@ doc freeform\n Another subsection\n ==================\n doc symbol=cmd\n- section=Plain\n-\n arg=arg1\n description starts on a new line,\n indented\n@@ -223,7 +211,5 @@ another feature\n \n <- ... has no title ...\n doc symbol=EVT_BOXED\n- section=Plain\n-\n feature=feat3\n a feature\n", "prefixes": [ "06/12" ] }