From 739e3d20f02e522c97b172ea3cbe494e989d7eb8 Mon Sep 17 00:00:00 2001 From: Erik Faye-Lund Date: Mon, 13 Apr 2026 17:57:39 +0200 Subject: [PATCH] docs/panfrost: fix heading-levels These headings shouldn't all be on the same level; the first one is the heading for the article, but the subsequent ones should be subheadings. Part-of: --- docs/drivers/panfrost/varyings.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/drivers/panfrost/varyings.rst b/docs/drivers/panfrost/varyings.rst index df324fc5b30..38393553b21 100644 --- a/docs/drivers/panfrost/varyings.rst +++ b/docs/drivers/panfrost/varyings.rst @@ -12,7 +12,7 @@ only interact with varyings (commonly shortened to "VAR"). Hardware descriptors -==================== +-------------------- Before Valhall there were two types of hardware descriptors: @@ -22,7 +22,7 @@ Before Valhall there were two types of hardware descriptors: contains: pointer, size and stride Midgard (v5) -============ +------------ Attributes are loaded/stored using ``LD_ATTR``/``ST_ATTR``, those query the attribute descriptors and buffer descriptors to find the real global memory offset before loading/storing. @@ -37,7 +37,7 @@ this is only supported between int-int or float-float operations. Bifrost (v6) -============ +------------ Changes: - ``ST_ATTR`` is replaced by ``LEA_ATTR`` and ``ST_CVT`` pairs. @@ -51,7 +51,7 @@ Changes: by ``LD_VAR_FLAT``. Valhall (v9) -============ +------------ Valhall introduced layout-specific instructions, ``LEA_BUF`` and ``LD_VAR_BUF``, those do not use ``AttributeDescriptor`` but read ``BufferDescriptor`` directly. These new instructions bake the offset and in-memory format of the attribute @@ -72,7 +72,7 @@ with ``LEA_BUF`` (instead of ``LEA_ATTR``), and never emit varying ``AttributeDescriptor`` for VS. Challenges -========== +---------- Theoretically, the output types from the VS and input types from the FS should always agree. In practice we cannot trust the varyings types given to us, here are some challenging examples: