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 0E017C433EF for ; Wed, 6 Apr 2022 04:56:26 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 560026B0072; Wed, 6 Apr 2022 00:56:16 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 50F476B0073; Wed, 6 Apr 2022 00:56:16 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 3D7056B0074; Wed, 6 Apr 2022 00:56:16 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0110.hostedemail.com [216.40.44.110]) by kanga.kvack.org (Postfix) with ESMTP id 2EB806B0072 for ; Wed, 6 Apr 2022 00:56:16 -0400 (EDT) Received: from smtpin24.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay04.hostedemail.com (Postfix) with ESMTP id D4E42AC05E for ; Wed, 6 Apr 2022 04:56:05 +0000 (UTC) X-FDA: 79325242290.24.7AA3451 Received: from mail-pf1-f180.google.com (mail-pf1-f180.google.com [209.85.210.180]) by imf10.hostedemail.com (Postfix) with ESMTP id 59DC0C001F for ; Wed, 6 Apr 2022 04:56:05 +0000 (UTC) Received: by mail-pf1-f180.google.com with SMTP id z16so1458921pfh.3 for ; Tue, 05 Apr 2022 21:56:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=message-id:date:mime-version:user-agent:subject:content-language:to :cc:references:from:in-reply-to:content-transfer-encoding; bh=XBTdao9jI2D9lmUstuUU/m3zazcNfOzNZk+VV+cPROc=; b=o2agCgrxWu1S/e5lz0xVtEak+ZjQkhVy9NqMyYFzMyY9ik/F5+gNKctB0njKq7ces1 aI/9JWwLMVlb+SvDL4nLGYceD8GUnBuB/ONF0LmL/uiVr3LrEJ/UZM7qBmuRV19R/Lqq eEg/JAcATqtsVoCvUWoIIqBN/6e5wq5qRQfvABEdDppWnVMgzARscEEzZjgQeVUdVG5M fxerWuCIAL3EyhOtgbvIVu58ec4jw1A/ts/oS3qgv6TNXThW00V0lAflUITHPoQp0bs6 yWv0l3EIHNotko3JivWOqOdwgXH7rq89XnKq9MNou+P2mCs5gQDzXfocQIhR/IjQ0aaJ m8dQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:message-id:date:mime-version:user-agent:subject :content-language:to:cc:references:from:in-reply-to :content-transfer-encoding; bh=XBTdao9jI2D9lmUstuUU/m3zazcNfOzNZk+VV+cPROc=; b=Mm/8xwxT93nCkzyyZG+jYeEOVbh+02rHGMlEyCv1Bd/3pKBdq3Gj7xEkJnk7cEuS0I lNEn9WYsfPBI0PMOFzGdikSPIcju3OaozRgx2XTvN/h9UeCKpDMAjFRXdKkmLLs9eO/Y 0PjdyATcUZwFNPpKti2B53C0ZSTfAPASXhCQYhsWdkxNKfOcZsPK+IMJv68JDP7YVN0v 6JJAUAuZdGsRSmFQI2Rz0wNET3KDYLJJ3my/aWx6vtckNWdCo2n38G45LroRGHSJ1Y3E WMXh6dUpIDTYHCE5HVT/tvTv30OrdPKP4AtSCOmUlLYTxbXAzNM5KJ+fHbIK8d0s2WSR Je+A== X-Gm-Message-State: AOAM533G+2+IKyx2Y+14dfgdMwEcR8IIuV5FN2xdCydXJRIV3HIXteH5 KoVgNiC4IyBCWkfmep+O8uc= X-Google-Smtp-Source: ABdhPJytkJ6f/uulz3QgK3M86/NPKKlfRJs2XNZcJl7LiOP0j6bY87u1/erao2AY0FPEkWDZU/f7xw== X-Received: by 2002:a63:cf12:0:b0:399:38a7:5063 with SMTP id j18-20020a63cf12000000b0039938a75063mr5592832pgg.311.1649220964192; Tue, 05 Apr 2022 21:56:04 -0700 (PDT) Received: from [192.168.43.80] (subs03-180-214-233-9.three.co.id. [180.214.233.9]) by smtp.gmail.com with ESMTPSA id s24-20020a17090a441800b001ca9b5724a6sm3858330pjg.36.2022.04.05.21.55.59 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 05 Apr 2022 21:56:03 -0700 (PDT) Message-ID: Date: Wed, 6 Apr 2022 11:55:56 +0700 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.7.0 Subject: Re: [PATCH] Documentation: arch_pgtable_helpers: demote pgtable list headings Content-Language: en-US To: Jonathan Corbet , linux-doc@vger.kernel.org Cc: "David S. Miller" , Andrew Morton , Greg Kroah-Hartman , Jens Axboe , "Rafael J. Wysocki" , Anshuman Khandual , Pasha Tatashin , linux-mm@kvack.org, linux-kernel@vger.kernel.org References: <20220326131313.691027-1-bagasdotme@gmail.com> <87k0c3ecc1.fsf@meer.lwn.net> From: Bagas Sanjaya In-Reply-To: <87k0c3ecc1.fsf@meer.lwn.net> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Authentication-Results: imf10.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=o2agCgrx; spf=pass (imf10.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.210.180 as permitted sender) smtp.mailfrom=bagasdotme@gmail.com; dmarc=pass (policy=none) header.from=gmail.com X-Stat-Signature: rfo9dy8rktmeeyu75tzcukcmxom3u4me X-Rspam-User: X-Rspamd-Server: rspam12 X-Rspamd-Queue-Id: 59DC0C001F X-HE-Tag: 1649220965-392725 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: On 05/04/22 23.15, Jonathan Corbet wrote: > Bagas Sanjaya writes: > >> Demote pgtable list headings from title heading to chapter heading. > > This is a classic example of the sort of changelog that says *what* the > patch does (which we can also see from the patch itself) but not *why*. > Why do these headings need to be changed? > In this case, before this patch, generated table of contents for vm/ contains: - Active MM - Architecture Page Table Helpers - PTE Page Table Helpers - PMD Page Table Helpers - PUD Page Table Helpers - HugeTLB Page Table Helpers - SWAP Page Table Helpers - Memory Balancing ... The headings for PTE, PMD, PUD, HugeTLB, and SWAP Page Table Helpers should be subheading of Architecture Page Table Helpers, but these were marked up with page title heading instead of chapter heading. -- An old man doll... just what I always wanted! - Clara