Re: [PATCH v5 6/6] drm/doc: Define KMS atomic state set

From: Simon Ser
Date: Wed Jul 12 2023 - 09:30:23 EST


On Saturday, July 8th, 2023 at 00:40, André Almeida <andrealmeid@xxxxxxxxxx> wrote:

> +KMS atomic state
> +================
> +
> +An atomic commit can change multiple KMS properties in an atomic fashion,
> +without ever applying intermediate or partial state changes. Either the whole
> +commit succeeds or fails, and it will never be applied partially. This is the
> +fundamental improvement of the atomic API over the older non-atomic API which is
> +referred to as the "legacy API". Applying intermediate state could unexpectedly
> +fail, cause visible glitches, or delay reaching the final state.
> +
> +An atomic commit can be flagged with DRM_MODE_ATOMIC_TEST_ONLY, which means the

Can we linkify these #defines? This can be done like so:

… flagged with :c:macro:`DRM_MODE_ATOMIC_TEST_ONLY`, which means …

This should create a link to the docs for this flag.