Re: [PATCH 1/3] Documentation/gpu: add dedicated documentation for Intel display

[Jani Nikula <jani.nikula@intel.com>]

On Fri, 08 May 2026, Randy Dunlap <rdunlap@infradead.org> wrote:
> On 5/8/26 3:20 AM, Jani Nikula wrote:
>> diff --git a/Documentation/gpu/intel-display/index.rst b/Documentation/gpu/intel-display/index.rst
>> new file mode 100644
>> index 000000000000..8d40363b8f90
>> --- /dev/null
>> +++ b/Documentation/gpu/intel-display/index.rst
>> @@ -0,0 +1,40 @@
>> +.. SPDX-License-Identifier: MIT
>> +.. Copyright © 2026 Intel Corporation
>> +
>> +.. _drm/intel-display:
>> +
>> +====================
>> +Intel Display Driver
>> +====================
>> +
>> +The Intel display driver provides the display, or :ref:`drm-kms`, support for
>> +both the :ref:`drm/xe <drm/xe>` and :ref:`drm/i915 <drm/i915>` Intel GPU
>> +drivers.
>> +
>> +The source code currently resides under ``drivers/gpu/drm/i915/display`` due to
>> +historical reasons, and it's compiled separately into both drm/xe and drm/i915
>> +kernel modules.
>> +
>> +The drm/xe and drm/i915 drivers are the "core" or "parent" drivers for display,
>> +as they initialize and own the drm device, and pass that on to the display
>> +driver. The display driver isn't an independent driver in that sense.
>> +
>> +.. toctree::
>> +   :maxdepth: 1
>> +   :caption: Detailed display topics
>> +
>> +   async-flip
>> +   audio
>> +   cdclk
>> +   dmc
>> +   dpio
>> +   dpll
>> +   drrs
>> +   dsb
>> +   fbc
>> +   fifo-underrun
>> +   frontbuffer
>> +   hotplug
>> +   plane
>> +   psr
>> +   vbt
>
> Is this in almost-alphabetical order or just random?  :)

The above list is alphabetical, but the generated output does seem to be
more random due to the headings. This is in need of better organization
anyway, and this is just a step in the right direction, so I'll roll
with this.

> Tested-by: Randy Dunlap <rdunlap@infradead.org>

Thanks for the reviews and acks and testing, pushed to drm-intel-next.

BR,
Jani.


-- 
Jani Nikula, Intel