From: Rodrigo Vivi <rodrigo.vivi@intel.com>
To: Jani Nikula <jani.nikula@intel.com>
Cc: intel-gfx@lists.freedesktop.org, intel-xe@lists.freedesktop.org,
dri-devel@lists.freedesktop.org, linux-doc@vger.kernel.org,
"Matthew Brost" <matthew.brost@intel.com>,
"Thomas Hellström" <thomas.hellstrom@linux.intel.com>,
joonas.lahtinen@linux.intel.com, tursulin@ursulin.net
Subject: Re: [PATCH 2/3] Documentation/gpu: use === for Intel display section heading underlines
Date: Fri, 8 May 2026 09:15:42 -0400 [thread overview]
Message-ID: <af3h_ljWsBUMY5Um@intel.com> (raw)
In-Reply-To: <f49968792220ca3ff24efde813550850340d092e.1778235406.git.jani.nikula@intel.com>
On Fri, May 08, 2026 at 01:20:48PM +0300, Jani Nikula wrote:
> Prefer to use === instead of --- for top level section heading
> underlines to allow using the latter for sub-headings later.
>
> While at it, fix the underline lenghts where needed.
>
> Signed-off-by: Jani Nikula <jani.nikula@intel.com>
Reviewed-by: Rodrigo Vivi <rodrigo.vivi@intel.com>
> ---
> Documentation/gpu/intel-display/async-flip.rst | 2 +-
> Documentation/gpu/intel-display/audio.rst | 4 ++--
> Documentation/gpu/intel-display/cdclk.rst | 2 +-
> Documentation/gpu/intel-display/dmc.rst | 6 +++---
> Documentation/gpu/intel-display/dpio.rst | 2 +-
> Documentation/gpu/intel-display/dpll.rst | 2 +-
> Documentation/gpu/intel-display/drrs.rst | 2 +-
> Documentation/gpu/intel-display/dsb.rst | 2 +-
> Documentation/gpu/intel-display/fbc.rst | 2 +-
> Documentation/gpu/intel-display/fifo-underrun.rst | 2 +-
> Documentation/gpu/intel-display/frontbuffer.rst | 2 +-
> Documentation/gpu/intel-display/hotplug.rst | 2 +-
> Documentation/gpu/intel-display/plane.rst | 2 +-
> Documentation/gpu/intel-display/psr.rst | 2 +-
> Documentation/gpu/intel-display/vbt.rst | 2 +-
> 15 files changed, 18 insertions(+), 18 deletions(-)
>
> diff --git a/Documentation/gpu/intel-display/async-flip.rst b/Documentation/gpu/intel-display/async-flip.rst
> index e4ae4012efc5..40f93e885bb7 100644
> --- a/Documentation/gpu/intel-display/async-flip.rst
> +++ b/Documentation/gpu/intel-display/async-flip.rst
> @@ -2,7 +2,7 @@
> .. Copyright © 2026 Intel Corporation
>
> Asynchronous Page Flip
> -----------------------
> +======================
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_display.c
> :doc: asynchronous flip implementation
> diff --git a/Documentation/gpu/intel-display/audio.rst b/Documentation/gpu/intel-display/audio.rst
> index 7d3c1b514b0e..eef95df75f8d 100644
> --- a/Documentation/gpu/intel-display/audio.rst
> +++ b/Documentation/gpu/intel-display/audio.rst
> @@ -2,7 +2,7 @@
> .. Copyright © 2026 Intel Corporation
>
> High Definition Audio
> ----------------------
> +=====================
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_audio.c
> :doc: High Definition Audio over HDMI and Display Port
> @@ -14,7 +14,7 @@ High Definition Audio
> :internal:
>
> Intel HDMI LPE Audio Support
> -----------------------------
> +============================
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_lpe_audio.c
> :doc: LPE Audio integration for HDMI or DP playback
> diff --git a/Documentation/gpu/intel-display/cdclk.rst b/Documentation/gpu/intel-display/cdclk.rst
> index 231b22a733e7..a66d623b0ec9 100644
> --- a/Documentation/gpu/intel-display/cdclk.rst
> +++ b/Documentation/gpu/intel-display/cdclk.rst
> @@ -2,7 +2,7 @@
> .. Copyright © 2026 Intel Corporation
>
> Display clocks
> ---------------
> +==============
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_cdclk.c
> :doc: CDCLK / RAWCLK
> diff --git a/Documentation/gpu/intel-display/dmc.rst b/Documentation/gpu/intel-display/dmc.rst
> index 2fcdbd457d79..4368da4c7048 100644
> --- a/Documentation/gpu/intel-display/dmc.rst
> +++ b/Documentation/gpu/intel-display/dmc.rst
> @@ -4,7 +4,7 @@
> .. _drm/intel-display/dmc:
>
> DMC Firmware Support
> ---------------------
> +====================
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_dmc.c
> :doc: DMC Firmware Support
> @@ -14,13 +14,13 @@ DMC Firmware Support
>
>
> DMC Flip Queue
> ---------------------
> +==============
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_flipq.c
> :doc: DMC Flip Queue
>
> DMC wakelock support
> ---------------------
> +====================
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_dmc_wl.c
> :doc: DMC wakelock support
> diff --git a/Documentation/gpu/intel-display/dpio.rst b/Documentation/gpu/intel-display/dpio.rst
> index 32e6f299f256..84d92ac162f8 100644
> --- a/Documentation/gpu/intel-display/dpio.rst
> +++ b/Documentation/gpu/intel-display/dpio.rst
> @@ -2,7 +2,7 @@
> .. Copyright © 2026 Intel Corporation
>
> DPIO
> -----
> +====
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_dpio_phy.c
> :doc: DPIO
> diff --git a/Documentation/gpu/intel-display/dpll.rst b/Documentation/gpu/intel-display/dpll.rst
> index 35e8168ccfb9..c750352e0ae5 100644
> --- a/Documentation/gpu/intel-display/dpll.rst
> +++ b/Documentation/gpu/intel-display/dpll.rst
> @@ -2,7 +2,7 @@
> .. Copyright © 2026 Intel Corporation
>
> Display PLLs
> -------------
> +============
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_dpll_mgr.c
> :doc: Display PLLs
> diff --git a/Documentation/gpu/intel-display/drrs.rst b/Documentation/gpu/intel-display/drrs.rst
> index adb413f300f1..a5aaba63d6b9 100644
> --- a/Documentation/gpu/intel-display/drrs.rst
> +++ b/Documentation/gpu/intel-display/drrs.rst
> @@ -2,7 +2,7 @@
> .. Copyright © 2026 Intel Corporation
>
> Display Refresh Rate Switching (DRRS)
> --------------------------------------
> +=====================================
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_drrs.c
> :doc: Display Refresh Rate Switching (DRRS)
> diff --git a/Documentation/gpu/intel-display/dsb.rst b/Documentation/gpu/intel-display/dsb.rst
> index cbd40b0a4e7b..857aca59995a 100644
> --- a/Documentation/gpu/intel-display/dsb.rst
> +++ b/Documentation/gpu/intel-display/dsb.rst
> @@ -2,7 +2,7 @@
> .. Copyright © 2026 Intel Corporation
>
> Display State Buffer
> ---------------------
> +====================
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_dsb.c
> :doc: DSB
> diff --git a/Documentation/gpu/intel-display/fbc.rst b/Documentation/gpu/intel-display/fbc.rst
> index 40f9d16bdebd..de9e19021f50 100644
> --- a/Documentation/gpu/intel-display/fbc.rst
> +++ b/Documentation/gpu/intel-display/fbc.rst
> @@ -2,7 +2,7 @@
> .. Copyright © 2026 Intel Corporation
>
> Frame Buffer Compression (FBC)
> -------------------------------
> +==============================
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_fbc.c
> :doc: Frame Buffer Compression (FBC)
> diff --git a/Documentation/gpu/intel-display/fifo-underrun.rst b/Documentation/gpu/intel-display/fifo-underrun.rst
> index 50731f3a1f03..5d8f01921506 100644
> --- a/Documentation/gpu/intel-display/fifo-underrun.rst
> +++ b/Documentation/gpu/intel-display/fifo-underrun.rst
> @@ -2,7 +2,7 @@
> .. Copyright © 2026 Intel Corporation
>
> Display FIFO Underrun Reporting
> --------------------------------
> +===============================
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_fifo_underrun.c
> :doc: fifo underrun handling
> diff --git a/Documentation/gpu/intel-display/frontbuffer.rst b/Documentation/gpu/intel-display/frontbuffer.rst
> index 2a1bc63ba6b4..7ae38e0827bf 100644
> --- a/Documentation/gpu/intel-display/frontbuffer.rst
> +++ b/Documentation/gpu/intel-display/frontbuffer.rst
> @@ -2,7 +2,7 @@
> .. Copyright © 2026 Intel Corporation
>
> Frontbuffer Tracking
> ---------------------
> +====================
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_frontbuffer.c
> :doc: frontbuffer tracking
> diff --git a/Documentation/gpu/intel-display/hotplug.rst b/Documentation/gpu/intel-display/hotplug.rst
> index 4cd9dd5ac8fc..f33bc0087c27 100644
> --- a/Documentation/gpu/intel-display/hotplug.rst
> +++ b/Documentation/gpu/intel-display/hotplug.rst
> @@ -2,7 +2,7 @@
> .. Copyright © 2026 Intel Corporation
>
> Hotplug
> --------
> +=======
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_hotplug.c
> :doc: Hotplug
> diff --git a/Documentation/gpu/intel-display/plane.rst b/Documentation/gpu/intel-display/plane.rst
> index 41cf6571aab0..59932a82051b 100644
> --- a/Documentation/gpu/intel-display/plane.rst
> +++ b/Documentation/gpu/intel-display/plane.rst
> @@ -2,7 +2,7 @@
> .. Copyright © 2026 Intel Corporation
>
> Atomic Plane Helpers
> ---------------------
> +====================
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_plane.c
> :doc: atomic plane helpers
> diff --git a/Documentation/gpu/intel-display/psr.rst b/Documentation/gpu/intel-display/psr.rst
> index 134c905f500e..63e56abcdd56 100644
> --- a/Documentation/gpu/intel-display/psr.rst
> +++ b/Documentation/gpu/intel-display/psr.rst
> @@ -2,7 +2,7 @@
> .. Copyright © 2026 Intel Corporation
>
> Panel Self Refresh PSR (PSR/SRD)
> ---------------------------------
> +================================
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_psr.c
> :doc: Panel Self Refresh (PSR/SRD)
> diff --git a/Documentation/gpu/intel-display/vbt.rst b/Documentation/gpu/intel-display/vbt.rst
> index bbc7ee183f1b..be69f7fd7b39 100644
> --- a/Documentation/gpu/intel-display/vbt.rst
> +++ b/Documentation/gpu/intel-display/vbt.rst
> @@ -2,7 +2,7 @@
> .. Copyright © 2026 Intel Corporation
>
> Video BIOS Table (VBT)
> -----------------------
> +======================
>
> .. kernel-doc:: drivers/gpu/drm/i915/display/intel_bios.c
> :doc: Video BIOS Table (VBT)
> --
> 2.47.3
>
next prev parent reply other threads:[~2026-05-08 13:15 UTC|newest]
Thread overview: 16+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-05-08 10:20 [PATCH 0/3] drm/i915: reorganize display documentation Jani Nikula
2026-05-08 10:20 ` [PATCH 1/3] Documentation/gpu: add dedicated documentation for Intel display Jani Nikula
2026-05-08 13:15 ` Rodrigo Vivi
2026-05-08 18:22 ` Randy Dunlap
2026-05-11 7:41 ` Jani Nikula
2026-05-08 10:20 ` [PATCH 2/3] Documentation/gpu: use === for Intel display section heading underlines Jani Nikula
2026-05-08 13:15 ` Rodrigo Vivi [this message]
2026-05-08 18:22 ` Randy Dunlap
2026-05-08 10:20 ` [PATCH 3/3] Documentation/gpu: add remaining DOC: comments to Intel display documentation Jani Nikula
2026-05-08 13:19 ` Rodrigo Vivi
2026-05-08 10:29 ` ✗ CI.checkpatch: warning for drm/i915: reorganize " Patchwork
2026-05-08 10:32 ` ✓ CI.KUnit: success " Patchwork
2026-05-08 11:07 ` ✓ i915.CI.BAT: " Patchwork
2026-05-08 11:38 ` ✓ Xe.CI.BAT: " Patchwork
2026-05-08 23:38 ` ✗ Xe.CI.FULL: failure " Patchwork
2026-05-09 8:04 ` ✓ i915.CI.Full: success " Patchwork
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=af3h_ljWsBUMY5Um@intel.com \
--to=rodrigo.vivi@intel.com \
--cc=dri-devel@lists.freedesktop.org \
--cc=intel-gfx@lists.freedesktop.org \
--cc=intel-xe@lists.freedesktop.org \
--cc=jani.nikula@intel.com \
--cc=joonas.lahtinen@linux.intel.com \
--cc=linux-doc@vger.kernel.org \
--cc=matthew.brost@intel.com \
--cc=thomas.hellstrom@linux.intel.com \
--cc=tursulin@ursulin.net \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.