From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 256F1CCF9FA for ; Fri, 31 Oct 2025 09:50:09 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1vElkE-0000aY-Gi; Fri, 31 Oct 2025 05:48:31 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1vEljv-0000Sa-8x for qemu-devel@nongnu.org; Fri, 31 Oct 2025 05:48:11 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.129.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1vEljm-0006hB-9o for qemu-devel@nongnu.org; Fri, 31 Oct 2025 05:48:10 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1761904077; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=IBBLfITuuJrklODE4cDNxcXRfi4U1h356QYK5qwl00A=; b=TUXtdEC8NRT3wXCZC7O5+oEX7lUKQf4bAQs3AxWELyB7sfbLxcyScEWHcL9Fwd33rtobwk i3yVetE5O+9ifmR7nmU6xnZBE//dgefat5W9peX8tbu7ZuaGVTqONH8frTbYhwlb8+pauG PPs3GytgVwEAdhWqvzmJK1GLpysRP/4= Received: from mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-589-zpXfos0_PlKio6xJfgbE3g-1; Fri, 31 Oct 2025 05:47:55 -0400 X-MC-Unique: zpXfos0_PlKio6xJfgbE3g-1 X-Mimecast-MFC-AGG-ID: zpXfos0_PlKio6xJfgbE3g_1761904074 Received: from mx-prod-int-05.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-05.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.17]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 3F3931955DE3; Fri, 31 Oct 2025 09:47:54 +0000 (UTC) Received: from blackfin.pond.sub.org (unknown [10.45.242.18]) by mx-prod-int-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id D0D2319540DA; Fri, 31 Oct 2025 09:47:53 +0000 (UTC) Received: by blackfin.pond.sub.org (Postfix, from userid 1000) id 27F8721E6A27; Fri, 31 Oct 2025 10:47:51 +0100 (CET) From: Markus Armbruster To: qemu-devel@nongnu.org Cc: jsnow@redhat.com, eblake@redhat.com, vsementsov@yandex-team.ru, thuth@redhat.com, berrange@redhat.com, philmd@linaro.org, kchamart@redhat.com, mst@redhat.com, sgarzare@redhat.com Subject: [PATCH 0/8] A QAPI schema doc markup fix, and style cleanup Date: Fri, 31 Oct 2025 10:47:43 +0100 Message-ID: <20251031094751.2817932-1-armbru@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Scanned-By: MIMEDefang 3.0 on 10.30.177.17 Received-SPF: pass client-ip=170.10.129.124; envelope-from=armbru@redhat.com; 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001, 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: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org Sender: qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org Vladimir Sementsov-Ogievskiy recently posted Subject: [PATCH v2 00/33] qapi: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 17:04:06 +0300 Message-ID: <20251011140441.297246-1-vsementsov@yandex-team.ru> His series refills doc comments to conform to the 70 width limit, tidies up spaces between sentences, and adds code to enforce both going forward. In review, we agreed to only refill prose, not the examples, at least for now. Vladimir volunteered to adjust his validation code, accordingly. I volunteered to take care of the doc comment cleanup. I decided redoing the cleanup would be less work than splitting. While doing so, I found a markup bug: PATCH 1. PATCH 2+4 are the cleanup. PATCH 3+5 additionally clean up blank lines. Testing this with his validation code failed: docs/interop/firmware.json also needs the treatment, and docs/interop/vhost-user.json would if we bothered to test it. PATCH 6 takes care of both PATCH 7 adds proper markup to literal blocks, so that the validation code can skip them. PATCH 8 adds the missing test. Vladimir's revised validation code is here: Subject: [PATCH v3] qapi: Add documentation format validation Date: Wed, 29 Oct 2025 20:30:59 +0300 Message-ID: <20251029173059.378607-1-vsementsov@yandex-team.ru> It needs to be rebased onto this series, and updated for it. Markus Armbruster (8): qapi/audio: Fix description markup of AudiodevDBusOptions @nsamples qapi: Refill doc comments to conform to conventions qapi: Clean up whitespace between definitions qga/qapi-schema: Refill doc comments to conform to conventions qga/qapi-schema: Clean up whitespace between definitions docs/interop: Refill QAPI doc comments to conform to conventions docs/interop/firmware: Literal block markup docs/interop: Add test to keep vhost-user.json sane docs/interop/firmware.json | 454 +++++++++++++++++------------------ docs/interop/vhost-user.json | 59 +++-- docs/meson.build | 9 +- qapi/accelerator.json | 3 +- qapi/acpi-hest.json | 5 +- qapi/audio.json | 4 +- qapi/block-core.json | 158 ++++++------ qapi/block-export.json | 26 +- qapi/char.json | 4 +- qapi/crypto.json | 8 +- qapi/cxl.json | 1 - qapi/introspect.json | 8 +- qapi/job.json | 30 +-- qapi/machine-common.json | 4 +- qapi/machine-s390x.json | 4 +- qapi/machine.json | 49 ++-- qapi/migration.json | 126 +++++----- qapi/misc-i386.json | 2 - qapi/net.json | 27 ++- qapi/qdev.json | 4 +- qapi/qom.json | 47 ++-- qapi/run-state.json | 20 +- qapi/sockets.json | 30 +-- qapi/stats.json | 4 +- qapi/ui.json | 17 +- qapi/virtio.json | 6 +- qga/qapi-schema.json | 96 ++++---- 27 files changed, 625 insertions(+), 580 deletions(-) -- 2.49.0