[PATCH] drm: add overview diagram for drm stack

[Bagas Sanjaya]

On Thu, May 22, 2025 at 06:20:27PM -0400, Abdulrasaq Lawani wrote:
> -[Insert diagram of typical DRM stack here]
> +Overview of the Linux DRM Architecture
> +-----------------------------------------------
> ++-----------------------------+
> +|     User-space Apps         |
> +| (Games, Browsers, ML, etc.) |
> ++-----------------------------+
> +              |
> +              v
> ++---------------------------------------+
> +|    Graphics APIs   |   Compute APIs   |
> +|  (OpenGL, Vulkan)  |  (OpenCL, CUDA)  |
> ++---------------------------------------+
> +          |                   |
> +          v                   v
> ++---------------------+  +-----------------------+
> +|  User-space Driver  |  |    Compute Runtime    |
> +|  (Mesa, AMD/NVIDIA) |  |  (OpenCL, CUDA, ROCm) |
> ++---------------------+  +-----------------------+
> +          |                   |
> +          +--------+----------+
> +                   |
> +                   v
> +        +-----------------------+
> +        |   libdrm (DRM API)    |
> +        +-----------------------+
> +                   |
> +                   v
> ++-------------------------------------------+
> +|     Kernel DRM/KMS Driver (i915, amdgpu,  |
> +|     nouveau, etc.)                        |
> ++-------------------------------------------+
> +        |                       |
> +        v                       v
> ++----------------+     +-------------------+
> +| GPU Display HW |     | GPU Compute Units |
> ++----------------+     +-------------------+
> +

I get multiple Sphinx indentation warnings and errors:

Documentation/gpu/introduction.rst:23: ERROR: Unexpected indentation. [docutils]
Documentation/gpu/introduction.rst:22: WARNING: Block quote ends without a blank line; unexpected unindent. [docutils]
Documentation/gpu/introduction.rst:23: WARNING: Blank line required after table. [docutils]
Documentation/gpu/introduction.rst:24: WARNING: Line block ends without a blank line. [docutils]
Documentation/gpu/introduction.rst:25: WARNING: Block quote ends without a blank line; unexpected unindent. [docutils]
Documentation/gpu/introduction.rst:29: ERROR: Unexpected indentation. [docutils]
Documentation/gpu/introduction.rst:28: WARNING: Block quote ends without a blank line; unexpected unindent. [docutils]
Documentation/gpu/introduction.rst:29: WARNING: Blank line required after table. [docutils]
Documentation/gpu/introduction.rst:29: WARNING: Inline substitution_reference start-string without end-string. [docutils]
Documentation/gpu/introduction.rst:30: WARNING: Line block ends without a blank line. [docutils]
Documentation/gpu/introduction.rst:31: WARNING: Block quote ends without a blank line; unexpected unindent. [docutils]
Documentation/gpu/introduction.rst:35: ERROR: Unexpected indentation. [docutils]
Documentation/gpu/introduction.rst:35: WARNING: Inline substitution_reference start-string without end-string. [docutils]
Documentation/gpu/introduction.rst:36: WARNING: Line block ends without a blank line. [docutils]
Documentation/gpu/introduction.rst:37: ERROR: Unexpected indentation. [docutils]
Documentation/gpu/introduction.rst:37: WARNING: Blank line required after table. [docutils]
Documentation/gpu/introduction.rst:38: WARNING: Line block ends without a blank line. [docutils]
Documentation/gpu/introduction.rst:39: WARNING: Block quote ends without a blank line; unexpected unindent. [docutils]
Documentation/gpu/introduction.rst:42: ERROR: Unexpected indentation. [docutils]
Documentation/gpu/introduction.rst:42: WARNING: Blank line required after table. [docutils]
Documentation/gpu/introduction.rst:43: WARNING: Line block ends without a blank line. [docutils]
Documentation/gpu/introduction.rst:44: WARNING: Block quote ends without a blank line; unexpected unindent. [docutils]
Documentation/gpu/introduction.rst:48: ERROR: Unexpected indentation. [docutils]
Documentation/gpu/introduction.rst:48: WARNING: Blank line required after table. [docutils]
Documentation/gpu/introduction.rst:48: WARNING: Inline substitution_reference start-string without end-string. [docutils]
Documentation/gpu/introduction.rst:49: WARNING: Line block ends without a blank line. [docutils]
Documentation/gpu/introduction.rst:50: WARNING: Block quote ends without a blank line; unexpected unindent. [docutils]

Please wrap the diagram above in literal code block.

Thanks.

-- 
An old man doll... just what I always wanted! - Clara
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 228 bytes
Desc: not available
URL: <https://lists.freedesktop.org/archives/dri-devel/attachments/20250523/66696384/attachment.sig>