QEMU-Devel Archive mirror
 help / color / mirror / Atom feed
From: Paolo Bonzini <pbonzini@redhat.com>
To: qemu-devel@nongnu.org
Subject: [PULL 27/46] docs: document new convention for Kconfig board symbols
Date: Mon,  6 May 2024 09:51:06 +0200	[thread overview]
Message-ID: <20240506075125.8238-28-pbonzini@redhat.com> (raw)
In-Reply-To: <20240506075125.8238-1-pbonzini@redhat.com>

Boards have been switched to use "default y" and are now listed
in default-configs/*.mak only for convenience.

Document this change and the new possibilities that it allows.

Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
---
 docs/devel/kconfig.rst | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/docs/devel/kconfig.rst b/docs/devel/kconfig.rst
index ccb9a46bd77..52d4b905f67 100644
--- a/docs/devel/kconfig.rst
+++ b/docs/devel/kconfig.rst
@@ -211,6 +211,8 @@ declares its dependencies in different ways:
 
     config SUN4M
       bool
+      default y
+      depends on SPARC && !SPARC64
       imply TCX
       imply CG3
       select CS4231
@@ -228,8 +230,16 @@ declares its dependencies in different ways:
   directives.  A device should be listed under ``select`` if the board
   cannot be started at all without it.  It should be listed under
   ``imply`` if (depending on the QEMU command line) the board may or
-  may not be started without it.  Boards also default to false; they are
-  enabled by the ``default-configs/*.mak`` for the target they apply to.
+  may not be started without it.  Boards default to true, but also
+  have a ``depends on`` clause to limit them to the appropriate targets.
+  For some targets, not all boards may be supported by hardware
+  virtualization, in which case they also depend on the ``TCG`` symbol,
+  Other symbols that are commonly used as dependencies for boards
+  include libraries (such as ``FDT``) or ``TARGET_BIG_ENDIAN``
+  (possibly negated).
+
+  Boards are listed for convenience in the ``default-configs/*.mak``
+  for the target they apply to.
 
 **internal elements**
 
-- 
2.44.0



  parent reply	other threads:[~2024-05-06  8:01 UTC|newest]

Thread overview: 48+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-05-06  7:50 [PULL 00/46] Mostly build system and other cleanups patches for 2024-05-06 Paolo Bonzini
2024-05-06  7:50 ` [PULL 01/46] target/i386: Give IRQs a chance when resetting HF_INHIBIT_IRQ_MASK Paolo Bonzini
2024-05-06  7:50 ` [PULL 02/46] Kconfig: kvm: allow building without any board Paolo Bonzini
2024-05-06  7:50 ` [PULL 03/46] tests/qtest: skip m48t59-test if the machine is absent Paolo Bonzini
2024-05-06  7:50 ` [PULL 04/46] gitlab-ci: adjust msys2-64bit to be able to run qtest Paolo Bonzini
2024-05-06  7:50 ` [PULL 05/46] kvm: ppc: disable sPAPR code if CONFIG_PSERIES is disabled Paolo Bonzini
2024-05-06  7:50 ` [PULL 06/46] configs: list "implied" device groups in the default configs Paolo Bonzini
2024-05-06  7:50 ` [PULL 07/46] alpha: switch boards to "default y" Paolo Bonzini
2024-05-06  7:50 ` [PULL 08/46] arm: " Paolo Bonzini
2024-05-06  7:50 ` [PULL 09/46] avr: " Paolo Bonzini
2024-05-06  7:50 ` [PULL 10/46] cris: " Paolo Bonzini
2024-05-06  7:50 ` [PULL 11/46] hppa: " Paolo Bonzini
2024-05-06  7:50 ` [PULL 12/46] i386: " Paolo Bonzini
2024-05-06  7:50 ` [PULL 13/46] loongarch: " Paolo Bonzini
2024-05-06  7:50 ` [PULL 14/46] m68k: " Paolo Bonzini
2024-05-06  7:50 ` [PULL 15/46] microblaze: " Paolo Bonzini
2024-05-06  7:50 ` [PULL 16/46] meson: make target endianneess available to Kconfig Paolo Bonzini
2024-05-06  7:50 ` [PULL 17/46] mips: switch boards to "default y" Paolo Bonzini
2024-05-06  7:50 ` [PULL 18/46] openrisc: " Paolo Bonzini
2024-05-06  7:50 ` [PULL 19/46] ppc: " Paolo Bonzini
2024-05-06  7:50 ` [PULL 20/46] riscv: " Paolo Bonzini
2024-05-06  7:51 ` [PULL 21/46] rx: " Paolo Bonzini
2024-05-06  7:51 ` [PULL 22/46] s390x: " Paolo Bonzini
2024-05-06  7:51 ` [PULL 23/46] sh4: " Paolo Bonzini
2024-05-06  7:51 ` [PULL 24/46] sparc: " Paolo Bonzini
2024-05-06  7:51 ` [PULL 25/46] tricore: " Paolo Bonzini
2024-05-06  7:51 ` [PULL 26/46] xtensa: " Paolo Bonzini
2024-05-06  7:51 ` Paolo Bonzini [this message]
2024-05-06  7:51 ` [PULL 28/46] target/i386: Introduce SapphireRapids-v3 to add missing features Paolo Bonzini
2024-05-06  7:51 ` [PULL 29/46] bitmap: Use g_try_new0/g_new0/g_renew Paolo Bonzini
2024-05-06  7:51 ` [PULL 30/46] build: do not build virtio-vga-gl if virgl/opengl not available Paolo Bonzini
2024-05-06  7:51 ` [PULL 31/46] fw_cfg: remove useless declarations from typedefs.h Paolo Bonzini
2024-05-06  7:51 ` [PULL 32/46] qdev-core: remove DeviceListener " Paolo Bonzini
2024-05-06  7:51 ` [PULL 33/46] numa: remove types " Paolo Bonzini
2024-05-06  7:51 ` [PULL 34/46] net: remove AnnounceTimer " Paolo Bonzini
2024-05-06  7:51 ` [PULL 35/46] qemu-option: remove QemuOpt " Paolo Bonzini
2024-05-06  7:51 ` [PULL 36/46] intc: remove PICCommonState " Paolo Bonzini
2024-05-06  7:51 ` [PULL 37/46] lockable: remove QemuLockable " Paolo Bonzini
2024-05-06  7:51 ` [PULL 38/46] migration: remove PostcopyDiscardState " Paolo Bonzini
2024-05-06  7:51 ` [PULL 39/46] monitor: remove MonitorDef " Paolo Bonzini
2024-05-06  7:51 ` [PULL 40/46] qapi/machine: remove types " Paolo Bonzini
2024-05-06  7:51 ` [PULL 41/46] display: remove GraphicHwOps " Paolo Bonzini
2024-05-06  7:51 ` [PULL 42/46] tcg: remove CPU* types " Paolo Bonzini
2024-05-06  7:51 ` [PULL 43/46] pci: remove some " Paolo Bonzini
2024-05-06  7:51 ` [PULL 44/46] kvm: move target-dependent interrupt routing out of kvm-all.c Paolo Bonzini
2024-05-06  7:51 ` [PULL 45/46] migration: do not include coroutine_int.h Paolo Bonzini
2024-05-06  7:51 ` [PULL 46/46] qga/commands-posix: fix typo in qmp_guest_set_user_password Paolo Bonzini
2024-05-06 17:17 ` [PULL 00/46] Mostly build system and other cleanups patches for 2024-05-06 Richard Henderson

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20240506075125.8238-28-pbonzini@redhat.com \
    --to=pbonzini@redhat.com \
    --cc=qemu-devel@nongnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).