From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id E9E9ECA0FFD for ; Mon, 1 Sep 2025 07:03:19 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id F1DAD10E389; Mon, 1 Sep 2025 07:03:11 +0000 (UTC) Authentication-Results: gabe.freedesktop.org; dkim=pass (2048-bit key; unprotected) header.d=intel.com header.i=@intel.com header.b="nBFHYsZi"; dkim-atps=neutral Received: from mgamail.intel.com (mgamail.intel.com [198.175.65.19]) by gabe.freedesktop.org (Postfix) with ESMTPS id D38DB10EBA5 for ; Fri, 29 Aug 2025 12:18:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1756469932; x=1788005932; h=from:to:cc:subject:in-reply-to:references:date: message-id:mime-version; bh=lmOaDJrWsALHNdIkFkPEn+1/tHhvy8ASz+0CpcTOxMQ=; b=nBFHYsZiR4JIQfBW2C07r10Tzqbw+7dnjZvy5SFejdWcvdj/u/zvAJhX H/IxgtnZvvx4PPqF7ustphlfl/PHeOFQQn97OX0mJy6QCM4aAzecROy0u mvJyNR7NoSJ1ryLS9PUmIyhDIdbQJULpv7Jt3pk8Qz6SVzTIZyL35ZCOQ 2Eqa1723BObm+EBnTTNzenSaBOBlN3Gp3Vh9mKITuP9+P78P9y7P0ilaC 0YRUfVq7jXwpkoJ2BE6YC/0RUcKsLLXGSQJ9Gnnh8UJFyeCeoLedbiAlI G2zi8d01a8cVC1GcfRPozxTroKRNTb9P7bKoNbnlqWAEB+eNCJ2Fu9XCV g==; X-CSE-ConnectionGUID: if1wBF5wT9yWKtjkgksBvg== X-CSE-MsgGUID: WL6XDoFuR6iDWGWOK5fwDA== X-IronPort-AV: E=McAfee;i="6800,10657,11536"; a="58603806" X-IronPort-AV: E=Sophos;i="6.18,221,1751266800"; d="scan'208";a="58603806" Received: from fmviesa009.fm.intel.com ([10.60.135.149]) by orvoesa111.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 29 Aug 2025 05:18:51 -0700 X-CSE-ConnectionGUID: FceyOGKfTMK8J/ArNXLz6w== X-CSE-MsgGUID: nahg4MG6QSGDgmwgF/j0Ug== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.18,221,1751266800"; d="scan'208";a="170753940" Received: from hrotuna-mobl2.ger.corp.intel.com (HELO localhost) ([10.245.246.58]) by fmviesa009-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 29 Aug 2025 05:18:22 -0700 From: Jani Nikula To: Bagas Sanjaya , Linux Kernel Mailing List , Linux Documentation , Linux DAMON , Linux Memory Management List , Linux Power Management , Linux Block Devices , Linux BPF , Linux Kernel Workflows , Linux KASAN , Linux Devicetree , Linux fsverity , Linux MTD , Linux DRI Development , Linux Kernel Build System , Linux Networking , Linux Sound Cc: Thomas Gleixner , Borislav Petkov , Peter Zijlstra , Josh Poimboeuf , Pawan Gupta , Jonathan Corbet , SeongJae Park , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Huang Rui , "Gautham R. Shenoy" , Mario Limonciello , Perry Yuan , Jens Axboe , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Dwaipayan Ray , Lukas Bulwahn , Joe Perches , Andrey Ryabinin , Alexander Potapenko , Andrey Konovalov , Dmitry Vyukov , Vincenzo Frascino , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Eric Biggers , tytso@mit.edu, Richard Weinberger , Zhihao Cheng , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Nathan Chancellor , Nicolas Schier , Ingo Molnar , Will Deacon , Boqun Feng , Waiman Long , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Shay Agroskin , Arthur Kiyanovski , David Arinzon , Saeed Bishara , Andrew Lunn , Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , Thomas =?utf-8?Q?Wei=C3=9Fschuh?= , Masahiro Yamada Subject: Re: [PATCH 00/14] Internalize www.kernel.org/doc cross-reference In-Reply-To: <20250829075524.45635-1-bagasdotme@gmail.com> Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo References: <20250829075524.45635-1-bagasdotme@gmail.com> Date: Fri, 29 Aug 2025 15:18:20 +0300 Message-ID: <437912a24e94673c2355a2b7b50c3c4b6f68fcc6@intel.com> MIME-Version: 1.0 Content-Type: text/plain X-Mailman-Approved-At: Mon, 01 Sep 2025 07:02:45 +0000 X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" On Fri, 29 Aug 2025, Bagas Sanjaya wrote: > Cross-references to other docs (so-called internal links) are typically > done following Documentation/doc-guide/sphinx.rst: either simply > write the target docs (preferred) or use :doc: or :ref: reST directives > (for use-cases like having anchor text or cross-referencing sections). > In some places, however, links to https://www.kernel.org/doc > are used instead (outgoing, external links), owing inconsistency as > these requires Internet connection only to see docs that otherwise > can be accessed locally (after building with ``make htmldocs``). > > Convert such external links to internal links. Note that this does not > cover docs.kernel.org links nor touching Documentation/tools (as > docs containing external links are in manpages). FWIW, I'd much prefer using :ref: on rst anchors (that automatically pick the link text from the target heading) instead of manually adding link texts and file references. i.e. .. _some_target: Heading After Some Target ========================= See :ref:`some_target`. Will generate "See Heading After Some Target". BR, Jani. -- Jani Nikula, Intel