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 kanga.kvack.org (kanga.kvack.org [205.233.56.17]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 428D7CA0FF0 for ; Fri, 29 Aug 2025 12:18:57 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 85DA68E000C; Fri, 29 Aug 2025 08:18:56 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 80DF08E0001; Fri, 29 Aug 2025 08:18:56 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 6FCA98E000C; Fri, 29 Aug 2025 08:18:56 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0012.hostedemail.com [216.40.44.12]) by kanga.kvack.org (Postfix) with ESMTP id 5B2C88E0001 for ; Fri, 29 Aug 2025 08:18:56 -0400 (EDT) Received: from smtpin28.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id 02EB0140705 for ; Fri, 29 Aug 2025 12:18:55 +0000 (UTC) X-FDA: 83829699072.28.F6AA0C7 Received: from mgamail.intel.com (mgamail.intel.com [198.175.65.19]) by imf03.hostedemail.com (Postfix) with ESMTP id 7C1C020002 for ; Fri, 29 Aug 2025 12:18:53 +0000 (UTC) Authentication-Results: imf03.hostedemail.com; dkim=pass header.d=intel.com header.s=Intel header.b=IgB+14uY; spf=pass (imf03.hostedemail.com: domain of jani.nikula@intel.com designates 198.175.65.19 as permitted sender) smtp.mailfrom=jani.nikula@intel.com; dmarc=pass (policy=none) header.from=intel.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1756469934; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=OkTpztyu5K0pji7lFFHFbR3zLFIlVYGSxPUV/Ti6gpY=; b=EUzqVEljvTC0eqmR1vtEekQ0+uCcy3e9794GJR/J9d8uhRDrq4ejzEf6+PzStM9cB2e/8y wfXAWpLEn86z0H9sEPNPxKNo+IvudO8R8q5hX49lDOKLOZTNJn1AaDCVP2gMHIei6IdpVH Htvm6X83uNEHiZqZXWUOcjdBQj1I68Q= ARC-Authentication-Results: i=1; imf03.hostedemail.com; dkim=pass header.d=intel.com header.s=Intel header.b=IgB+14uY; spf=pass (imf03.hostedemail.com: domain of jani.nikula@intel.com designates 198.175.65.19 as permitted sender) smtp.mailfrom=jani.nikula@intel.com; dmarc=pass (policy=none) header.from=intel.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1756469934; a=rsa-sha256; cv=none; b=qdTW1zcR1Q//t9q/fBbwQ+invRgl+jzNCTF7h+DIXMdAJBoZlq70IgG5oSteKng/ruGR9m eGUhfpF0RoMNf7RduDYROZzgx8MvoppUADzhhdOpalfICo20x9bBlORT2M+oIFUyaKYBq0 yQD67d+xiOdqzQtAZHid/j2HwJE0z8Q= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1756469934; x=1788005934; h=from:to:cc:subject:in-reply-to:references:date: message-id:mime-version; bh=lmOaDJrWsALHNdIkFkPEn+1/tHhvy8ASz+0CpcTOxMQ=; b=IgB+14uYP4tZN+czHEnQpRSK6P+o4VapnrSuSBxeH31w2BWKJWrjJVBl xl2hJJXj9Tf7brn4/+q1FzF/WL39oxxUqPtrnRwaOts73UkPENPJ/fpSJ Q8BauYujvXapbi997BVNTlT/Yjsxfycx1KFVzbplWEj7kj30ErHshRktY +rFn0uKz2AV7N/XQcJFBgvVhSWfXyBqXxA7aE5cz3oK7YhMV2LQcsGLMJ wy4AgcqjVbQKrbovsaKnxpoggT9h+qyhkl+SYuGgEUd+C/ZSnCZ+UG4qP UoW2gFOBtM/3r/Sau4Lh+pqm9xvtY9Xmr2Lzjf/R3iDXjQ89p+Bp8z3XK g==; X-CSE-ConnectionGUID: 69LGFw4oRBSLfgkKbLfLdA== X-CSE-MsgGUID: ZCP3ubo2RriGy5dDr0fmGw== X-IronPort-AV: E=McAfee;i="6800,10657,11536"; a="58603837" X-IronPort-AV: E=Sophos;i="6.18,221,1751266800"; d="scan'208";a="58603837" 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-Rspamd-Server: rspam02 X-Rspamd-Queue-Id: 7C1C020002 X-Stat-Signature: 8o35awr69qs56r534f5bixqdzs84r8md X-Rspam-User: X-HE-Tag: 1756469933-738267 X-HE-Meta: U2FsdGVkX19cWGNprIC5aJrsgiIrqA3/fMyiW5hKA/QeJikXeoMRhk54GHAjQON8YjOV+JgjrKD04+vjxiJqSvVSFeTzU8+Hg3ICMbI5kKKY4sR3i28tzOj6G5LTCbxo/VaM3i0t2uJmN+joew0qgUwOLqHUeRqdvHpuaTklOzRHAQM/Ms5GDVLFC67HXjUWnLTi9J3YbQVpL/+3GBo6ycAsoY25VA17cWoOBlEUd9Iwh0+rkcz2VfZpp59Iw5FTVV+BRQF6n7EDsLEpjbGuPWL74Nzn2h04Fko+vJetPqmLxBpSoS3gOwRlegNu2pHQrktTVYqjNnakHypHRr/t5GwXRC0rAGfN/4HgBGZH4BW1ACiv1OpTZNw4kSpUXSkUBQuiThzv2+8qylsBvimMeHDeaoupzFHTrweTPLGaqZvHtMiWAMz/nyTY9AgOLLBEOs7ZQ6PNe9+7ISrWbSjTWldojmckZGhuzxDgeBFjMpkEMN+GEeL0fyIezgDTHDhu0F3TvahnTFnsy+zipauPYACGn54LlWBCVT3y3mQ9bk1+i/TwgUXxxo+VxEqYss8SSwXs4GLL2Dyegs9VlJzSW1qiz73f9CYUTy8PPYqidHIriKqH022IXLoOUseMKy2L0NZfrZOp54k6oZISGlbiIzBBDqPACa0YnfgPIO3XJI5/5Ino0lhouWaOX65HpCewF19OVnBEAlC2JUUkvk4dEtSJrCt61vVPsk0llFRlLXNifA8/Xrw8ujDtcWt3vfIQFFrAsXL5xtHT24JYXCh5b9LnvMzKw/cRQohzNxVtXSHJ3nqIcmxAJmGxKraGE26adb/Jx7j6WiZi8K28If67WXFMTcuEbRiEEtKuaDUHp3gc+9n3wF8BEjXsJYdrnukcyKSp30+EWwIvLR5YJPPdu3SZQ+0aJF7HKfmjiau7tpzXDjs18Rp4Ko27up0R+ZUh8JV+TjAGE6XFFA4lmrA /5lwyLac IoheYTGlYySoJiCfVfA4vKHFIfZZwzQ5sCXCM97RWCHrIU5KUSVUOl0mRwjhjkv4QAuIVGhz2VOsCFHrBeaSqV1hrpKzpijGy5OAueTUI0xNWyFPYqn45X15GnVRAlJNVxiEgslRQK0fjo+KLOjpyOWIA2pQmL6L/JpzZolass7MbqoMwi69rKP1DwghDt0tDJklQHE3YpQh1M3psNvsDT9ZPpEFcprWOtvFg8HzHwAlU15O0LY093eeca7m9jRKvim3iGxFrRjfzGGCTwxqbvJolkV1LsnrNjQA5x0aHKK288cGpy4W9al6JC443ChN+hTUT6FzVhDKcD9o9T2mxQYZ4M3Pa0PGPpxL36/fJ4bJNBqE= X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: 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