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]) by smtp.lore.kernel.org (Postfix) with ESMTP id 109E8C61D97 for ; Sun, 29 Jan 2023 07:50:40 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 83FE46B0074; Sun, 29 Jan 2023 02:50:40 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 7C7726B0075; Sun, 29 Jan 2023 02:50:40 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 5F1E56B0078; Sun, 29 Jan 2023 02:50:40 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id 4DE6C6B0074 for ; Sun, 29 Jan 2023 02:50:40 -0500 (EST) Received: from smtpin25.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay09.hostedemail.com (Postfix) with ESMTP id 1E7EA803C4 for ; Sun, 29 Jan 2023 07:50:40 +0000 (UTC) X-FDA: 80407064640.25.B1F383D Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by imf21.hostedemail.com (Postfix) with ESMTP id 42FAA1C000B for ; Sun, 29 Jan 2023 07:50:38 +0000 (UTC) Authentication-Results: imf21.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=XBiPPIlM; spf=pass (imf21.hostedemail.com: domain of rppt@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=rppt@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1674978638; a=rsa-sha256; cv=none; b=imaM9Z8XyXNfj9KpUVue2lWGgoaHpRfDpQD8vb1nDWFWbv4afy1tLqNbxnreeCD+Xu5uh0 n/LHHf3Hs98EVyhLzOqFAbUs2eXoMhalcjiY8dS+os0R61PuVdCRITAF3khC550w3k+Brl Ecvw/xyDOstn38VaKJFhueFyU3KoTvg= ARC-Authentication-Results: i=1; imf21.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=XBiPPIlM; spf=pass (imf21.hostedemail.com: domain of rppt@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=rppt@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1674978638; 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-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=3n3oz1ZKwbQzUB44kxTM9Yn6IGbIg8ZcylAbbpQ0pIA=; b=742RrUQi1Zyjs/Ud9iyU7Gqfcym7a7rQX0SzN8taZr4sG6xL28wBTjMZOvbdeQ8Lw3E/Db moWegYPGX7S+z4+PCifDCVDH9E0WBqT0BilolxvyhqlzbF//L5c1GYXmckzaIGrxwv8Qsv 78MoE0j7JF19XeSxUyJH3fgVyWsar0o= Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id A3A49B80C69; Sun, 29 Jan 2023 07:50:36 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 8D082C4339B; Sun, 29 Jan 2023 07:50:33 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1674978635; bh=xo0XfQEBGUn7tJDASw7xd+ynPvHY4wSjZm8sVyCBFCI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=XBiPPIlMlpsnSL4rcGcgwM1q3fhQDDKuaCySvjXM1lLfA1eTK92zG7BpPvE7oL+qL 1Iq0QvjmhbSK93LoK7dcelzTwVItoRhQiraRKT0gfCDRdOOXkEDINSsGMT+2uXPHC2 2QuAquN9yg396w7g900CBIIWS47xBJ1QhiDlA1DjaWSvf6V4x2J+FnmqJjz+eeOYA2 BOg1BwUaGBW5J1G0yDb6WQjJB1aEjbQPIsJ57mEhJG+OzwPAqz9W2Cw1OxaL9Vi1VC QIzJyXa+jOAT/U8Ft9ShqbithtGWVReWcYSruFcv4NEfTtG86DythIYCfeHDl1V5/5 6nO7Fa25x0aqw== From: Mike Rapoport To: Jonathan Corbet Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org, "Mike Rapoport (IBM)" Subject: [PATCH 2/2] docs/mm: remove useless markup Date: Sun, 29 Jan 2023 09:50:18 +0200 Message-Id: <20230129075018.207678-3-rppt@kernel.org> X-Mailer: git-send-email 2.35.1 In-Reply-To: <20230129075018.207678-1-rppt@kernel.org> References: <20230129075018.207678-1-rppt@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspam-User: X-Rspamd-Queue-Id: 42FAA1C000B X-Rspamd-Server: rspam01 X-Stat-Signature: uxawq7w7y6wahycibadm53o15swhfeij X-HE-Tag: 1674978638-360763 X-HE-Meta: U2FsdGVkX18bstLQZLzpFTGk/RaPDoVpalNY+02Aeftfib/PrEWNV/KRQyjadlGhgKAaXIay1nMKNsajZkfWrpZlLXMNUPf5AyqbTnB/B/1kldMnClLRTJKFB32GqRkvfwV8I29fK+5fA116v04ChhRu+QwIQEn8ENX1vrR1UEdtZsJvgRIISCVg6UgAm96Z02kviNykrlsJGx7ENY7M06J4nd/jreEpZ7nhzEuaG8aSqELWU0eEDUHTd6ZqG+jIhA1q/4UpJjFx8ntw96D9MdZ/FXdQjHboO8IQQK4EuKHYnUfQXz+ObbTQd2b/t/hmI75QGsHn7JEKZdcD3igv2mO8dREabUWwpOIebktDBvRMcDfvFUhteBbUJUSk7RxFSAzuRQlA6y8V71IDOYZq15WLWE5oNNGIv5B++xfUX2dlfKXH28OTJHz28i+NQgBRK6BU6JzxUVlHbC7jFbfXvty/w6VM6G9FCbMU3058O4h6+YLw8dycCkNLMouhRvZkSF+28X0RbT5Lde+D1pmsI4KQkmYykhszeW0JVQYiUE87bX2nCqleHY+r2/SdevOnNdd0zu1NmEPsw0u8ldo8Sel6XEwrBkO3qy3aR3QKsQTNkTAv8lshenfYuhXpZ8qncQB5qFXW2Ms+SzBN15pMsA07ypQeHkjTo5hG5U6FRoSKuKoBHlchU752W2qDfmFDbD9JnPAGRP9mjsmeP0mHbazJcX0VLoryZQmpf9FJmjULZlo0equvG0yTdccVhoIE1elnSw2AVNVTs9yXFMAoJi0qlYik8W6BvzNbaUDQyDFucFrtTMt5OgmDuE2Zd3YzBu97lwtEffPbRel3j7Gg1UwPXYwEY+fmm/EZAIO1YnOkCQ3hhFm4FG7Edm1GcAo12oHEFfHSO5rEauN3mkFV/PffRs0cMTK2jUSgnkv17sWNVGlRR3rrXKxFr3yvkUZwWldgwsbyQ0evu0hDKty BPSE6KqG xtZyIb2zf8TBI79QZzScfSrrW82VkLA6uKXGMpqkgx/y5Dc8PFKOJvDA/JoKzlKvQyaybeej02fDDQcN3ev0uLyuKOQe0edehWM0zv+lX/YQAqbdDJYZv7KzHM5nAX7pxxs1kiSMK47iOaiFYx+fZVFWb5FKL4/Qa6+9gYZgkfu8DTJ9eWfs7RM05FONiPw4XSQpTKya3xUePkwq9O5aLhM/c+6hj1yhJNFmkBUan5jzWDvDoNzuipmix3NRiN//Gx67gDWOGoKYHgiHw2C8VY9MqNZ8+Esez/VpbhlTaPldWjvqpK2S4jmsRAtgAk+umIAd9ZXFeD8fDRCsxjgRNv/9r11KBBbev2KYFCw+4oXJMFuk6z6bDslKomTaSLRzsXcLZ9lyDydOqkAkCL7/L3swfolSYfSir01EJfV/bYgINlDrw/g9F7/HNbI52ujNfZGnnv/qTX2Vg/Gy6JF282BSVBA== 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: From: "Mike Rapoport (IBM)" It is enough to use a file name to cross-reference another rst document. Jon says: The right things will happen in the HTML output, readers of the plain-text will know immediately where to go, and we don't have to add the label clutter. Drop reference markup and unnecessary labels and use plain file names. Signed-off-by: Mike Rapoport (IBM) --- Documentation/mm/active_mm.rst | 2 -- Documentation/mm/arch_pgtable_helpers.rst | 2 -- Documentation/mm/balance.rst | 2 -- Documentation/mm/free_page_reporting.rst | 2 -- Documentation/mm/frontswap.rst | 2 -- Documentation/mm/highmem.rst | 2 -- Documentation/mm/hmm.rst | 4 +--- Documentation/mm/hugetlbfs_reserv.rst | 4 +--- Documentation/mm/hwpoison.rst | 2 -- Documentation/mm/ksm.rst | 4 +--- Documentation/mm/memory-model.rst | 2 -- Documentation/mm/mmu_notifier.rst | 2 -- Documentation/mm/numa.rst | 4 +--- Documentation/mm/page_frags.rst | 2 -- Documentation/mm/page_migration.rst | 6 ++---- Documentation/mm/page_owner.rst | 2 -- Documentation/mm/page_table_check.rst | 2 -- Documentation/mm/remap_file_pages.rst | 2 -- Documentation/mm/slub.rst | 2 -- Documentation/mm/split_page_table_lock.rst | 2 -- Documentation/mm/transhuge.rst | 2 -- Documentation/mm/unevictable-lru.rst | 2 -- Documentation/mm/z3fold.rst | 2 -- Documentation/mm/zsmalloc.rst | 2 -- 24 files changed, 6 insertions(+), 54 deletions(-) diff --git a/Documentation/mm/active_mm.rst b/Documentation/mm/active_mm.rst index 6f8269c284ed..45d89f8fb3a8 100644 --- a/Documentation/mm/active_mm.rst +++ b/Documentation/mm/active_mm.rst @@ -1,5 +1,3 @@ -.. _active_mm: - ========= Active MM ========= diff --git a/Documentation/mm/arch_pgtable_helpers.rst b/Documentation/mm/arch_pgtable_helpers.rst index fd2a19df884e..30d9a09f01f4 100644 --- a/Documentation/mm/arch_pgtable_helpers.rst +++ b/Documentation/mm/arch_pgtable_helpers.rst @@ -1,7 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 -.. _arch_page_table_helpers: - =============================== Architecture Page Table Helpers =============================== diff --git a/Documentation/mm/balance.rst b/Documentation/mm/balance.rst index 6a1fadf3e173..6cd0127154ac 100644 --- a/Documentation/mm/balance.rst +++ b/Documentation/mm/balance.rst @@ -1,5 +1,3 @@ -.. _balance: - ================ Memory Balancing ================ diff --git a/Documentation/mm/free_page_reporting.rst b/Documentation/mm/free_page_reporting.rst index 8c05e62d8b2b..1468f71c261f 100644 --- a/Documentation/mm/free_page_reporting.rst +++ b/Documentation/mm/free_page_reporting.rst @@ -1,5 +1,3 @@ -.. _free_page_reporting: - ===================== Free Page Reporting ===================== diff --git a/Documentation/mm/frontswap.rst b/Documentation/mm/frontswap.rst index feecc5e24477..c892412988af 100644 --- a/Documentation/mm/frontswap.rst +++ b/Documentation/mm/frontswap.rst @@ -1,5 +1,3 @@ -.. _frontswap: - ========= Frontswap ========= diff --git a/Documentation/mm/highmem.rst b/Documentation/mm/highmem.rst index 0f731d9196b0..bb3f90e195fa 100644 --- a/Documentation/mm/highmem.rst +++ b/Documentation/mm/highmem.rst @@ -1,5 +1,3 @@ -.. _highmem: - ==================== High Memory Handling ==================== diff --git a/Documentation/mm/hmm.rst b/Documentation/mm/hmm.rst index f2a59ed82ed3..9aa512c3a12c 100644 --- a/Documentation/mm/hmm.rst +++ b/Documentation/mm/hmm.rst @@ -1,5 +1,3 @@ -.. _hmm: - ===================================== Heterogeneous Memory Management (HMM) ===================================== @@ -304,7 +302,7 @@ devm_memunmap_pages(), and devm_release_mem_region() when the resources can be tied to a ``struct device``. The overall migration steps are similar to migrating NUMA pages within system -memory (see :ref:`Page migration `) but the steps are split +memory (see Documentation/mm/page_migration.rst) but the steps are split between device driver specific code and shared common code: 1. ``mmap_read_lock()`` diff --git a/Documentation/mm/hugetlbfs_reserv.rst b/Documentation/mm/hugetlbfs_reserv.rst index f143954e0d05..05a44760da32 100644 --- a/Documentation/mm/hugetlbfs_reserv.rst +++ b/Documentation/mm/hugetlbfs_reserv.rst @@ -1,5 +1,3 @@ -.. _hugetlbfs_reserve: - ===================== Hugetlbfs Reservation ===================== @@ -7,7 +5,7 @@ Hugetlbfs Reservation Overview ======== -Huge pages as described at :ref:`hugetlbpage` are typically +Huge pages as described at Documentation/mm/hugetlbpage.rst are typically preallocated for application use. These huge pages are instantiated in a task's address space at page fault time if the VMA indicates huge pages are to be used. If no huge page exists at page fault time, the task is sent diff --git a/Documentation/mm/hwpoison.rst b/Documentation/mm/hwpoison.rst index b9d5253c1305..ba48a441feed 100644 --- a/Documentation/mm/hwpoison.rst +++ b/Documentation/mm/hwpoison.rst @@ -1,5 +1,3 @@ -.. hwpoison: - ======== hwpoison ======== diff --git a/Documentation/mm/ksm.rst b/Documentation/mm/ksm.rst index f83cfbc12f4c..2806e3e4a10e 100644 --- a/Documentation/mm/ksm.rst +++ b/Documentation/mm/ksm.rst @@ -1,5 +1,3 @@ -.. _ksm: - ======================= Kernel Samepage Merging ======================= @@ -8,7 +6,7 @@ KSM is a memory-saving de-duplication feature, enabled by CONFIG_KSM=y, added to the Linux kernel in 2.6.32. See ``mm/ksm.c`` for its implementation, and http://lwn.net/Articles/306704/ and https://lwn.net/Articles/330589/ -The userspace interface of KSM is described in :ref:`Documentation/admin-guide/mm/ksm.rst ` +The userspace interface of KSM is described in Documentation/admin-guide/mm/ksm.rst Design ====== diff --git a/Documentation/mm/memory-model.rst b/Documentation/mm/memory-model.rst index 3779e562dc76..5f3eafbbc520 100644 --- a/Documentation/mm/memory-model.rst +++ b/Documentation/mm/memory-model.rst @@ -1,7 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 -.. _physical_memory_model: - ===================== Physical Memory Model ===================== diff --git a/Documentation/mm/mmu_notifier.rst b/Documentation/mm/mmu_notifier.rst index df5d7777fc6b..c687bea4922f 100644 --- a/Documentation/mm/mmu_notifier.rst +++ b/Documentation/mm/mmu_notifier.rst @@ -1,5 +1,3 @@ -.. _mmu_notifier: - When do you need to notify inside page table lock ? =================================================== diff --git a/Documentation/mm/numa.rst b/Documentation/mm/numa.rst index 99fdeca917ca..04648d26ffd1 100644 --- a/Documentation/mm/numa.rst +++ b/Documentation/mm/numa.rst @@ -1,5 +1,3 @@ -.. _numa: - Started Nov 1999 by Kanoj Sarcar ============= @@ -110,7 +108,7 @@ to improve NUMA locality using various CPU affinity command line interfaces, such as taskset(1) and numactl(1), and program interfaces such as sched_setaffinity(2). Further, one can modify the kernel's default local allocation behavior using Linux NUMA memory policy. [see -:ref:`Documentation/admin-guide/mm/numa_memory_policy.rst `]. +Documentation/admin-guide/mm/numa_memory_policy.rst]. System administrators can restrict the CPUs and nodes' memories that a non- privileged user can specify in the scheduling or NUMA commands and functions diff --git a/Documentation/mm/page_frags.rst b/Documentation/mm/page_frags.rst index 7d6f9385d129..a81617e688a8 100644 --- a/Documentation/mm/page_frags.rst +++ b/Documentation/mm/page_frags.rst @@ -1,5 +1,3 @@ -.. _page_frags: - ============== Page fragments ============== diff --git a/Documentation/mm/page_migration.rst b/Documentation/mm/page_migration.rst index 11493bad7112..313dce18893e 100644 --- a/Documentation/mm/page_migration.rst +++ b/Documentation/mm/page_migration.rst @@ -1,5 +1,3 @@ -.. _page_migration: - ============== Page migration ============== @@ -9,8 +7,8 @@ nodes in a NUMA system while the process is running. This means that the virtual addresses that the process sees do not change. However, the system rearranges the physical location of those pages. -Also see :ref:`Heterogeneous Memory Management (HMM) ` -for migrating pages to or from device private memory. +Also see Documentation/mm/hmm.rst for migrating pages to or from device +private memory. The main intent of page migration is to reduce the latency of memory accesses by moving pages near to the processor where the process accessing that memory diff --git a/Documentation/mm/page_owner.rst b/Documentation/mm/page_owner.rst index 127514955a5e..fc8b5f2ef173 100644 --- a/Documentation/mm/page_owner.rst +++ b/Documentation/mm/page_owner.rst @@ -1,5 +1,3 @@ -.. _page_owner: - ================================================== page owner: Tracking about who allocated each page ================================================== diff --git a/Documentation/mm/page_table_check.rst b/Documentation/mm/page_table_check.rst index 1a09472f10a3..cfd8f4117cf3 100644 --- a/Documentation/mm/page_table_check.rst +++ b/Documentation/mm/page_table_check.rst @@ -1,7 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 -.. _page_table_check: - ================ Page Table Check ================ diff --git a/Documentation/mm/remap_file_pages.rst b/Documentation/mm/remap_file_pages.rst index 7bef6718e3a9..297091ce257c 100644 --- a/Documentation/mm/remap_file_pages.rst +++ b/Documentation/mm/remap_file_pages.rst @@ -1,5 +1,3 @@ -.. _remap_file_pages: - ============================== remap_file_pages() system call ============================== diff --git a/Documentation/mm/slub.rst b/Documentation/mm/slub.rst index 7f652216dabe..fa01cdfd7d3a 100644 --- a/Documentation/mm/slub.rst +++ b/Documentation/mm/slub.rst @@ -1,5 +1,3 @@ -.. _slub: - ========================== Short users guide for SLUB ========================== diff --git a/Documentation/mm/split_page_table_lock.rst b/Documentation/mm/split_page_table_lock.rst index c08919662704..50ee0dfc95be 100644 --- a/Documentation/mm/split_page_table_lock.rst +++ b/Documentation/mm/split_page_table_lock.rst @@ -1,5 +1,3 @@ -.. _split_page_table_lock: - ===================== Split page table lock ===================== diff --git a/Documentation/mm/transhuge.rst b/Documentation/mm/transhuge.rst index ec3dc5b04226..9d924b651c61 100644 --- a/Documentation/mm/transhuge.rst +++ b/Documentation/mm/transhuge.rst @@ -1,5 +1,3 @@ -.. _transhuge: - ============================ Transparent Hugepage Support ============================ diff --git a/Documentation/mm/unevictable-lru.rst b/Documentation/mm/unevictable-lru.rst index 4a0e158aa9ce..b5dc98cd1ba8 100644 --- a/Documentation/mm/unevictable-lru.rst +++ b/Documentation/mm/unevictable-lru.rst @@ -1,5 +1,3 @@ -.. _unevictable_lru: - ============================== Unevictable LRU Infrastructure ============================== diff --git a/Documentation/mm/z3fold.rst b/Documentation/mm/z3fold.rst index 224e3c61d686..25b5935d06c7 100644 --- a/Documentation/mm/z3fold.rst +++ b/Documentation/mm/z3fold.rst @@ -1,5 +1,3 @@ -.. _z3fold: - ====== z3fold ====== diff --git a/Documentation/mm/zsmalloc.rst b/Documentation/mm/zsmalloc.rst index 6e79893d6132..24616a7c115a 100644 --- a/Documentation/mm/zsmalloc.rst +++ b/Documentation/mm/zsmalloc.rst @@ -1,5 +1,3 @@ -.. _zsmalloc: - ======== zsmalloc ======== -- 2.35.1