From nobody Fri Nov 14 18:20:11 2025 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=quarantine dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1761904137; cv=none; d=zohomail.com; s=zohoarc; b=S5FMnPabb1VlKYnAzklbDZIIx3ro8B1bWJg3VGokpkg73GfdjwvxLhjv3i6+FdPMJPkRfP1M/+W9ylpRz4pYTW1MDNTbag3t6WCIuI7VtGuvS/YgF66rBYiP7fAdHeU2GXIZSPdCEauvCCBhH33vwd4XI5XhJfeHclKxrAf2r0M= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1761904137; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=IgaNYBq59QOIAkbsNbXqCSPl0bHKIMBbUZyzvpB3hoc=; b=Ssm+kla8vVFMbq0l8KEV5RNouqfwZVbGVG72oovrkENW7OEiM9R6RASZEi3eFwHTaS61I26ap7/nyLupyUHde4gYmZL46f0A2cSOtKsE26VBdJrbxmTg3ZXnbZ0ryQ2wQGPaDNgHRmWUylUnZ7UikSMWhWmpqt1esoQA1YcHgZM= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1761904137277805.668749782284; Fri, 31 Oct 2025 02:48:57 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1vElkD-0000W2-Mt; Fri, 31 Oct 2025 05:48:29 -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-0000Sb-8O for qemu-devel@nongnu.org; Fri, 31 Oct 2025 05:48:11 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1vEljn-0006hk-9y for qemu-devel@nongnu.org; Fri, 31 Oct 2025 05:48:10 -0400 Received: from mx-prod-mc-05.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-504-5gA1hp_7N_OoiioOMq1RlQ-1; Fri, 31 Oct 2025 05:47:58 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (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-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 551051955DCC; Fri, 31 Oct 2025 09:47:57 +0000 (UTC) Received: from blackfin.pond.sub.org (unknown [10.45.242.18]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id E30B619560A2; Fri, 31 Oct 2025 09:47:56 +0000 (UTC) Received: by blackfin.pond.sub.org (Postfix, from userid 1000) id 465FF21E676A; Fri, 31 Oct 2025 10:47:51 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1761904082; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=IgaNYBq59QOIAkbsNbXqCSPl0bHKIMBbUZyzvpB3hoc=; b=g2lKg7rsNhAPH1RDuBRX+bC2yBTwtyDVWMXwSZJ+32JXp9LE+k2X74hG251S0u+BiHMBkm Jbcs4N0rbYTSZaYDxc1kN5+HmGAqqH4f2jMjfYQjC5e1U+RXmX75PRCvi19I7iRIjpudKE 63qD4JVU2rmKHpWDM2OBfXsBW+OJagg= X-MC-Unique: 5gA1hp_7N_OoiioOMq1RlQ-1 X-Mimecast-MFC-AGG-ID: 5gA1hp_7N_OoiioOMq1RlQ_1761904077 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 7/8] docs/interop/firmware: Literal block markup Date: Fri, 31 Oct 2025 10:47:50 +0100 Message-ID: <20251031094751.2817932-8-armbru@redhat.com> In-Reply-To: <20251031094751.2817932-1-armbru@redhat.com> References: <20251031094751.2817932-1-armbru@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=170.10.133.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+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1761904143564158500 Content-Type: text/plain; charset="utf-8" A few doc comments show command line snippets. The snippets are indented, which is legible enough. Actually formatting these with Sphinx would fail with "Unexpected indentation", though. We don't so far. Add suitable markup anyway. Signed-off-by: Markus Armbruster Reviewed-by: Philippe Mathieu-Daud=C3=A9 Reviewed-by: Vladimir Sementsov-Ogievskiy --- docs/interop/firmware.json | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/interop/firmware.json b/docs/interop/firmware.json index 7ffa7697e4..da0362a2c0 100644 --- a/docs/interop/firmware.json +++ b/docs/interop/firmware.json @@ -308,12 +308,19 @@ # indicates whether there will be an associated NVRAM template # present. The preferred corresponding QEMU command line options # are +# +# :: +# # -drive if=3Dnone,id=3Dpflash0,readonly=3Don,file=3D@executable.@= filename,format=3D@executable.@format # -machine pflash0=3Dpflash0 +# # or equivalent -blockdev instead of -drive. When @mode is # @combined the executable must be cloned before use and # configured with readonly=3Doff. With QEMU versions older than # 4.0, you have to use +# +# :: +# # -drive if=3Dpflash,unit=3D0,readonly=3Don,file=3D@executable.@fi= lename,format=3D@executable.@format # # @nvram-template: Identifies the NVRAM template compatible with @@ -326,10 +333,17 @@ # typically used for persistently storing the non-volatile UEFI # variables of a virtual machine definition. The preferred # corresponding QEMU command line options are +# +# :: +# # -drive if=3Dnone,id=3Dpflash1,readonly=3Doff,file=3DFILENAME_OF_= PRIVATE_NVRAM_FILE,format=3D@nvram-template.@format # -machine pflash1=3Dpflash1 +# # or equivalent -blockdev instead of -drive. With QEMU versions # older than 4.0, you have to use +# +# :: +# # -drive if=3Dpflash,unit=3D1,readonly=3Doff,file=3DFILENAME_OF_PR= IVATE_NVRAM_FILE,format=3D@nvram-template.@format # # Since: 3.0 --=20 2.49.0