From patchwork Thu Jan 5 13:16:29 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 13089864 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 DFBE5C3DA7A for ; Thu, 5 Jan 2023 13:17:16 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id CDAF6900007; Thu, 5 Jan 2023 08:17:11 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id C6504900003; Thu, 5 Jan 2023 08:17:11 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id A8FED900007; Thu, 5 Jan 2023 08:17:11 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id 9B26E900003 for ; Thu, 5 Jan 2023 08:17:11 -0500 (EST) Received: from smtpin03.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id 6E151407DC for ; Thu, 5 Jan 2023 13:17:11 +0000 (UTC) X-FDA: 80320796262.03.68DB6AE Received: from mail-pj1-f51.google.com (mail-pj1-f51.google.com [209.85.216.51]) by imf26.hostedemail.com (Postfix) with ESMTP id 91C9C14001A for ; Thu, 5 Jan 2023 13:17:09 +0000 (UTC) Authentication-Results: imf26.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=keDd3AgP; spf=pass (imf26.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.216.51 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=1672924629; a=rsa-sha256; cv=none; b=nTUIF1A1YbnkVOzNMdVT3vt/HUi/Sb931wtsjGwP/75gRNaco8fz521dajuCXlIVC9lzse dDzBlaEMYufULCjTYH9BVHPhieJNaFb2hM8ey0mT+415t1wK2hGvjhCjoxcawlN0c17r89 OXUhCdFPdN4SyJrJQgtuU9mcCNA1tpg= ARC-Authentication-Results: i=1; imf26.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=keDd3AgP; spf=pass (imf26.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.216.51 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=1672924629; 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=WcgLa2dNrRbbB5gOhzfJxjnV71pkRRr18/tvuPVFK50=; b=JhskVRtGAJcd8ZuipdGAMAbk4PFaa74KfpYRJkf4/WatHlY2X6jJezsv1YHguFX+RTmr05 jMMYI8k0OgGxSgGlC+j6U2oHcuvJIS/dfsRVUP2t2AiIlFOLDTbGonUrqV8LnDcT1D9Xww REHFcwsZ6umbTtOnDJXfHNI9lZzniBc= Received: by mail-pj1-f51.google.com with SMTP id m7-20020a17090a730700b00225ebb9cd01so1971834pjk.3 for ; Thu, 05 Jan 2023 05:17:09 -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=WcgLa2dNrRbbB5gOhzfJxjnV71pkRRr18/tvuPVFK50=; b=keDd3AgPUHBkhQi+rsF5VDBfEFxkbSMl3Vqw0PYwH/URI1zS8RogSrFV/8SHOT2rcb I133BM/nD4wJ1EadTEgtSEDHDPrcig04g3dNQ4nfkqx1gvITJcygp7HgRmME0VppT5i5 8g7EWVT/saKRIoUp1ZIB7M2O49HAmxkadDEdEUWyUhIldVpmt2TD6k1XYn5vN+l4y0t+ w5uhh7NvkckKzoRXRBq2lpxu28RhgpVqRYPd9uRQhoPdfLt59iM9m5mpmZVpxojBFHUU kKNdT2f3FiEZjnlOWzwCzGTfAEwvYMLKN2ON1apQj+lEfgkbpdE1RfunoE+Bbj/ZZ3aU 1R0g== 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=WcgLa2dNrRbbB5gOhzfJxjnV71pkRRr18/tvuPVFK50=; b=dhuj1jBtcLGT5JTL9T446KO747u2rKLsDRVjH0SRt2stCAqXaYMm1BQNtRcohllQSB 7XVTJeemj2WlKp6VbqVdKoLBbqVflx+rmcWzd94QuOz1wMyPSZz5DcG3BpjFnjKOijEN xKy5LS9ho7vXrrfEEkYbbnwICCQALJyBQYyrFSCqDauHneYda4SsAlAB2vGFhrx5pgYf b0TBZE5U1lf8tbsuBCLOIv3a9bA+krCNFggBv77bE9xVnTvtguUYVEkKmdk1+0Z+ilMp 7ioqkHzOOA3xIcwCKSld3NqbTJWdzMzvTOZpUtuKr7Cpk3EfJgXlxRK3R2fxSWgeftFq zzhA== X-Gm-Message-State: AFqh2kqOf/hy16QciHCuVeI/cUDPYy/q5vVz0ziKSh0eSp1VZhWKfaFU fgTsc6mzW8FcKfZqyUHt2DM= X-Google-Smtp-Source: AMrXdXtglOj8A4JpjzospA6ZVS8xDhDFh3sS/+n6zUQ0COioBhiZcJZTWPZZ7RtTN+bsVQJ0rOvuEA== X-Received: by 2002:a17:902:d491:b0:192:b40b:e41 with SMTP id c17-20020a170902d49100b00192b40b0e41mr33019419plg.61.1672924628393; Thu, 05 Jan 2023 05:17:08 -0800 (PST) Received: from debian.me (subs02-180-214-232-68.three.co.id. [180.214.232.68]) by smtp.gmail.com with ESMTPSA id u14-20020a170903124e00b001911e0af95dsm25982139plh.240.2023.01.05.05.17.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 05 Jan 2023 05:17:07 -0800 (PST) Received: by debian.me (Postfix, from userid 1000) id 1616D104F84; Thu, 5 Jan 2023 20:16:59 +0700 (WIB) From: Bagas Sanjaya To: Linux CGroups , Linux Documentation , LKML , 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 v2 4/9] docs: cgroup-v1: fix footnotes Date: Thu, 5 Jan 2023 20:16:29 +0700 Message-Id: <20230105131633.553574-5-bagasdotme@gmail.com> X-Mailer: git-send-email 2.39.0 In-Reply-To: <20230105131633.553574-1-bagasdotme@gmail.com> References: <20230105131633.553574-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=Li+17qbQJgnbNb0Pbpw9z8Zmcq62SZTQcF9sfN0MfPE=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDMnbzq6P9OrLP7vybP+GlXoHvU8ZyVxYFBl27qn5hBWm9b4h Kzo1O0pZGMS4GGTFFFkmJfI1nd5lJHKhfa0jzBxWJpAhDFycAjCRl/4M/4wTt0d1cuy3W33uwGLZ0q yehNM3tp7XkOpxUg0Ofe9xdicjQ2d5hGC1K1+WwIaTC+q3+EedWJbbzfbB321yw8oapQW9bAA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D X-Rspam-User: X-Rspamd-Queue-Id: 91C9C14001A X-Rspamd-Server: rspam01 X-Stat-Signature: 3o1aiqkhnab3uojuc4it1diapzc6f7kg X-HE-Tag: 1672924629-278117 X-HE-Meta: U2FsdGVkX1/VoUlzCAkmKyl0c6fI21lJ37J4ClPkj11Cj/o075DonTTZ5u0/3NuBpmYrc926R722fs2WXmsyU+doZ3bt77PiL1FQMW74iO4/Z02Nwgvz0kVkTv9kskp9zYwkIrdNv4y9yqdj9U0q95DYBT8gUdWLQdUYaD/EAql7msHwZE27ejUHVlmH/c6lX9zrA6EuzTr0ZzAUkWkFeQ25DiwedIJtIjSRoZPQFWLMVAEp4wJ6TSiPYhZr5jRdZ+Q5ayK3r4tc/KKhR2vnRbarALsRTW9W2z8W8RGy4gXQgxUeAv7SbG1iWy/MkPXF3dApSRjWPpnFtG3YZv5csr3yI4X8n1EbbNJvf2rKzsoBMh4UQOyPmcanEr/Cm7Doc3aDOHIozHlADqqJTAk34p0J7W89t+kWDtkFJzeAS8ofLKBFZl9KLtDxklpb7GKi3SIaDcvq1VGFTl/NMXn56jZw8IA9R+arIt8AGeYb40DATDsgbDkI3sAmxM+E+i4TVV/xkcqK0A7WFylyJHA0l3RlVF5f6GPl4S+FGTQa00yxZ7OYxlr/S/oB7n2evNJMXgaI9tRkZs5vXwg33dp8sOqqTQReOWp+VB47tyotJs8ehpTpl8eelz4POIDKIMp3DbkN7UrQ77+ljcWLfJxIP3Arcb/gzB511eqenNnn058WCaFNSYC9ltnUsJy/lUh66zC7LuWtHoXjqQ2Xb8LZyx936DO2xOCxBmeNMtHIO34PSZNUddgqKwB6+ovQ9bZL3ZZbDCCiYSYWOJ/g9Z8zTzOk70zZJqRbGDNNZ/7DISiW0sBrC70XLwNyk8izNhCb6mknFdjOAgf0Y5tFTZ3EFULXpZDzUmZWB2SRoK4pjpCUITRZvClXnAllJ/qc3fa7dWQhAv1+BLCSiTVH2qxM0GYXY9cDbR+G8bbuwJd2G2HUQwECLg3NzgH0tdogfjuHDMbXyWWfxFxKqcpJokg o/pE+Wsv 37rZhPncYu3ZZS7AabwBk0Efo81SqSQzKtqEK1RMAZBnhRy0qKdG1TAYmKA2s2ii+aEhqhHuyimNStsjE6BhuK5HexSSS8opvwnxWnBb9AH9nq2D7qXx+IhN6vHQuBpf2mJrg 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 2b807fc128c662..8d1cedcf44f6ea 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 @@ -107,16 +107,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 ================= @@ -960,15 +960,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/ @@ -978,7 +979,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/