From 0819f17b2d40517a06e33474dcdb69d7be0a7e57 Mon Sep 17 00:00:00 2001
From: Seungmin Kim <8457324+ehfd@users.noreply.github.com>
Date: Sat, 22 Aug 2026 17:17:51 +0900
Subject: [PATCH] fix: clarify the graphics and display driver capabilities

Signed-off-by: Seungmin Kim <8457324+ehfd@users.noreply.github.com>
---
 container-toolkit/docker-specialized.md | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/container-toolkit/docker-specialized.md b/container-toolkit/docker-specialized.md
index 4d134b0a9..7723de445 100644
--- a/container-toolkit/docker-specialized.md
+++ b/container-toolkit/docker-specialized.md
@@ -174,14 +174,14 @@ The following table describes the supported driver capabilities:
       - Description
 
     * - ``compute``
-      - Required for CUDA and OpenCL applications. When present on the host,
+      - required for CUDA and OpenCL applications. When present on the host,
         the NVIDIA OpenCL ICD file is also available in the container.
 
     * - ``compat32``
       - required for running 32-bit applications.
 
     * - ``graphics``
-      - Required for running OpenGL, EGL, and Vulkan applications.
+      - required for rendering OpenGL, EGL, and Vulkan applications.
 
     * - ``utility``
       - required for using ``nvidia-smi`` and NVML.
@@ -190,9 +190,15 @@ The following table describes the supported driver capabilities:
       - required for using the Video Codec SDK.
 
     * - ``display``
-      - required for leveraging X11 display.
+      - required for displaying X11 or Wayland windows. Implies ``graphics``.
 ```
 
+:::{note}
+`NVIDIA_DRIVER_CAPABILITIES` replaces the default capabilities rather than adding to them, so list every
+capability your application needs. An application that displays 3D rendered output on X11 or Wayland requires
+`compute,graphics,display`, for instance.
+:::
+
 For example, to allow usage of CUDA and NVML, specify the `compute` and `utility` capabilities:
 
 > ```console