linux-kernel - Re: [PATCH] drm: add overview diagram for drm stack

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <aC_nMs-hAyd8cpDJ@archie.me>
Date: Fri, 23 May 2025 10:10:42 +0700
From: Bagas Sanjaya <bagasdotme@...il.com>
To: Abdulrasaq Lawani <abdulrasaqolawani@...il.com>,
	Maarten Lankhorst <maarten.lankhorst@...ux.intel.com>,
	Maxime Ripard <mripard@...nel.org>,
	Thomas Zimmermann <tzimmermann@...e.de>,
	David Airlie <airlied@...il.com>, Simona Vetter <simona@...ll.ch>,
	Jonathan Corbet <corbet@....net>
Cc: dri-devel@...ts.freedesktop.org, linux-doc@...r.kernel.org,
	linux-kernel@...r.kernel.org
Subject: Re: [PATCH] drm: add overview diagram for drm stack

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

Download attachment "signature.asc" of type "application/pgp-signature" (229 bytes)