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 3D4A6C46467 for ; Mon, 2 Jan 2023 23:35:27 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 7B0758E0002; Mon, 2 Jan 2023 18:35:26 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 7608A8E0001; Mon, 2 Jan 2023 18:35:26 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 628398E0002; Mon, 2 Jan 2023 18:35:26 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id 536398E0001 for ; Mon, 2 Jan 2023 18:35:26 -0500 (EST) Received: from smtpin09.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay01.hostedemail.com (Postfix) with ESMTP id 308CD1C61A2 for ; Mon, 2 Jan 2023 23:35:25 +0000 (UTC) X-FDA: 80311467810.09.2D3491B Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by imf09.hostedemail.com (Postfix) with ESMTP id 99DF314000D for ; Mon, 2 Jan 2023 23:35:22 +0000 (UTC) Authentication-Results: imf09.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=b3dpElX9; spf=pass (imf09.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1672702522; 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=8Urwkhnl8X2pfaw1kHAwUmTLLQL4RD3KeQARX6NwZkU=; b=YQAjiH39wzVd3K+w7ZqJQv1ictW/ZVvCcTMDfRdLP6XhSlAxJ1qUHZJGAeZxgKcb9C8/fu tUzoFDXm6A9N6bbMeVBsSbr/wp6GsWJpQlQ/SK3OsqsoSHrvbwJMVfWtRXoICyKX0Db/8i mwyMKlSvRVf+uI1VYlY7tHtA4yyWlPM= ARC-Authentication-Results: i=1; imf09.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=b3dpElX9; spf=pass (imf09.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net; dmarc=none ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1672702522; a=rsa-sha256; cv=none; b=GaST4KGwjx++JFl8h/+AZBluiTNy7KfpoLEJV9bhq9R9v4ZqMUT20t6FpXPxMCbjhENiah pSFM2cKBhkruOSsFeEmAu46uwWHgKDyejsOr6HXwvMyQCFya03z6KVpzYoINbgN0/Oa164 Mr6dyHgQLwFjadUnpLSawAU9MT8mzRM= Received: from localhost (unknown [IPv6:2601:281:8300:73::5f6]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id E4C0C6D6; Mon, 2 Jan 2023 23:35:20 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net E4C0C6D6 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1672702521; bh=8Urwkhnl8X2pfaw1kHAwUmTLLQL4RD3KeQARX6NwZkU=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=b3dpElX9lrF8bY2SqAacBRKrkzHM/rKdJm2qvbaZ+Hq0pJel6SdXe+SVKo2vkg2ds FjDMKwPXOpB3z4WVlZwhla8yaU+9gbuymFblf/2XWo3Syos1WdOjC31p3sg+hXVpZl 33hFPhk3NLwKAU0hmi6X2N2HqCfOSnGCnC2VvGnoKwMXC1HMKeucfgxnUJT/uDnQ9p C9wg1Wfdc8Y531+MydMRDCBCsMxrnn9SRzLAMjbmm9Br9vrlqhaNQxoWw06emOMgzh iQLz6aa13KRJyP2ZKmV3DmjQjPHhsn7pUOyowBykiaGdmwhHByNMM9oEFwBeUVM4G+ 3dzHBtJRU6qVQ== From: Jonathan Corbet To: Bagas Sanjaya , 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 , Michal Hocko , Andrew Morton , Hugh Dickins , Shakeel Butt , Bagas Sanjaya Subject: Re: [PATCH 00/10] docs: cgroup-v1: formatting improv for "Memory Resource Controller" doc In-Reply-To: <20221219042209.22898-1-bagasdotme@gmail.com> References: <20221219042209.22898-1-bagasdotme@gmail.com> Date: Mon, 02 Jan 2023 16:35:20 -0700 Message-ID: <87a630h5mv.fsf@meer.lwn.net> MIME-Version: 1.0 Content-Type: text/plain X-Stat-Signature: e6o96rokkwsai5qikegtr79qsh5i13bz X-Rspam-User: X-Rspamd-Queue-Id: 99DF314000D X-Rspamd-Server: rspam06 X-HE-Tag: 1672702522-354865 X-HE-Meta: U2FsdGVkX185PG//LVN4EOmmochyBJCWaGM1s+DwxAhsGUn6JOpKa5lVsJQyfvXJ1ycbidT/uH3gu5h6j/+/6SOJxGyOUOIv63d2Zogg8Up/gndQ5VEwn32iNdp492l+uQGBDilxJ0ewXQD7IsoEzLguzI/BbUFpojeNw+2MPZAK/OgYMVCPxrHNHyy66rEvyUjUB3aboJNRLUXSIY4Q23XE0RoRF7bM2SXllkr2doNONvVVhwI3lWb7L1dAVMizYACa9PiQyLhVo86fsBZhe0cHCaO8iHRo4M4+BHh4eHHRH0JuTiesQ3ARGu5D7n4oY19bAHtC97NRsW/ohdSq0TxcMJLM+ISyWno8Cnyy9u9c6nHEFz4DgQteXiw6pmwp46xvlW0JXQ+o9bGsOvw2sLDZEGBXKbRDKY7KiLWYiOwPV8ANMrFyvKe3LCWYNfkYg5m7WajAlqSzlgMnX9NVdx4hB0R+FMIBeBJiS3sdVwfOQecBWS0DwDIyIBNj8gPGQDiqejutYUT8srm/Nl71xhtWT6K0AhTAbzRXLHEPcfMNFN7DCbmt6pftE5MgUIHAdKeGeNL3WPNVG1GEOqdnjyHVlbgj8YQOtNLc8YN72pqXwXsYEzxMFl3/ioPFK4R5u8aP0GPePhEENEBRjIplxC7Rzudq8BUKH40X/nyoRIp/e0jWUG3XmxvQ3JgdIr9lVD/bcDNExG+SxFnf7YxXTkEXbUxywba6R09BSJbCHF9hyCdwM6+q8S0PSwnYZuu7jWIxqN5JM+iP5y1MitFLbZmxkSvtilj8QDaEFTk6eZnbBhh0KbSXPEjTVqI0Xn/pG4b3ncaIqSzE0Uyfjn72OfezI+sIo0i+KLneezmZTHIG9iHG60VerA== 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: Bagas Sanjaya writes: > "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). > > The first patch is a fix for recently reported htmldocs warning, which can > be pickup separately from rest of the series. > > Bagas Sanjaya (10): > docs: cgroup-v1: extend underline of section 8 > 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: use 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 | 290 ++++++++++-------- > 2 files changed, 158 insertions(+), 134 deletions(-) Tejun, do you have an opinion on these? I'm not really sure we need to be tweaking the v1 docs at this point, but I don't see anything in here that seems harmful either... Thanks, jon