From patchwork Thu Jan 5 13:16:25 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 13089861 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 A198CC3DA7D for ; Thu, 5 Jan 2023 13:17:12 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 588C2900002; Thu, 5 Jan 2023 08:17:09 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 4C2D6900003; Thu, 5 Jan 2023 08:17:09 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 368B4900002; Thu, 5 Jan 2023 08:17:09 -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 26886900002 for ; Thu, 5 Jan 2023 08:17:09 -0500 (EST) Received: from smtpin25.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay10.hostedemail.com (Postfix) with ESMTP id 03F75C0171 for ; Thu, 5 Jan 2023 13:17:08 +0000 (UTC) X-FDA: 80320796178.25.F9A3AFC Received: from mail-pl1-f178.google.com (mail-pl1-f178.google.com [209.85.214.178]) by imf14.hostedemail.com (Postfix) with ESMTP id 3D4E8100003 for ; Thu, 5 Jan 2023 13:17:06 +0000 (UTC) Authentication-Results: imf14.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=NGtacwLg; spf=pass (imf14.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.214.178 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=1672924627; 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:references:dkim-signature; bh=HUkOkbYzuv5WTxnO2sv3n0IBM4omUdA6IheQF/z4HEk=; b=J/ylPGJBezANt0AQTu25joLZLg6Y9eWXnTOtadLt3cqiFhQPYA3wbP9Gt5zHRRi3HsWN6l /VUW2LkaAlTloX6Q03PKqjUfPvdais6FI2CWqVooJ4jzVMFgzjOwJCC7qUeoeExa5O1IZ/ 9XmpnMugAfbTrYUbMUYArZLqvOarMTI= ARC-Authentication-Results: i=1; imf14.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=NGtacwLg; spf=pass (imf14.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.214.178 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=1672924627; a=rsa-sha256; cv=none; b=eDotv1Ymy/HKoXwChkDqcy43G58W3RlYNihw+1aN62g1yxrefPQ25+qs4FPXeJZD/jqJfl Dg5hOk9txi8mfxQY0SkXe43SWT8SF2CWLq0g9fTwfYGAq5c8rOOhbRC9lcWyLid1NWqBaB mfIcMYZErt2ujOOedWALmKDHCWgMT0c= Received: by mail-pl1-f178.google.com with SMTP id d3so39289393plr.10 for ; Thu, 05 Jan 2023 05:17:06 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=HUkOkbYzuv5WTxnO2sv3n0IBM4omUdA6IheQF/z4HEk=; b=NGtacwLgGIfh31U+j37UAkxT1pREhpEa5I7Zke513uzhR7ayCdgCJbrs6KJiPvm06G fFnCmYRv+PHI1g5DcOZktq7IN/66rGcEzHoW3YjMbKRqEvewBDT8rUuYaoaaHqHZ78QP PtEv4zWfcdWbJYB7ILQwRDe/bGViy3ZC63cJeYMXvm8MbStVEc3cjzLQnVHYp+FNYSb5 PQNcD40i+b5wMdGICjjhXSmU5X7aytJ1yHYPs94FSKOKHIuzzpjLwfEopRxYZyhe2GU3 nrs86tF5hzi0AXjOlJujcpTA+Bmag6mafIsPZcuIeq6mpMF3FF8GB3vZHPbXUaTjKHqL Jn2g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=HUkOkbYzuv5WTxnO2sv3n0IBM4omUdA6IheQF/z4HEk=; b=uqBFoqg+pYyUH9XiFcB9cNUt8AGpTiwrdIeqiC9hR1gat7QJwbZM0YFf0UCKUfy15Q xD+R2YdFnNd3y20vUbl8rbJHPjHsFEAJPiBL7rQzpC3937snS4cn0G1EJb46RErXvdBF Gk6JtIV6vwmGWudCi3JwGc1LCrJnxNFGVRdV12T6LmSdMA8sVhgp+GODeGdYEYXFpsZM VBEZTVS0GJiIsk6ZEaR9FcQ25nuWXBxUuQpOtbHZhrAx9KCP6HseAMIJBiXkmSDAW+oW fWJINqDkZ2BfFU4UgY7IcvHmfFAaU+R/4fgSzVWgT8ePi/s//TBW+tHXRQT9SAvFD5Wf qQYg== X-Gm-Message-State: AFqh2kpLPL9psEZQASpkT/xCeKUS7VQkSuLOgnWxY2PEUOLCeWQ4irC0 we/tbXNBDut+TIqGvAm1Jis= X-Google-Smtp-Source: AMrXdXu6rCc1zuGeZNCk5kWS9i/EY+REle4fGbOLkNgWpwIL6oVfmjfm6n/aQtbOiutCYncfzkjHxw== X-Received: by 2002:a05:6a20:4655:b0:aa:23f9:7314 with SMTP id eb21-20020a056a20465500b000aa23f97314mr52845051pzb.46.1672924626119; Thu, 05 Jan 2023 05:17:06 -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 p28-20020aa79e9c000000b00575caf8478dsm12597033pfq.41.2023.01.05.05.17.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 05 Jan 2023 05:17:05 -0800 (PST) Received: by debian.me (Postfix, from userid 1000) id 3792010447A; 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 0/9] docs: cgroup-v1: formatting improv for "Memory Resource Controller" doc Date: Thu, 5 Jan 2023 20:16:25 +0700 Message-Id: <20230105131633.553574-1-bagasdotme@gmail.com> X-Mailer: git-send-email 2.39.0 MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=3353; i=bagasdotme@gmail.com; h=from:subject; bh=/kf4xrQxZdifPynYl0ZAE3ZdLLa3+RCO1xkFVH/rr78=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDMnbzq74Oaf24mtmL1epe2kFR1t/Gskr2N2/xXXUT5Cp7Mit N8vOdJSyMIhxMciKKbJMSuRrOr3LSORC+1pHmDmsTCBDGLg4BWAiAWcZGU5FLnntdv6I4smC0myPyx r1nxvn7So4dqmS6VnI/EmdLxYx/FOWCK2cymic2LvpZ6Cq+MkLArusbB7tVZ543rpZb8f/2WwA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D X-Rspam-User: X-Rspamd-Server: rspam04 X-Rspamd-Queue-Id: 3D4E8100003 X-Stat-Signature: jsnhwg7sby51fqyao3jx8jybrr4cgan4 X-HE-Tag: 1672924626-993015 X-HE-Meta: U2FsdGVkX19XgoDcLtVesN322XZX69ugLjKv7K6Xfrvi+QPqqj7QS1MSXypIW/LNrG5071D8UMNU+L7Kn0eEWQDVNbDcZwUKOgvBeV2CZeoN+nH0aJhk0f/iO0CHLbO7EjHiMcls0/cUDTM11u7rkZnChqzf/ul9qAbl7oFD4NnA8lpHENHeDmBKxjF8YmTzm955gtIqNgVH35cgcFSNZyW9WiQKkpbod55Q1toUAXMOgA5oqRApIazmffvGlZDt8ChnotjuXlXD5QyBfmEMGYB507MD/TokXEG7gNk3g1MnIWJAfTHdhHfXZ8YFy7xaG8zxZViFlrOMfb3PhEaCnmz9yYKxYhOfNu5b45ex2Oio8Dy3w/VVdSvlxyNlu2r9FzC8F91nJH9Sl8LMTBqNOgpziWT9RWXJdexr9+5GSwJEq1hat8v6nhr1jL3On55DfELd0onVTCvPKDKBp8xKNQylnQzD8UPaslnU0PWLcVe6hRzeXOhiQOCwezvSD0sKPrNPQE0mR6C6BMWyliF43iBdTlCMZIlxHmtje+Cin+mYSGQZxXX5XSvKPA/J3iMc+W1VXm1d6eIx10yZzIXogZ8SDQHMSC7BpToO0zAHZY/ZpSH/owNmUgycSrJFxA+QjOiylwTzTKIazU6av/uPU8c30MtW7TqHHIPS37V0R+ED6HRk1MtoBliRn8tzyKbRugdDUADw02bgjdSoKzKk7AhIhX8tDZqAIMR5L8yef18+qANhICt5NWHeuAY+z6Ug7OTdS/5RZYvD0fmBmPy1ZGPKIrSnTFdS1hli5i81/3V0BgmZw5zDVuWSZdeiTawLLjROquXNLtX4oTJFLxkgU78GU7UgUyg3IGKV3nvhQWOWmA54KMlm+vFhf6bWWq/Juq6hb20F28ZESaQTOzwxfi1Jqty88jU4fvSk/1MUcqULtV21IN8ER8SIJR5SDhP5WaN0jCp/pdr6WdzxKD8 48vQ5xno l2xyYkQajRb78AZMLKjPGjsAwgxliTatoOD/9/tk6BSAatGVWEthm2BswNgD/nLIjouMbz5l+v9yj8MCBBHhNKOWknImXTUPbltAdj1fSQ8q8TscnVz3KRRF8eD0fYgOLGdlN 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: "Memory Resource Controller" CGroup v1 documentation has been in reST since 99c8b231ae6c6c ("docs: cgroup-v1: convert docs to ReST and rename to *.rst"). The current doc look is kinda ugly, so improve the formatting (only htmldocs is tested). Changes since v1 [1]: * Drop the underline fix, since the blamed commit had been dropped * Rebase on top of current cgroup tree (for-next branch) Range-diff against v1: 1: e0f2b878ad6435 < -: -------------- docs: cgroup-v1: extend underline of section 8 2: 4e26b743ce9b42 = 1: cb31249cacdad6 docs: cgroup-v1: replace custom note constructs with appropriate admonition blocks 3: c89f9aa1e6dac9 < -: -------------- docs: cgroup-v1: wrap remaining admonitions in admonition blocks -: -------------- > 2: 8e03baf289c4f2 docs: cgroup-v1: wrap remaining admonitions in admonition blocks 4: b901b2b0407e23 = 3: 790ac70bcf31e1 docs: cgroup-v1: use code block for locking order schema 5: f4112d2f9990ce = 4: 2af22c24977a38 docs: cgroup-v1: fix footnotes 6: d5d16831555e6b = 5: 9788d0e8c87cc5 docs: cgroup-v1: move hierarchy of accounting caption 7: 92db959851e2c8 = 6: b191e2bd87871b docs: cgroup-v1: use bullet lists for list of stat file tables 8: 767988658f58b8 ! 7: 56e4ba363e4e65 docs: cgroup-v1: use make swap extension subsections subsections @@ Metadata Author: Bagas Sanjaya ## Commit message ## - docs: cgroup-v1: use make swap extension subsections subsections + docs: cgroup-v1: make swap extension subsections subsections Subsections text of swap extension section is marked up as bold text, whereas making them proper subsection is more appropriate. 9: a502f09f9a3c33 ! 8: 6895ee7c84e840 docs: cgroup-v1: add internal cross-references @@ Documentation/admin-guide/cgroup-v1/memory.rst: If we want to change this to 1G, +.. _cgroup-v1-memory-move-charges: + - 8. Move charges at task migration (DEPRECATED!) - =============================================== + 8. Move charges at task migration + ================================= @@ Documentation/admin-guide/cgroup-v1/memory.rst: If you want to enable it:: 10: 895b1f1aa37d33 = 9: b179c2788f2a36 docs: cgroup-v1: use numbered lists for user interface setup [1]: https://lore.kernel.org/linux-doc/20221219042209.22898-1-bagasdotme@gmail.com/ Bagas Sanjaya (9): docs: cgroup-v1: replace custom note constructs with appropriate admonition blocks docs: cgroup-v1: wrap remaining admonitions in admonition blocks docs: cgroup-v1: use code block for locking order schema docs: cgroup-v1: fix footnotes docs: cgroup-v1: move hierarchy of accounting caption docs: cgroup-v1: use bullet lists for list of stat file tables docs: cgroup-v1: make swap extension subsections subsections docs: cgroup-v1: add internal cross-references docs: cgroup-v1: use numbered lists for user interface setup .../admin-guide/cgroup-v1/cgroups.rst | 2 + .../admin-guide/cgroup-v1/memory.rst | 268 ++++++++++-------- 2 files changed, 146 insertions(+), 124 deletions(-) base-commit: 21786e5cb375a1e58a9175fee423e1d7f892d965