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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <d5584bfb-d138-451b-96e8-02347886349f@infradead.org>
Date: Sat, 1 Nov 2025 21:56:05 -0700
From: Randy Dunlap <rdunlap@...radead.org>
To: Bagas Sanjaya <bagasdotme@...il.com>,
 Linux Kernel Mailing List <linux-kernel@...r.kernel.org>,
 Linux Documentation <linux-doc@...r.kernel.org>,
 Linux Power Management <linux-pm@...r.kernel.org>
Cc: "Rafael J. Wysocki" <rafael@...nel.org>,
 Viresh Kumar <viresh.kumar@...aro.org>, Jonathan Corbet <corbet@....net>
Subject: Re: [PATCH] Documentation: intel-pstate: Use :ref: directive for
 internal linking

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@...il.com>

LGTM. Thanks.

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

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

-- 
~Randy