From patchwork Fri Oct 11 09:49:46 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Paolo Bonzini X-Patchwork-Id: 13832287 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 2DD12CFD316 for ; Fri, 11 Oct 2024 09:50:39 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1szCHh-0000Rp-H1; Fri, 11 Oct 2024 05:50:09 -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 1szCHe-0000RR-An for qemu-devel@nongnu.org; Fri, 11 Oct 2024 05:50:06 -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 1szCHa-0005Zh-LJ for qemu-devel@nongnu.org; Fri, 11 Oct 2024 05:50:06 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1728640200; 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=38Df3hGaJPI3ZCAlpdE4GoGyiTBulhiRTV/1ges6i3s=; b=LpTq2z2k0WK7cT2/b1jnJMHmbt2oACfzMIA/khkOx9rF5Ce2pRHuM1/YgGRUnipZa/BLYb fZdAzX+IpwQOMTYNflwBM4NHiqJ0d8HKpI9auIfmZCd7+0st/lzWQxhPuTPvAzMjCVhX+b gy17zv/57A70D21GoNKhCKtC3S1LSKw= Received: from mail-lj1-f200.google.com (mail-lj1-f200.google.com [209.85.208.200]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-210-8Qv3uk-NNXu82-hWlDvskw-1; Fri, 11 Oct 2024 05:49:58 -0400 X-MC-Unique: 8Qv3uk-NNXu82-hWlDvskw-1 Received: by mail-lj1-f200.google.com with SMTP id 38308e7fff4ca-2fad58ddea1so14327391fa.2 for ; Fri, 11 Oct 2024 02:49:58 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1728640196; x=1729244996; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=38Df3hGaJPI3ZCAlpdE4GoGyiTBulhiRTV/1ges6i3s=; b=IE3e3ODrrSA0pPDpoB0/cjJY6zNkLu2DEF12CAKfb4tm2yTZt6m+eA93r7zFYLqZNd 9e0U2WQ73eD4RmC5Xeep44ut3tt+s4HEJ5JcWVRz7oVZO7DmKBXx5oPvwaNfe6G8CnHM QCj+Ar0T4rwgNbjF4jfyuNeZB8dOjE3Da9DrGme2+BrN1Z2KQzFvAY5YjyTjX7Weju7z aee3XOVldetIq/1r5JzJeLrxzyn+whg0x8kSpQ8Q2SrHGJ7Q3qL0xcPiXPWTJNJsVahW qRwKC7V2IXIMvrFzNOgQgvQ2ZmEKwKK9X+PS4aA/0wozc9epZ7asunicsmHc63W9fwWm ZoEQ== X-Gm-Message-State: AOJu0YyjrX6JQioHz8hyMI8DaFj9TOb0Q61YcdZDd5wmWzpw+s92UbKa QXaFpMGFaqxjMjVmFpl+sQyUIM6S2HofyAzjzqai3OONR3ngWEzSXDsIyWzuS9W97Hm52XcEKKk 2u/VuoW3VHB2n7u54lI2tHcK4KoTaOQVWYtxbu/8Gy8kCWM9WOcntk8Pqkebq2hOjaLH2vOOmf7 ZmSDnP2t0zo0FwXoXX/CzvI2LXvHWiX6+8n8RB9DE= X-Received: by 2002:a2e:4e01:0:b0:2fb:5bd:8ff2 with SMTP id 38308e7fff4ca-2fb32721726mr12189981fa.16.1728640196503; Fri, 11 Oct 2024 02:49:56 -0700 (PDT) X-Google-Smtp-Source: AGHT+IGifBjj+k2AaK6w2KBreB1lAKVvN3CS+NPFhFbrWki7cKWjBOaX/yzQh52Tt/TdaQyZUTndcA== X-Received: by 2002:a2e:4e01:0:b0:2fb:5bd:8ff2 with SMTP id 38308e7fff4ca-2fb32721726mr12189721fa.16.1728640195924; Fri, 11 Oct 2024 02:49:55 -0700 (PDT) Received: from avogadro.local ([151.81.124.37]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-a99a7f26678sm192451666b.70.2024.10.11.02.49.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 11 Oct 2024 02:49:54 -0700 (PDT) From: Paolo Bonzini To: qemu-devel@nongnu.org Cc: peter.maydell@linaro.org Subject: [PATCH 1/3] docs: fix invalid footnote syntax Date: Fri, 11 Oct 2024 11:49:46 +0200 Message-ID: <20241011094948.34550-2-pbonzini@redhat.com> X-Mailer: git-send-email 2.46.2 In-Reply-To: <20241011094948.34550-1-pbonzini@redhat.com> References: <20241011094948.34550-1-pbonzini@redhat.com> MIME-Version: 1.0 Received-SPF: pass client-ip=170.10.133.124; envelope-from=pbonzini@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -21 X-Spam_score: -2.2 X-Spam_bar: -- X-Spam_report: (-2.2 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.149, 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_NONE=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 All footnotes must come after a separator in reStructuredText. Fix the two files in which this does not happen. This mistake is caught by Sphinx 8.1.0 as an unreferenced footnote. Signed-off-by: Paolo Bonzini Reviewed-by: Peter Maydell --- docs/devel/atomics.rst | 2 +- docs/devel/build-system.rst | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/devel/atomics.rst b/docs/devel/atomics.rst index b77c6e13e18..6bf032f9005 100644 --- a/docs/devel/atomics.rst +++ b/docs/devel/atomics.rst @@ -204,7 +204,7 @@ They come in six kinds: before the second with respect to the other components of the system. Therefore, unlike ``smp_rmb()`` or ``qatomic_load_acquire()``, ``smp_read_barrier_depends()`` can be just a compiler barrier on - weakly-ordered architectures such as Arm or PPC[#]_. + weakly-ordered architectures such as Arm or PPC\ [#]_. Note that the first load really has to have a _data_ dependency and not a control dependency. If the address for the second load is dependent diff --git a/docs/devel/build-system.rst b/docs/devel/build-system.rst index 79eceb179de..fa1c59d9fd8 100644 --- a/docs/devel/build-system.rst +++ b/docs/devel/build-system.rst @@ -145,13 +145,13 @@ was installed in the ``site-packages`` directory of another interpreter, or with the wrong ``pip`` program. If a package is available for the chosen interpreter, ``configure`` -prepares a small script that invokes it from the venv itself[#distlib]_. +prepares a small script that invokes it from the venv itself\ [#distlib]_. If not, ``configure`` can also optionally install dependencies in the virtual environment with ``pip``, either from wheels in ``python/wheels`` or by downloading the package with PyPI. Downloading can be disabled with ``--disable-download``; and anyway, it only happens when a ``configure`` option (currently, only ``--enable-docs``) is explicitly enabled but -the dependencies are not present[#pip]_. +the dependencies are not present\ [#pip]_. .. [#distlib] The scripts are created based on the package's metadata, specifically the ``console_script`` entry points. This is the From patchwork Fri Oct 11 09:49:47 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Paolo Bonzini X-Patchwork-Id: 13832290 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 1EA01CFD312 for ; Fri, 11 Oct 2024 09:51:19 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1szCHn-0000W3-JF; Fri, 11 Oct 2024 05:50:15 -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 1szCHg-0000Rd-6F for qemu-devel@nongnu.org; Fri, 11 Oct 2024 05:50:08 -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 1szCHd-0005lg-4N for qemu-devel@nongnu.org; Fri, 11 Oct 2024 05:50:07 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1728640204; 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=uuA4LT4Qd6C85HmZQe9ktVcKHNDYnUR3Ii8WYt5rNHM=; b=LE+P4q5OHkegocblZEHmEfzgK36O8JdNRcyz6EjFVgi7QH//p2uOdZjRfzrhQaArW+ZBxF nKvXoj/78XgA8dXobH9uZawOuX/QeWDHfa+Z/iMTziOSEK6cPkdRsM611njJN0Z1/A8TlB t67PsQjXo1c/HcArin7r0025lIy7hjc= Received: from mail-ej1-f70.google.com (mail-ej1-f70.google.com [209.85.218.70]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-622-UX0JC4o2OB6Y3FJDlzNi3Q-1; Fri, 11 Oct 2024 05:50:03 -0400 X-MC-Unique: UX0JC4o2OB6Y3FJDlzNi3Q-1 Received: by mail-ej1-f70.google.com with SMTP id a640c23a62f3a-a99442bd721so135437366b.2 for ; Fri, 11 Oct 2024 02:50:03 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1728640201; x=1729245001; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=uuA4LT4Qd6C85HmZQe9ktVcKHNDYnUR3Ii8WYt5rNHM=; b=kBbMzh9IthlP4ccLUqnMzQMYSIwUNiaGP/yxMgDdWgia3GZgYODUHt6qIv9zlof5xW zaCx1d2OHui9TaRzU2su0I+MiCyexnms4Wd92o4wAk7m3A89CGNmg/HDSZp74DUqpEoc NKZ4USCPgl2ILZcxM0KiRVndV5a3yTnLD8w2aJsuPSe+Bt9uae0biR9EAAb9r+EqMGwB Ybs7S7vSdip6DiY7wFVeVWjzqPAOkSpqO6fk57qkWBi/U54pfY0KDHfoAXSaM4oSzT7T 47addc3sDNSfBeF+BtcDIc+Pp+KkL5hQ3SH0lKz7KbLK8oVBgbnQy49TYYp4PhnORLh5 RtqQ== X-Gm-Message-State: AOJu0YwN9v6eJ9MpPoXFhQjs7Q1m2wuIehNExSQX0Nd25CdeC/Gd2s4C tfgHHNR4qI84R/2RhEji8HoJGj7GZx+AjB+JtUOP937JqRqaQz4e3azntFSbTG08lylaftu04aO 0Y4jt7rqMLiR6HdnBj/XJgOny1XqMY8s1mQNuA+djW8d5fLXhkEEkAtlqFMCtP2HqQYY39FrY9y v2stiBFRIyyixKLFzBfZXRAU6sSXgHWFXMGbt0hKc= X-Received: by 2002:a17:907:e247:b0:a99:4649:af69 with SMTP id a640c23a62f3a-a99b957f7eamr165951266b.15.1728640201221; Fri, 11 Oct 2024 02:50:01 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFbxpFGINiCJGc8DFZFLFrM8vu2tVRvxi2ujj90h9qtupKKgFaIwyfhf347B4okvw9a/tRsaw== X-Received: by 2002:a17:907:e247:b0:a99:4649:af69 with SMTP id a640c23a62f3a-a99b957f7eamr165949066b.15.1728640200652; Fri, 11 Oct 2024 02:50:00 -0700 (PDT) Received: from avogadro.local ([151.81.124.37]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-a99a7ede7e8sm192819966b.9.2024.10.11.02.49.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 11 Oct 2024 02:49:58 -0700 (PDT) From: Paolo Bonzini To: qemu-devel@nongnu.org Cc: peter.maydell@linaro.org Subject: [PATCH 2/3] docs: avoid unreferenced footnote Date: Fri, 11 Oct 2024 11:49:47 +0200 Message-ID: <20241011094948.34550-3-pbonzini@redhat.com> X-Mailer: git-send-email 2.46.2 In-Reply-To: <20241011094948.34550-1-pbonzini@redhat.com> References: <20241011094948.34550-1-pbonzini@redhat.com> MIME-Version: 1.0 Received-SPF: pass client-ip=170.10.133.124; envelope-from=pbonzini@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -21 X-Spam_score: -2.2 X-Spam_bar: -- X-Spam_report: (-2.2 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.149, 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_NONE=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 The link to fosdem.org is inlined but also included in the footnote [#c]. Replace the inline link with a reference to the footnote, because Sphinx 8.1.0 is a lot stricter about unreferenced footnotes. Signed-off-by: Paolo Bonzini --- docs/devel/testing/acpi-bits.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/devel/testing/acpi-bits.rst b/docs/devel/testing/acpi-bits.rst index 78aeb6aa3c4..2e4f1d23def 100644 --- a/docs/devel/testing/acpi-bits.rst +++ b/docs/devel/testing/acpi-bits.rst @@ -37,8 +37,8 @@ dependent submodules `here `__. This fork contains numerous fixes, a newer acpica and changes specific to running these functional QEMU tests using bits. The author of this document is the sole maintainer of the QEMU fork of bios bits repository. For more -information, please see author's `FOSDEM talk on this bios-bits based test -framework `__. +information, please see author's FOSDEM talk on this bios-bits based test +framework\ [#c]_. ********************************* Description of the test framework From patchwork Fri Oct 11 09:49:48 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Paolo Bonzini X-Patchwork-Id: 13832289 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 0A8D1CFD30C for ; Fri, 11 Oct 2024 09:50:44 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1szCHl-0000UC-7s; Fri, 11 Oct 2024 05:50:13 -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 1szCHj-0000SD-12 for qemu-devel@nongnu.org; Fri, 11 Oct 2024 05:50: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 1szCHh-0005ma-1i for qemu-devel@nongnu.org; Fri, 11 Oct 2024 05:50:10 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1728640208; 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=sOo5rGwuEsLIsT0z0mvwLuo2d2iR44ZOAqKO0cUGjYk=; b=JPsUKNYHCb5wgocOs2D4oZ6+FGGI4fbQ5Xp9fprnqtFqWxipMht/axQC5V70dvGghTdCze d+K/F38mnZYi9iCKEQtuf8YG60PSQpJxioavpVqUjriBEX2GoyIeSRq251CbXFRd3xuJHh aFN0jmfDXjhp2SZQW1RR5MDDjK5G6X8= Received: from mail-ej1-f69.google.com (mail-ej1-f69.google.com [209.85.218.69]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-654-lKKSPT9uOPmK0PUGRQjVkw-1; Fri, 11 Oct 2024 05:50:06 -0400 X-MC-Unique: lKKSPT9uOPmK0PUGRQjVkw-1 Received: by mail-ej1-f69.google.com with SMTP id a640c23a62f3a-a996c29ee23so120784566b.0 for ; Fri, 11 Oct 2024 02:50:06 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1728640204; x=1729245004; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=sOo5rGwuEsLIsT0z0mvwLuo2d2iR44ZOAqKO0cUGjYk=; b=lnOP/EgkoJf//Jmqo7REt3aFmAuNsjmHPK1h02rmfRaTOF2k91qX6g3h2rOv80KCaK 1I5MiiOsjt1Rof41CG8a03VHq4ZkT+z7p17jJp7M7Npkc2MyP0L4W9WbJCRGAeqnEAi4 VSJZF+Giko+ZsXPfaq3o5z6GQC38UTOhg576loaxAysKijivm107QDro6wd+tV2DwQvb OqMvIX2zY2MQ4zH8yZ57a1E9mqRyn3GJu3al2ECOZPzqSAusjk1/eQEgBoA+84L2SX2C RzQGSevH4Ahq/f13JmDF0LV/jNs3NLbKzKEr7MKndZOEYsAQg3OvfPEItMHLQ7qiR76o MPCA== X-Gm-Message-State: AOJu0YyqwL2pswlgEmp2l6JbX8TeTb/xeTIQFDKlPL3TvK9Hq+rGuun8 IqHqxowD1XCx+5d3/bVBizO9L0mTPlkABprUXuSXZX30ghKPpF/DlkANI7blXHmqqJn4KriC46L TLUlwR1CWvaxEP1NTKFcns2hZ9QJYS/3zp3SpQARa3Q/MA2ilr02vmzwLEHPHSjotSX8JjFbpUk 4fcTo4h4z96GT6YaLqpUwte4ruTSHIFMCDzNpfKtI= X-Received: by 2002:a17:907:2cc5:b0:a99:4ce4:27eb with SMTP id a640c23a62f3a-a99b95a7640mr150617466b.46.1728640204055; Fri, 11 Oct 2024 02:50:04 -0700 (PDT) X-Google-Smtp-Source: AGHT+IGjnvYrzObElx8zPxorBj7WPgkQkiJ+vW3/lPxrN8JMOlPwB8v3JpYRhzQT2epRDurRqM8qeA== X-Received: by 2002:a17:907:2cc5:b0:a99:4ce4:27eb with SMTP id a640c23a62f3a-a99b95a7640mr150615366b.46.1728640203530; Fri, 11 Oct 2024 02:50:03 -0700 (PDT) Received: from avogadro.local ([151.81.124.37]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-a99a7f2c1f4sm194059566b.87.2024.10.11.02.50.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 11 Oct 2024 02:50:02 -0700 (PDT) From: Paolo Bonzini To: qemu-devel@nongnu.org Cc: peter.maydell@linaro.org Subject: [PATCH 3/3] docs: use consistent markup for footnotes Date: Fri, 11 Oct 2024 11:49:48 +0200 Message-ID: <20241011094948.34550-4-pbonzini@redhat.com> X-Mailer: git-send-email 2.46.2 In-Reply-To: <20241011094948.34550-1-pbonzini@redhat.com> References: <20241011094948.34550-1-pbonzini@redhat.com> MIME-Version: 1.0 Received-SPF: pass client-ip=170.10.133.124; envelope-from=pbonzini@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -21 X-Spam_score: -2.2 X-Spam_bar: -- X-Spam_report: (-2.2 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.149, 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_NONE=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 Always use a named reference for clarity, and ensure the space is escaped if the footnote must attach to the preceding word. Signed-off-by: Paolo Bonzini Reviewed-by: Peter Maydell --- docs/devel/atomics.rst | 6 +++--- docs/devel/build-system.rst | 2 +- docs/devel/loads-stores.rst | 2 +- docs/devel/maintainers.rst | 4 ++-- docs/devel/migration/mapped-ram.rst | 4 ++-- docs/specs/fw_cfg.rst | 4 ++-- docs/specs/rapl-msr.rst | 4 ++-- 7 files changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/devel/atomics.rst b/docs/devel/atomics.rst index 6bf032f9005..95c7b77c01e 100644 --- a/docs/devel/atomics.rst +++ b/docs/devel/atomics.rst @@ -204,7 +204,7 @@ They come in six kinds: before the second with respect to the other components of the system. Therefore, unlike ``smp_rmb()`` or ``qatomic_load_acquire()``, ``smp_read_barrier_depends()`` can be just a compiler barrier on - weakly-ordered architectures such as Arm or PPC\ [#]_. + weakly-ordered architectures such as Arm or PPC\ [#alpha]_. Note that the first load really has to have a _data_ dependency and not a control dependency. If the address for the second load is dependent @@ -212,7 +212,7 @@ They come in six kinds: than actually loading the address itself, then it's a _control_ dependency and a full read barrier or better is required. -.. [#] The DEC Alpha is an exception, because ``smp_read_barrier_depends()`` +.. [#alpha] The DEC Alpha is an exception, because ``smp_read_barrier_depends()`` needs a processor barrier. On strongly-ordered architectures such as x86 or s390, ``smp_rmb()`` and ``qatomic_load_acquire()`` can also be compiler barriers only. @@ -295,7 +295,7 @@ Acquire/release pairing and the *synchronizes-with* relation ------------------------------------------------------------ Atomic operations other than ``qatomic_set()`` and ``qatomic_read()`` have -either *acquire* or *release* semantics [#rmw]_. This has two effects: +either *acquire* or *release* semantics\ [#rmw]_. This has two effects: .. [#rmw] Read-modify-write operations can have both---acquire applies to the read part, and release to the write. diff --git a/docs/devel/build-system.rst b/docs/devel/build-system.rst index fa1c59d9fd8..d42045a2325 100644 --- a/docs/devel/build-system.rst +++ b/docs/devel/build-system.rst @@ -333,7 +333,7 @@ into each emulator: ``default-configs/targets/*.mak`` These files mostly define symbols that appear in the ``*-config-target.h`` - file for each emulator [#cfgtarget]_. However, the ``TARGET_ARCH`` + file for each emulator\ [#cfgtarget]_. However, the ``TARGET_ARCH`` and ``TARGET_BASE_ARCH`` will also be used to select the ``hw/`` and ``target/`` subdirectories that are compiled into each target. diff --git a/docs/devel/loads-stores.rst b/docs/devel/loads-stores.rst index ec627aa9c06..9471bac8599 100644 --- a/docs/devel/loads-stores.rst +++ b/docs/devel/loads-stores.rst @@ -95,7 +95,7 @@ guest CPU state in case of a guest CPU exception. This is passed to ``cpu_restore_state()``. Therefore the value should either be 0, to indicate that the guest CPU state is already synchronized, or the result of ``GETPC()`` from the top level ``HELPER(foo)`` -function, which is a return address into the generated code [#gpc]_. +function, which is a return address into the generated code\ [#gpc]_. .. [#gpc] Note that ``GETPC()`` should be used with great care: calling it in other functions that are *not* the top level diff --git a/docs/devel/maintainers.rst b/docs/devel/maintainers.rst index 5c907d901cd..88a613ed74f 100644 --- a/docs/devel/maintainers.rst +++ b/docs/devel/maintainers.rst @@ -99,9 +99,9 @@ members of the QEMU community, you should make arrangements to attend a `KeySigningParty `__ (for example at KVM Forum) or make alternative arrangements to have your key signed by an attendee. Key signing requires meeting another -community member **in person** [#]_ so please make appropriate +community member **in person**\ [#2020]_ so please make appropriate arrangements. -.. [#] In recent pandemic times we have had to exercise some +.. [#2020] In recent pandemic times we have had to exercise some flexibility here. Maintainers still need to sign their pull requests though. diff --git a/docs/devel/migration/mapped-ram.rst b/docs/devel/migration/mapped-ram.rst index d352b546e96..b08c2b433c4 100644 --- a/docs/devel/migration/mapped-ram.rst +++ b/docs/devel/migration/mapped-ram.rst @@ -44,7 +44,7 @@ Use-cases The mapped-ram feature was designed for use cases where the migration stream will be directed to a file in the filesystem and not -immediately restored on the destination VM [#]_. These could be +immediately restored on the destination VM\ [#alternatives]_. These could be thought of as snapshots. We can further categorize them into live and non-live. @@ -70,7 +70,7 @@ mapped-ram in this scenario is portability since background-snapshot depends on async dirty tracking (KVM_GET_DIRTY_LOG) which is not supported outside of Linux. -.. [#] While this same effect could be obtained with the usage of +.. [#alternatives] While this same effect could be obtained with the usage of snapshots or the ``file:`` migration alone, mapped-ram provides a performance increase for VMs with larger RAM sizes (10s to 100s of GiBs), specially if the VM has been stopped beforehand. diff --git a/docs/specs/fw_cfg.rst b/docs/specs/fw_cfg.rst index 5ad47a901c9..c353957e1d3 100644 --- a/docs/specs/fw_cfg.rst +++ b/docs/specs/fw_cfg.rst @@ -54,11 +54,11 @@ Data Register ------------- * Read/Write (writes ignored as of QEMU v2.4, but see the DMA interface) -* Location: platform dependent (IOport [#]_ or MMIO) +* Location: platform dependent (IOport [#placement]_ or MMIO) * Width: 8-bit (if IOport), 8/16/32/64-bit (if MMIO) * Endianness: string-preserving -.. [#] +.. [#placement] On platforms where the data register is exposed as an IOport, its port number will always be one greater than the port number of the selector register. In other words, the two ports overlap, and can not diff --git a/docs/specs/rapl-msr.rst b/docs/specs/rapl-msr.rst index 1202ee89bee..901ce83bfa8 100644 --- a/docs/specs/rapl-msr.rst +++ b/docs/specs/rapl-msr.rst @@ -9,7 +9,7 @@ The consumption is reported via MSRs (model specific registers) like MSR_PKG_ENERGY_STATUS for the CPU package power domain. These MSRs are 64 bits registers that represent the accumulated energy consumption in micro Joules. -Thanks to the MSR Filtering patch [#a]_ not all MSRs are handled by KVM. Some +Thanks to the MSR Filtering patch\ [#a]_ not all MSRs are handled by KVM. Some of them can now be handled by the userspace (QEMU). It uses a mechanism called "MSR filtering" where a list of MSRs is given at init time of a VM to KVM so that a callback is put in place. The design of this patch uses only this @@ -92,7 +92,7 @@ found by the sysconf system call. A typical value of clock ticks per second is package has 4 cores, 400 ticks maximum can be scheduled on all the cores of the package for a period of 1 second. -The /proc/[pid]/stat [#b]_ is a sysfs file that can give the executed time of a +The /proc/[pid]/stat\ [#b]_ is a sysfs file that can give the executed time of a process with the [pid] as the process ID. It gives the amount of ticks the process has been scheduled in userspace (utime) and kernel space (stime).