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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 244E3C6FA82 for ; Mon, 19 Sep 2022 09:31:03 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229790AbiISJbA (ORCPT ); Mon, 19 Sep 2022 05:31:00 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:46054 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229555AbiISJa6 (ORCPT ); Mon, 19 Sep 2022 05:30:58 -0400 Received: from szxga01-in.huawei.com (szxga01-in.huawei.com [45.249.212.187]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 6430417061; Mon, 19 Sep 2022 02:30:54 -0700 (PDT) Received: from canpemm500002.china.huawei.com (unknown [172.30.72.55]) by szxga01-in.huawei.com (SkyGuard) with ESMTP id 4MWK914PJCzpSxq; Mon, 19 Sep 2022 17:28:05 +0800 (CST) Received: from [10.174.177.76] (10.174.177.76) by canpemm500002.china.huawei.com (7.192.104.244) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.31; Mon, 19 Sep 2022 17:30:52 +0800 Subject: Re: linux-next: build warning after merge of the mm tree To: Stephen Rothwell CC: Linux Kernel Mailing List , Linux Next Mailing List , Andrew Morton References: <20220919190938.0948bd0e@canb.auug.org.au> From: Miaohe Lin Message-ID: <1bc55727-9b66-0e9e-c306-f10c4716ea89@huawei.com> Date: Mon, 19 Sep 2022 17:30:51 +0800 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.6.0 MIME-Version: 1.0 In-Reply-To: <20220919190938.0948bd0e@canb.auug.org.au> Content-Type: text/plain; charset="windows-1252" Content-Language: en-US Content-Transfer-Encoding: 7bit X-Originating-IP: [10.174.177.76] X-ClientProxiedBy: dggems703-chm.china.huawei.com (10.3.19.180) To canpemm500002.china.huawei.com (7.192.104.244) X-CFilter-Loop: Reflected Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 2022/9/19 17:09, Stephen Rothwell wrote: > Hi all, > > After merging the mm tree, today's linux-next build (htmldocs) produced > this warning: > > include/linux/gfp.h:1: warning: no structured comments found > > Introduced by commit > > 4f57293dcaaa ("mm/page_alloc: remove obsolete gfpflags_normal_context()") Many thanks for report. It seems there's no structured comments for htmldocs left after above commit. So I think htmldocs for this file should be deleted. Does below code change fixes the warning? diff --git a/Documentation/core-api/mm-api.rst b/Documentation/core-api/mm-api.rst index 1ebcc6c3fafe..f5dde5bceaea 100644 --- a/Documentation/core-api/mm-api.rst +++ b/Documentation/core-api/mm-api.rst @@ -19,9 +19,6 @@ User Space Memory Access Memory Allocation Controls ========================== -.. kernel-doc:: include/linux/gfp.h - :internal: - .. kernel-doc:: include/linux/gfp_types.h :doc: Page mobility and placement hints It will be really appreciated if you can help verify this. Thanks a lot. :) Thanks, Miaohe Lin