From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 1CBCD1E1A3D; Fri, 14 Nov 2025 21:11:27 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763154688; cv=none; b=tSfrglwXe+Bgzc9dd8p+uj+oUSRndajt+fu266wYCZZzHCksj+7kPsx8Q+2NtwDc/GVcDnH+K3c4qfRGeeisgLY/zqxFYugIAhh3/ad86UcHPtAq0L9LwCG9WHsY6/tUAFwLOd+RmNz6ruPWX1LxhrSr+oSCq3+O7LWZ6Rwl3Zw= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763154688; c=relaxed/simple; bh=7AUZ2qMbVGNlnVWU3OOoHOhP0pZer04KISPztcjt8S8=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=cpwBdxHNtVYE8BO9Rh87cTKu/vH/e9y98OfSLf0Lmiq9LVlbs/5o5fTBk5n9Nq7lO/EfH3bPQJ6g9cyIWuMfc0iYXsgr6/CSi/8LX9ZXzR/d7+7pc3H8TgC5fwwCrMGHubTSu7LVC60Gv3wRPzEoh2ghR3V4D3IC2FtkVAHMBSg= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=O33RyYWG; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="O33RyYWG" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 7D278C113D0; Fri, 14 Nov 2025 21:11:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1763154687; bh=7AUZ2qMbVGNlnVWU3OOoHOhP0pZer04KISPztcjt8S8=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=O33RyYWGKXDohGHEJtAM2maj1QXbHB4Ea5eUROXVCjkKaeEGVJF/iNkF5dwPlNOLt DGnJK4huxQkkXl9X1AtHTnYawU9Yh1eY0U7GOG4qYFKNuJZHQ8QSC0RIL1L7MoEsys 88WhhDwxqeG7dqu6tecHnFUxnwneGCbN4XjZ//zE4PGErZNiff75FnsTqy3sx6cSZa f5LsRplwNhr35umWBS7QH1Lv7y8pAZvDjumyxhcGDcXcZqP3Srp3UPjKTWdV7S+WtP x2XiJYMqIUjiy8hVnravF1Ik3N4s2C0Kwt4Fy/ilEoEKucZVheSL+QUlS73LGC7r+C hP9BVs+JS1+MQ== Date: Fri, 14 Nov 2025 11:11:26 -1000 From: Tejun Heo To: Michal =?iso-8859-1?Q?Koutn=FD?= Cc: Jonathan Corbet , cgroups@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Natalie Vock , Maarten Lankhorst , Johannes Weiner Subject: Re: [PATCH RESEND 1/3] docs: cgroup: Explain reclaim protection target Message-ID: References: <20251110193638.623208-1-mkoutny@suse.com> <20251110193638.623208-2-mkoutny@suse.com> <87wm3xwtcm.fsf@trenco.lwn.net> Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: On Fri, Nov 14, 2025 at 07:29:28PM +0100, Michal Koutný wrote: > On Mon, Nov 10, 2025 at 01:00:41PM -0700, Jonathan Corbet wrote: > > > @@ -53,7 +53,8 @@ v1 is available under :ref:`Documentation/admin-guide/cgroup-v1/index.rst > > 5-2. Memory > > > 5-2-1. Memory Interface Files > > > 5-2-2. Usage Guidelines > > > - 5-2-3. Memory Ownership > > > + 5-2-3. Reclaim Protection > > > + 5-2-4. Memory Ownership > > > > I always have to ask...do we really need the manually maintained TOC > > here? > > Tejun [1] (and maybe some others) like it. I'm not married to it but I think a lot of people including me just read the source docs without ever formatting them. It is kinda nice to have ToC for them. Maybe section numbers are too error-prone, I don't know. Thanks. -- tejun