Re: [PATCH v2] docs: document linked lists

From: Bagas Sanjaya
Date: Wed Jul 02 2025 - 22:54:22 EST


On 7/3/25 09:52, Jonathan Corbet wrote:
Bagas Sanjaya <bagasdotme@xxxxxxxxx> writes:

On Wed, Jul 02, 2025 at 10:24:47PM +0200, Nicolas Frattaroli wrote:
+In State 2, we've added Grock after the list head::
+
+ .--------------------.
+ v |
+ .--------. .-------. |
+ | clowns |---->| Grock |--'
+ '--------' '-------'

Looks like the corners are a bit imbalanced (single quotes are taller than
dots). What about using plus instead? Like:

---- >8 ----
diff --git a/Documentation/core-api/list.rst b/Documentation/core-api/list.rst
index b0586056abb04d..bf92f44d7b2d06 100644
--- a/Documentation/core-api/list.rst
+++ b/Documentation/core-api/list.rst
@@ -148,11 +148,11 @@ clarity.
In State 2, we've added Grock after the list head::
- .--------------------.
+ +--------------------+
v |

One might argue that it looks like a nice curve and should stay as-is.

This work is welcome and deserves a serious review, this wasn't it.


OK, thanks!

--
An old man doll... just what I always wanted! - Clara