[PATCH 1/1] gpu: add todo entry for device address type wrappers

[John Hubbard]

The SizeConstants trait provides SZ_* size constants for 32-bit,
64-bit, and pointer-sized integers. Device-centric DRM APIs such
as GPU VM management and buddy allocators could benefit from newtype
wrappers around those integer types for device addresses and sizes.
Add a todo entry to track designing those wrappers and a marker trait
for use as a generic bound.

Suggested-by: Danilo Krummrich <dakr@xxxxxxxxxx>
Signed-off-by: John Hubbard <jhubbard@xxxxxxxxxx>
---
 Documentation/gpu/todo.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/Documentation/gpu/todo.rst b/Documentation/gpu/todo.rst
index cdddf8db35f5..d7dbe8b298ce 100644
--- a/Documentation/gpu/todo.rst
+++ b/Documentation/gpu/todo.rst
@@ -686,6 +686,20 @@ Contact: Thomas Zimmermann <tzimmermann@xxxxxxx>
 
 Level: Advanced
 
+Device address type wrappers
+-----------------------------
+
+The ``SizeConstants`` trait provides ``SZ_*`` constants as associated constants
+on ``u32``, ``u64``, and ``usize``. Device-centric APIs such as GPU VM
+management and buddy allocators could benefit from newtype wrappers around these
+integer types to represent device addresses and sizes. A separate marker trait
+could then serve as a generic bound for those wrappers. See the `original
+discussion <https://lore.kernel.org/all/DHJJJNP5T5FZ.2HWBMOEEKH9ZR@xxxxxxxxxx/>`_.
+
+Contact: Danilo Krummrich <dakr@xxxxxxxxxx>
+
+Level: Intermediate
+
 Better Testing
 ==============
 
-- 
2.54.0