From patchwork Mon Dec 19 04:22:04 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 13076231 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 DF0A0C4332F for ; Mon, 19 Dec 2022 04:22:23 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 3DF618E0003; Sun, 18 Dec 2022 23:22:23 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 38FF38E0001; Sun, 18 Dec 2022 23:22:23 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 230488E0003; Sun, 18 Dec 2022 23:22:23 -0500 (EST) 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 12EB18E0001 for ; Sun, 18 Dec 2022 23:22:23 -0500 (EST) Received: from smtpin29.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay09.hostedemail.com (Postfix) with ESMTP id E4FAA80866 for ; Mon, 19 Dec 2022 04:22:22 +0000 (UTC) X-FDA: 80257758924.29.06EDE60 Received: from mail-pj1-f48.google.com (mail-pj1-f48.google.com [209.85.216.48]) by imf01.hostedemail.com (Postfix) with ESMTP id 1ABE640006 for ; Mon, 19 Dec 2022 04:22:20 +0000 (UTC) Authentication-Results: imf01.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=II0wTtuX; spf=pass (imf01.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.216.48 as permitted sender) smtp.mailfrom=bagasdotme@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1671423741; a=rsa-sha256; cv=none; b=rJ1ibfp8aBNcH9/wJnlqiFLQwq7KAFh49T590PPOu/vy83ksmnn1o90v7uff6NQ3wQpWeK qOA+BZxVaSrkVuCTGt9L0JtS1Mcnu5pbKKEtPbMsIUEB6tMikg3GtWLZgk/JtftIw3puAy KQW6okbZkhcmFp0G1lnmJInq/3CdqVs= ARC-Authentication-Results: i=1; imf01.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=II0wTtuX; spf=pass (imf01.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.216.48 as permitted sender) smtp.mailfrom=bagasdotme@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1671423741; 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=QEwa20X9A+wyrh3eoohiFgEbSAwTbPLRyuDyRq0+iJI=; b=EHMeVgAc05hcpleJU84STI+qICgvaVsihE6SLVHafQ6oXlr7fdEuX6DWMulujxPEd0UQoX sjcqtxvvxXv1bCEEBK/QqVVz0q0/tDlL8Yp39encOtnLwdUjw98lGJOPKiiGi9eydi25Vh flYDtPlncu/T68Tbk7q4fnWu+6Eu9k0= Received: by mail-pj1-f48.google.com with SMTP id t11-20020a17090a024b00b0021932afece4so11715928pje.5 for ; Sun, 18 Dec 2022 20:22:20 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=QEwa20X9A+wyrh3eoohiFgEbSAwTbPLRyuDyRq0+iJI=; b=II0wTtuXbBN9IR3zSvAIoImZqLWv0Oeuf04Gufnq1MigHIf67TLDV0jn7TB8epZsFl 3sobPQazNVCSNREFsj+waKJmepN4RKRGv5jKhGOO8xQ3FeFMzjxswnj+wJX6zJuVVKtD vRlBDOOCXf+uqa8v4WjUjVsV5efjC6QCtCju7xnXLNyCWjRxDOx84+zksXWKn2HTT2Hc VEhTup0H5OoAJZe17tUKAxcqCseN4njXFE8lC38/Jk2FkFYYKlooS+tYXbKC8MZgXjKQ bg0846Fhh86noJjama1Be+g7Al4PFbe0WtzrpNcNqNgtBIbwrZHUf37b32x+NPmZMMOX 0zeg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=QEwa20X9A+wyrh3eoohiFgEbSAwTbPLRyuDyRq0+iJI=; b=A6Q23UrgoOYIeOb6EZfVXNfcw7WhAMFBijSoutwFpG+1PncYLcj8qIXZBxSAqTVwIl QncJmIiOrC+JUT/zF9rd5uRp1gzbrIXE7qnpoodxC/PS/Qewk7s/PjiXOBD/qRc+oRoO SiZO8Maw0yIxTuMxT7rILJuOIB16EM0dmgEnaJ7kasQAsyo8Sqhb9h3RoPBmCV2NU+ar 7fWGRALwmHI4ep+w9vCrKxVwOetiY910bKcWl2K06DrXDxPXlYDFiA1tyQcduOVD9pIF VENTzEHJZ6f8A1UAh9ij4awiir9PuBihqO9k5rRBTYNlnMc4Rvo804BzdM1CcxaA6CSr FgOA== X-Gm-Message-State: AFqh2krn3PlB5T8I9uFsA70O6fjoieVmLN6w/El6jPhRmvV1viyNrS3w igItN1L63eDd5qSssEJs21k= X-Google-Smtp-Source: AMrXdXsGNlWGG3n6vP6It4uosK23dRFLrGgn17glXzSNE6kRoir89VzcMFMpQ7rLtZjdeTa4FFao4g== X-Received: by 2002:a17:902:c187:b0:186:fb90:573d with SMTP id d7-20020a170902c18700b00186fb90573dmr8523902pld.3.1671423739989; Sun, 18 Dec 2022 20:22:19 -0800 (PST) Received: from debian.me (subs32-116-206-28-20.three.co.id. [116.206.28.20]) by smtp.gmail.com with ESMTPSA id q17-20020a170902f35100b00187197c499asm5882262ple.164.2022.12.18.20.22.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 18 Dec 2022 20:22:19 -0800 (PST) Received: by debian.me (Postfix, from userid 1000) id 93250101314; Mon, 19 Dec 2022 11:22:13 +0700 (WIB) From: Bagas Sanjaya To: cgroups@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Linux Memory Management List Cc: Tejun Heo , Zefan Li , Johannes Weiner , Jonathan Corbet , Michal Hocko , Andrew Morton , Hugh Dickins , Shakeel Butt , Bagas Sanjaya Subject: [PATCH 05/10] docs: cgroup-v1: fix footnotes Date: Mon, 19 Dec 2022 11:22:04 +0700 Message-Id: <20221219042209.22898-6-bagasdotme@gmail.com> X-Mailer: git-send-email 2.39.0 In-Reply-To: <20221219042209.22898-1-bagasdotme@gmail.com> References: <20221219042209.22898-1-bagasdotme@gmail.com> MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=4564; i=bagasdotme@gmail.com; h=from:subject; bh=JPQvjZYEry5PAqc04yDM29al0BTsUtfNTgHs2tjYRDY=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDMnzn713s2ALYv7Qur7Z8OQ8xUPaUbXSj7TzHyttWtb8Zc7r WimDjlIWBjEuBlkxRZZJiXxNp3cZiVxoX+sIM4eVCWQIAxenAEyk8gHDP8uTjBf7tATssl9F6ut+mL 3WS/eK9VIWiadnj+7WDqq+JsHIcEb+29LkV/o8IVzfVV5WSz7+2/dD1uj8A4E/ce+mWqx1ZAIA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D X-Rspam-User: X-Rspamd-Server: rspam03 X-Rspamd-Queue-Id: 1ABE640006 X-Stat-Signature: xfijyj6izc1x49k8euk65hewgbk5tmrr X-HE-Tag: 1671423740-885548 X-HE-Meta: U2FsdGVkX19qA4kK/ybwJobGmKln6KkFAJVv8I8fFCXEdfXT7P3UeLrm1uwdHYXOVlTckLl63QfvOufG1lj+h3nedwOGzHhwwwE/HoKuFgLjCyqB8Abfd88XwKGCCmNn5UJBq7LtwekZOjjP7DB1gA+LSU8gletFXdQaLk/gdpLfQ8jPa1L6cliifvVwfLMqVNgg9D84Br69b8yjLCXW8XcZwXmmAi1bU5Oaa5KwYWxsvNYCa9XcT5WX6CnN2MekhYTGoPfrppsH1LrLYOTbqQCe7nr+g3rvSfJPlh9NeYc0OkwAkIKIaUJOZq7X/J36b/b/gY5XPKrzgsiAj5059zGvPhrwPpiOKb9kbksmDq9Sfbx87Rzw/b9GoiUqCsxNR3iirL1+jywpzBOdRfNM7e7WCRrEUwLE7299GN1SzydOtJ9OgEsvgDQ+XqE3uyMQEZ0QmSYm6GMmFxwGwn8XnIXarQdtuGRnQ+PGBpKS8ub7/HQYFeS2StBA9lbVwNtL2sVd9mgy9LaKYrHoBGmKPhsDqn1CLFtRxcqNvYKKmWV11e1Fjxib/eHK0trlnWcRKZKQn7NntTSXj1jLg49oOX/5jmUJxe9mEa9QUmk8jWJLKT39K1ZX9TkhNeZo78JeE2WpGMzkJ4MT5wjEcuX4DWfK1myxRKqHxitgobRLyy9oHs5GhCMCiIMvCh/TmA4g3nFt6MGiAJfPV5KrXAjsxvEet8oOW7blGlHkVD5A8qxhVZnGYg5prc0j5HGkyVpw9dgcr+7is/lULCquX5ujDH9ZhSvt4gqRwjQL0zaqksfflmb/B/OkTcoq3wBgHm1w7pzlEAf4W9Y3ZoAeCm+WUNlVg0kBtuWhRxDDC3Z8neni8q78ELBxFncxHa2sOawzDGNh+2qz+TabF+98CZmB/Ed4pt5aKTpak7jFIBO/kCAzoeeLgFyQibfDnltdG8PfFQTf2yqiQJd/OUrH/CA 8M1COHSQ EhN2jFpjoV6d2bhxmqZLiQsyHd0ZFJ5ABEop97IJmO51/YNJF/qgwd+URQhCMBJc6BzexkjoNZZUChMWliAFNGz6x35X1BZkJHQi5uxBvTV83YROdS7BG6Mf+yRKnWIJOWvsN 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: The documentation contains external references, which some of them are marked as footnotes. Fix the syntax for them to be properly rendered as such. Non-footnote references aren't affected since the text for these is aligned the same to the footnotes. Signed-off-by: Bagas Sanjaya --- .../admin-guide/cgroup-v1/memory.rst | 36 ++++++++++--------- 1 file changed, 19 insertions(+), 17 deletions(-) diff --git a/Documentation/admin-guide/cgroup-v1/memory.rst b/Documentation/admin-guide/cgroup-v1/memory.rst index c21ce0b906059f..642ef0bb20380a 100644 --- a/Documentation/admin-guide/cgroup-v1/memory.rst +++ b/Documentation/admin-guide/cgroup-v1/memory.rst @@ -23,7 +23,7 @@ Benefits and Purpose of the memory controller ============================================= The memory controller isolates the memory behaviour of a group of tasks -from the rest of the system. The article on LWN [12] mentions some probable +from the rest of the system. The article on LWN [12]_ mentions some probable uses of the memory controller. The memory controller can be used to a. Isolate an application or a group of applications @@ -109,16 +109,16 @@ Brief summary of control files. ========== The memory controller has a long history. A request for comments for the memory -controller was posted by Balbir Singh [1]. At the time the RFC was posted +controller was posted by Balbir Singh [1]_. At the time the RFC was posted there were several implementations for memory control. The goal of the RFC was to build consensus and agreement for the minimal features required -for memory control. The first RSS controller was posted by Balbir Singh[2] -in Feb 2007. Pavel Emelianov [3][4][5] has since posted three versions of the -RSS controller. At OLS, at the resource management BoF, everyone suggested -that we handle both page cache and RSS together. Another request was raised -to allow user space handling of OOM. The current memory controller is +for memory control. The first RSS controller was posted by Balbir Singh [2]_ +in Feb 2007. Pavel Emelianov [3]_ [4]_ [5]_ has since posted three versions +of the RSS controller. At OLS, at the resource management BoF, everyone +suggested that we handle both page cache and RSS together. Another request was +raised to allow user space handling of OOM. The current memory controller is at version 6; it combines both mapped (RSS) and unmapped Page -Cache Control [11]. +Cache Control [11]_. 2. Memory Control ================= @@ -971,15 +971,16 @@ commented and discussed quite extensively in the community. References ========== -1. Singh, Balbir. RFC: Memory Controller, http://lwn.net/Articles/206697/ -2. Singh, Balbir. Memory Controller (RSS Control), +.. [1] Singh, Balbir. RFC: Memory Controller, http://lwn.net/Articles/206697/ +.. [2] Singh, Balbir. Memory Controller (RSS Control), http://lwn.net/Articles/222762/ -3. Emelianov, Pavel. Resource controllers based on process cgroups +.. [3] Emelianov, Pavel. Resource controllers based on process cgroups https://lore.kernel.org/r/45ED7DEC.7010403@sw.ru -4. Emelianov, Pavel. RSS controller based on process cgroups (v2) +.. [4] Emelianov, Pavel. RSS controller based on process cgroups (v2) https://lore.kernel.org/r/461A3010.90403@sw.ru -5. Emelianov, Pavel. RSS controller based on process cgroups (v3) +.. [5] Emelianov, Pavel. RSS controller based on process cgroups (v3) https://lore.kernel.org/r/465D9739.8070209@openvz.org + 6. Menage, Paul. Control Groups v10, http://lwn.net/Articles/236032/ 7. Vaidyanathan, Srinivasan, Control Groups: Pagecache accounting and control subsystem (v3), http://lwn.net/Articles/235534/ @@ -989,7 +990,8 @@ References https://lore.kernel.org/r/464D267A.50107@linux.vnet.ibm.com 10. Singh, Balbir. Memory controller v6 test results, https://lore.kernel.org/r/20070819094658.654.84837.sendpatchset@balbir-laptop -11. Singh, Balbir. Memory controller introduction (v6), - https://lore.kernel.org/r/20070817084228.26003.12568.sendpatchset@balbir-laptop -12. Corbet, Jonathan, Controlling memory use in cgroups, - http://lwn.net/Articles/243795/ + +.. [11] Singh, Balbir. Memory controller introduction (v6), + https://lore.kernel.org/r/20070817084228.26003.12568.sendpatchset@balbir-laptop +.. [12] Corbet, Jonathan, Controlling memory use in cgroups, + http://lwn.net/Articles/243795/