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: <CAJZ5v0hNEpb=k+bG5x7A2=j3E2tLKAMNcvewnRAa0RRdebtzgw@mail.gmail.com>
Date: Mon, 3 Nov 2025 19:22:16 +0100
From: "Rafael J. Wysocki" <rafael@...nel.org>
To: Randy Dunlap <rdunlap@...radead.org>, Bagas Sanjaya <bagasdotme@...il.com>
Cc: Linux Kernel Mailing List <linux-kernel@...r.kernel.org>, 
	Linux Documentation <linux-doc@...r.kernel.org>, 
	Linux Power Management <linux-pm@...r.kernel.org>, Viresh Kumar <viresh.kumar@...aro.org>, 
	Jonathan Corbet <corbet@....net>
Subject: Re: [PATCH] Documentation: intel-pstate: Use :ref: directive for
 internal linking

On Sun, Nov 2, 2025 at 5:56 AM Randy Dunlap <rdunlap@...radead.org> wrote:
>
>
>
> 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>

Applied as 6.19 material, thanks!