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 mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 5FEE7C433EF for ; Thu, 11 Nov 2021 05:40:24 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id ACAC86103B for ; Thu, 11 Nov 2021 05:40:23 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.1 mail.kernel.org ACAC86103B Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=bytedance.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=kvack.org Received: by kanga.kvack.org (Postfix) id CA37B6B00B2; Thu, 11 Nov 2021 00:40:22 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id C53286B00B3; Thu, 11 Nov 2021 00:40:22 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id B1A486B00B4; Thu, 11 Nov 2021 00:40:22 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0097.hostedemail.com [216.40.44.97]) by kanga.kvack.org (Postfix) with ESMTP id A3CFA6B00B2 for ; Thu, 11 Nov 2021 00:40:22 -0500 (EST) Received: from smtpin24.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay05.hostedemail.com (Postfix) with ESMTP id 4F91918524B8E for ; Thu, 11 Nov 2021 05:40:22 +0000 (UTC) X-FDA: 78795549084.24.B35B81F Received: from mail-pl1-f181.google.com (mail-pl1-f181.google.com [209.85.214.181]) by imf24.hostedemail.com (Postfix) with ESMTP id 26C47B0000B4 for ; Thu, 11 Nov 2021 05:40:21 +0000 (UTC) Received: by mail-pl1-f181.google.com with SMTP id k4so4847579plx.8 for ; Wed, 10 Nov 2021 21:40:20 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bytedance-com.20210112.gappssmtp.com; s=20210112; h=message-id:date:mime-version:user-agent:subject:to:cc:references :from:in-reply-to:content-transfer-encoding; bh=meyjLeNOTUfo/ee3VzQRg1KbYxNfJ6VkJ/+ojTjTB4k=; b=0q6iXr1gWfsI3+U1OwmmNzhJdspbuGX62qVda9lzJFerbSiIIpXwFWpmdDVHCbKTxz xfa45O984MSggxxd1HewlseOG6eX2t3ilVMOzK0UdMf5F9IDPoRZZx/+LuMI1GwlXn19 2CLZZMKWfCONJ5ELn/9A7i3YcsPBpMwSy/MiR37wyV/lLOKWIhHRNAa0F8BAeQkQ3E2w 1VFXUl0Nb2jTQp8RijvBVe4fKfvsTA57xHh6fc7WDOnUi34iBT0B87jpgVDULzYqf6/a SQVD6wS+Stvq7I1Ce1X97Y/DCnXBRjeVKczrhIV73oZCGWf1rPOh7x9yDIakERBXVf/y xHaA== 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 :to:cc:references:from:in-reply-to:content-transfer-encoding; bh=meyjLeNOTUfo/ee3VzQRg1KbYxNfJ6VkJ/+ojTjTB4k=; b=OYlbsS3/ASp3bgvoxkZpYcsOn7cbZwtuOUyjeNOqUeI7D3xR1UNgLwYGxIlbysbRdT P0Em1m/Kjyi8yZAtZ/228YPSzK7PY2kORtSnRVr3g+57agYUzyAfBWLlVDXG/NaqkGK0 QfYX8qdWnFAMzFFRySRqZ5Ao6L0lgHkGl5vUMXk/BxFKzSafgXbnOsYJwjE0kIbO3Qwt e7mLixbxe/XEhfDX5FJho/tRltOoZUzBB8Nxc/YYvFAl08BBpdbZeDhhfkNt2/YI1PvV xaU/t6SlOpJez7Y/JpmOKSahG5afGrGPvBjV5+BkcHuroQPNJuSHxoGixjv/kYFTLFNF c6tQ== X-Gm-Message-State: AOAM533EwNK8Oz52fUhwmePPKrEVIO8IH7NOujCzburgkO/bn+CkLfpJ GoIU0vCNwJ9L5d+7ZzM79XcbjQ== X-Google-Smtp-Source: ABdhPJwgrx/NnYB9a213ApL25hip5UQURu1AsnZb8zCu64ngyBsg/8QSfliZKaJvOKT2rhze5DC6Wg== X-Received: by 2002:a17:902:c943:b0:142:1758:8ee7 with SMTP id i3-20020a170902c94300b0014217588ee7mr4920255pla.58.1636609219858; Wed, 10 Nov 2021 21:40:19 -0800 (PST) Received: from [10.254.173.217] ([139.177.225.248]) by smtp.gmail.com with ESMTPSA id bt2sm7134464pjb.33.2021.11.10.21.40.14 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 10 Nov 2021 21:40:19 -0800 (PST) Message-ID: <9e630c7a-8c29-3a05-5056-a045e11c7949@bytedance.com> Date: Thu, 11 Nov 2021 13:40:11 +0800 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:91.0) Gecko/20100101 Thunderbird/91.3.0 Subject: Re: [PATCH v3 14/15] Documentation: add document for pte_ref To: Jonathan Corbet , akpm@linux-foundation.org, tglx@linutronix.de, kirill.shutemov@linux.intel.com, mika.penttila@nextfour.com, david@redhat.com, jgg@nvidia.com Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org, songmuchun@bytedance.com, zhouchengming@bytedance.com References: <20211110105428.32458-1-zhengqi.arch@bytedance.com> <20211110105428.32458-15-zhengqi.arch@bytedance.com> <875yt0krcj.fsf@meer.lwn.net> From: Qi Zheng In-Reply-To: <875yt0krcj.fsf@meer.lwn.net> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Authentication-Results: imf24.hostedemail.com; dkim=pass header.d=bytedance-com.20210112.gappssmtp.com header.s=20210112 header.b=0q6iXr1g; spf=pass (imf24.hostedemail.com: domain of zhengqi.arch@bytedance.com designates 209.85.214.181 as permitted sender) smtp.mailfrom=zhengqi.arch@bytedance.com; dmarc=pass (policy=none) header.from=bytedance.com X-Rspamd-Server: rspam04 X-Rspamd-Queue-Id: 26C47B0000B4 X-Stat-Signature: en65xpwxsjrhcu5nu8iumb6r3o9sxs53 X-HE-Tag: 1636609221-953905 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 11/10/21 10:39 PM, Jonathan Corbet wrote: > Qi Zheng writes: > >> This commit adds document for pte_ref under `Documentation/vm/`. > > Thanks for documenting this work! > >> Signed-off-by: Qi Zheng >> --- >> Documentation/vm/pte_ref.rst | 212 +++++++++++++++++++++++++++++++++++++++++++ >> 1 file changed, 212 insertions(+) >> create mode 100644 Documentation/vm/pte_ref.rst > > When you add a new RST file, you also need to add it to the associated > index.rst file or it won't be included in the docs build. Instead, > you'll get the "not included in any toctree" warning that you surely saw > when you tested the docs build with this file :) OK, I will add it to the associated index.rst in the next version. > >> diff --git a/Documentation/vm/pte_ref.rst b/Documentation/vm/pte_ref.rst >> new file mode 100644 >> index 000000000000..c5323a263464 >> --- /dev/null >> +++ b/Documentation/vm/pte_ref.rst >> @@ -0,0 +1,212 @@ >> +.. _pte_ref: > > Do you need this label anywhere? If not, I'd leave it out. I will remove this label in the next version. Thanks, Qi > > Thanks, > > jon >