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 AE611CCF9E3 for ; Tue, 4 Nov 2025 13:22:16 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1vGGyf-0000CZ-ST; Tue, 04 Nov 2025 08:21:37 -0500 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 1vGGye-0000CL-Ta for qemu-devel@nongnu.org; Tue, 04 Nov 2025 08:21:36 -0500 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 1vGGyd-0001U8-38 for qemu-devel@nongnu.org; Tue, 04 Nov 2025 08:21:36 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1762262494; 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: in-reply-to:in-reply-to:references:references; bh=zu5G30QuLl31+UO3Ev2SMdWcF3Nqh5ryUNTfhDBGnNs=; b=gkamR2NR53m1dcyutqAv0551YktvAux/GmDBSZHF+Ee3ZrzvMvba0PcXbvaY1+xJbms5+X ujzp5jFWydQULeU7lXZi6E2/NhF0rCyFQf59RiZ6myG55+CUOywLTTX9wWwPTAqJADO4UJ dJxhhfSPS4h/1biipQ17Vsfq6h/5fuI= Received: from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-618-V7hAMwtSMxSwYCy-PHmang-1; Tue, 04 Nov 2025 08:21:33 -0500 X-MC-Unique: V7hAMwtSMxSwYCy-PHmang-1 X-Mimecast-MFC-AGG-ID: V7hAMwtSMxSwYCy-PHmang_1762262492 Received: from mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.111]) (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-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id DD57618001C6; Tue, 4 Nov 2025 13:21:31 +0000 (UTC) Received: from blackfin.pond.sub.org (unknown [10.45.242.18]) by mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 5D8751800577; Tue, 4 Nov 2025 13:21:31 +0000 (UTC) Received: by blackfin.pond.sub.org (Postfix, from userid 1000) id 8609021E66E0; Tue, 04 Nov 2025 14:21:25 +0100 (CET) From: Markus Armbruster To: qemu-devel@nongnu.org Cc: richard.henderson@linaro.org, =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Vladimir Sementsov-Ogievskiy Subject: [PULL 10/12] docs/interop/firmware: Literal block markup Date: Tue, 4 Nov 2025 14:21:23 +0100 Message-ID: <20251104132125.4134730-11-armbru@redhat.com> In-Reply-To: <20251104132125.4134730-1-armbru@redhat.com> References: <20251104132125.4134730-1-armbru@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.111 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: -28 X-Spam_score: -2.9 X-Spam_bar: -- X-Spam_report: (-2.9 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.788, 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 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é Reviewed-by: Vladimir Sementsov-Ogievskiy Message-ID: <20251103082354.3273027-9-armbru@redhat.com> --- 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=none,id=pflash0,readonly=on,file=@executable.@filename,format=@executable.@format # -machine pflash0=pflash0 +# # or equivalent -blockdev instead of -drive. When @mode is # @combined the executable must be cloned before use and # configured with readonly=off. With QEMU versions older than # 4.0, you have to use +# +# :: +# # -drive if=pflash,unit=0,readonly=on,file=@executable.@filename,format=@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=none,id=pflash1,readonly=off,file=FILENAME_OF_PRIVATE_NVRAM_FILE,format=@nvram-template.@format # -machine pflash1=pflash1 +# # or equivalent -blockdev instead of -drive. With QEMU versions # older than 4.0, you have to use +# +# :: +# # -drive if=pflash,unit=1,readonly=off,file=FILENAME_OF_PRIVATE_NVRAM_FILE,format=@nvram-template.@format # # Since: 3.0 -- 2.49.0