From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 55DB6308F38 for ; Wed, 25 Mar 2026 20:23:55 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=45.79.88.28 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1774470236; cv=none; b=HTQ1TlidqTyub5QdjO6WXqGyliNMhJcXZZ/Zy6HTUQbCcO+de4o+bxJG5POLscYD2FNZdnoSqLdUwKvSW9jQUYOA9DoBXqSsukm2IH/8X4zQQTXPCBSm06PkavuWU+H7S22fhYfNLmKOQfnT+G9joov7Edh2mOCd0s5W3hzsUQA= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1774470236; c=relaxed/simple; bh=gyZIZccWJd1+RoPkBEpdblxcP/K2Wyaw0OsXDDGeef0=; h=From:To:Cc:Subject:In-Reply-To:References:Date:Message-ID: MIME-Version:Content-Type; b=i6rwaYTWNylF/y2YA/oW0yg+HVw/ib8+gFSRYfxrMo/Ln1lI/zMjlsnfZVQFvCs5iDK4XFz8/NXLZEmxDeRwF+pBUV8gfbG4rtXWKEQzVrq7KjFyXLMLvpdVypQchDQJFH3LFIz7j4CtHj2L297N9oOrv7h00t0fOOY/LZKILTU= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=lwn.net; spf=pass smtp.mailfrom=lwn.net; dkim=pass (2048-bit key) header.d=lwn.net header.i=@lwn.net header.b=Me96fmCK; arc=none smtp.client-ip=45.79.88.28 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=lwn.net Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=lwn.net Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=lwn.net header.i=@lwn.net header.b="Me96fmCK" DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net ADB2740C6F DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1774470234; bh=bxZXftWEtQm5fbCg6/jjJHTKniH3z3qxAtdIC32b2Ys=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=Me96fmCKavc7BjCrca0QayhdceyLSTP7YBS7pCOoy1XuW6DuKEJYcYSge/ROSHmeV vhJi8zr+Tmh7jioa8faWFS5Pg3C9KzwgYylVOjoaakVPHxmHBd4IL0UVqw5bW0unhG j8QMBTL5qzDIL/LhLbE23XYJpmKfxTNVCGrkICZxlzdXlGwTe4RFyYtb0HCLn8cs+f e/4QcpYW5k/0Ivy7ouhHlDHM+MVM2T5khftceM6pKHosQuSAGZhz/vG2uPWdvM7uiK Rx1655AEy1joobYKiNa0lcH7G3JXIfjWPZWjiEYIWKEp8Nj2FShs8J6azc4fLhmqqh c93fnUhxfwoqQ== Received: from localhost (unknown [IPv6:2601:280:4600:27b::1fe]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (prime256v1) server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id ADB2740C6F; Wed, 25 Mar 2026 20:23:54 +0000 (UTC) From: Jonathan Corbet To: Kevin Brodsky , linux-doc@vger.kernel.org Cc: Shuah Khan , Konstantin Ryabitsev , Mauro Carvalho Chehab Subject: Re: Invalid link generation for equations In-Reply-To: <9b320e77-9acf-4f0d-8c52-6e1fc3a8cf53@arm.com> References: <9b320e77-9acf-4f0d-8c52-6e1fc3a8cf53@arm.com> Date: Wed, 25 Mar 2026 14:23:53 -0600 Message-ID: <87se9nejza.fsf@trenco.lwn.net> Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable [Adding Konstantin and Mauro, in case anybody has any thoughts...] Kevin Brodsky writes: > Hi, > > I have noticed that links to equation images are not generated correctly > on docs.kernel.org. For instance, Documentation/mm/memory-model.rst has: > > =C2=A0 =C2=A0 .. math:: > =C2=A0 =C2=A0=C2=A0 > =C2=A0 =C2=A0 =C2=A0 =C2=A0NR\_MEM\_SECTIONS =3D 2 ^ {(MAX\_PHYSMEM\_BITS= - SECTION\_SIZE\_BITS)} > > The generated HTML [1] shows the source code instead of the rendered > equation because the link to the image [2] is broken. [3] does however > exist. The issue seems to be that the link is relative to the root, even > though we are in a subfolder (mm/ here). > > Given my non-existent knowledge of Sphinx I have no idea what the fix > might be, but I thought I'd report this at least :) > > - Kevin > > [1] https://docs.kernel.org/mm/memory-model.html#sparsemem > [2] > https://docs.kernel.org/mm/_images/math/d99368220bfdedf1a888b1c09eb7236a8= c87d079.png > [3] > https://docs.kernel.org/_images/math/d99368220bfdedf1a888b1c09eb7236a8c87= d079.png OK, so this is more than passing strange...I can't reproduce that problem locally. The HTML I get is: