Re: [PATCH] Documentation: intel-pstate: Use :ref: directive for internal linking

From: Randy Dunlap
Date: Sun Nov 02 2025 - 00:56:23 EST




On 10/31/25 10:56 PM, Bagas Sanjaya wrote:
> pstate docs uses standard reST construct (`Section title`_) for
> cross-referencing sections (internal linking), rather than for external
> links. Incorrect cross-references are not caught when these are written
> in that syntax, however (fortunately docutils 0.22 raise duplicate
> target warnings that get fixed in cb908f8b0acc7e ("Documentation:
> intel_pstate: fix duplicate hyperlink target errors")).
>
> Convert the cross-references to use :ref: directive, which doesn't
> exhibit this problem.
>
> Signed-off-by: Bagas Sanjaya <bagasdotme@xxxxxxxxx>

LGTM. Thanks.

Reviewed-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
Tested-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>

> ---
> Documentation/admin-guide/pm/intel_pstate.rst | 133 +++++++++---------
> 1 file changed, 70 insertions(+), 63 deletions(-)
>

--
~Randy