Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) client-ip=23.128.96.37;
Date:   Wed, 22 Nov 2023 10:08:10 +0800
From:   Yujie Liu <yujie.liu@intel.com>
To:     Randy Dunlap <rdunlap@infradead.org>
CC:     Waiman Long <longman@redhat.com>,
        kernel test robot <lkp@intel.com>,
        <oe-kbuild-all@lists.linux.dev>, <linux-kernel@vger.kernel.org>,
        Tejun Heo <tj@kernel.org>
Subject: Re: kernel/cgroup/debug.c:1: warning: no structured comments found
Message-ID: <ZV1iimYpmpk9LZWS@yujie-X299>
References: <202311211005.Qwt1FHrO-lkp@intel.com>
 <569119a8-f6f2-4e00-bfcc-5b804447320f@redhat.com>
 <2a4813ff-54a7-49b0-8d18-4cb54621e637@infradead.org>
Content-Type: text/plain; charset="iso-8859-1"
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <2a4813ff-54a7-49b0-8d18-4cb54621e637@infradead.org>
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?iso-8859-1?Q?tzvqHp3rQwg5J6nKckxw/T/i7VtKBN1lzPU5Ua8W1+drbLD6cMJGZnSnZL?=
 =?iso-8859-1?Q?n560P0r7pDTATg1PcbWMZ+ecSuePpHoyqrNv5Egq2Le+ud/8a0R1PZxxfg?=
 =?iso-8859-1?Q?dYKE+htp1Sd8RKeP5DYX9NS4AzkP2hTGDsKx7havxZIaD1SdbJHPLxHSYW?=
 =?iso-8859-1?Q?RZuQPqtLqLJ6/cUxepRC16AzCu0ZxFR5R/ReXmQBxz7/8oYbv4QpY0zD+1?=
 =?iso-8859-1?Q?9stc9PYD5pTJfL9znuUhyDo1PhrW+ZhYpxO3tiKCIghXdbPfL7CwgpDZiB?=
 =?iso-8859-1?Q?GtYqu81jbVRTaQpUaJWyVQNolh2IuPHF8k8RMfvJz2bj40fHcM20QnTao0?=
 =?iso-8859-1?Q?KTISyoFXKq/XkySYYMvioUttkOJj9w18vNSpRrnSuFl7S+7r3wDNdai/5a?=
 =?iso-8859-1?Q?P/P4c48X72JRRqIA4WNUgrPeHyaSd94qBXMjBlnHabFnvFetyOLP/U1TW9?=
 =?iso-8859-1?Q?1dwv8It4q9AyX0sD4HXUgiFyKMYDjQ4X9VyPS3hnABW6MplmW7zbRhyHqb?=
 =?iso-8859-1?Q?qyfagF4NQIE48wQDUK8c0WHw7y4ZSVp0QEknbi0BzGQP3oF7pE1qf0vj1p?=
 =?iso-8859-1?Q?lYudbF52eVql4/++V5jOJBW5uWf+BKXrqiWNOyS1R3ZOgDtKcjsvNp9xyr?=
 =?iso-8859-1?Q?/pcRloR7wduAqOrWSuEw5fYaMYOY7AxlwcktWB87LVY9DU/sooB4nW/JHB?=
 =?iso-8859-1?Q?qYSXjULheHXh+FY18b1Rbw/IGtT2DziGHADXso6h5mv87CrRTaPKXcVvlu?=
 =?iso-8859-1?Q?1Djn9YbnWesTJteV779gkdXzuLjUcU+5KEFaOAPXhRqywxV+qnFXV/5DSk?=
 =?iso-8859-1?Q?bCFx6jVU6uZPRhYU3TQtUWLuOOneEKtEm4LjbVg8yaTQEAoJesJY2SgGlY?=
 =?iso-8859-1?Q?GwFrmEMTsNyPC39fFtxuSZysiX+LxUXL4JPeadlOQkkpHD1Dxo0bGFzSMW?=
 =?iso-8859-1?Q?UHh3krdyGT0G9SKgR5nu8hhbrsXPSm3GWJS+yblsnNoPQOrQnnEVLgjw6T?=
 =?iso-8859-1?Q?RnzFI9JmVXF6v/+pPW91FfQCbUSvEjaf6pqVddK/1VVgsyVqImVbc3T8eQ?=
 =?iso-8859-1?Q?D2st/XlPM5xDlo24JERChWnNCieuGTN0wkhJtQcxQXIMqMJSqyyLeKiMzQ?=
 =?iso-8859-1?Q?id/Gobhxn70xEG6sSGW4PFzyr9zykMwMsmgvkOfhs++i8DLIL8hvp2nJpf?=
 =?iso-8859-1?Q?409DbljKCVFP3vWbXCCJB5DlWKCpYeGuKKzusZDA0J8EAfwOBt+BgaNcjf?=
 =?iso-8859-1?Q?4qCD6YKArenjYtiKLQWD9huAhdWRx+gttH+OyKPy3mdT7k13MofCcOUXbo?=
 =?iso-8859-1?Q?4lwxE8TFXl1Rs9WPx+x3eqyviQpujzFTTsy4OuHO4t5HbmGI+KcYZqtBdS?=
 =?iso-8859-1?Q?nMF+bMEIHyrhwlvCF/OqG6eYwUJDo5XVjEZrqtcuHedrnB+vBbHTYmYkYL?=
 =?iso-8859-1?Q?VuIt7yBc+z/YOTArWgd+Kg7hHguLdTEb2mUsumArfZYnZKh8UjIt6cM6gx?=
 =?iso-8859-1?Q?iJbit2Y8W2qlzT6bueMjgU/N+fAs++Cazov4U4mrwgTJjVRrfgkY7ECY07?=
 =?iso-8859-1?Q?c7jM0PaS+GM8fqJDSreA3REYLNpnoqjWuDCnvWnUxU0bMJwHvXqfaPm1ZB?=
 =?iso-8859-1?Q?02TWKblAmajnof1M8WcJsYaHPvhI1WWDU8?=
X-MS-Exchange-CrossTenant-Network-Message-Id: 81e49883-e548-4aed-7996-08dbeb008573
X-MS-Exchange-CrossTenant-AuthSource: CY5PR11MB6392.namprd11.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Nov 2023 02:12:47.7629
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 46c98d88-e344-4ed4-8496-4ed7712e255d
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: Ct2ABtlQvCfgqQUnOg01PJxkRl+6wBYjbbksdpuiI/acdkDrkvrIff4PRWSgs32GlCnaWql3ag74VczHwxD7cQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH3PR11MB7938
X-OriginatorOrg: intel.com
X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,
        DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,
        SPF_HELO_NONE,SPF_NONE,T_SCC_BODY_TEXT_LINE autolearn=ham
        autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org
X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Tue, 21 Nov 2023 18:12:58 -0800 (PST)

On Mon, Nov 20, 2023 at 08:11:07PM -0800, Randy Dunlap wrote:
> Hi,
> 
> On 11/20/23 19:04, Waiman Long wrote:
> > 
> > On 11/20/23 21:32, kernel test robot wrote:
> >> tree:?? https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
> >> head:?? 98b1cc82c4affc16f5598d4fa14b1858671b2263
> >> commit: a28f8f5e995fe5964ae304444913536058f26e37 cgroup: Move debug cgroup to its own file
> >> date:?? 6 years ago
> >> config: i386-buildonly-randconfig-005-20231120 (https://download.01.org/0day-ci/archive/20231121/202311211005.Qwt1FHrO-lkp@intel.com/config)
> >> compiler: gcc-7 (Ubuntu 7.5.0-6ubuntu2) 7.5.0
> >> reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231121/202311211005.Qwt1FHrO-lkp@intel.com/reproduce)
> >>
> >> If you fix the issue in a separate patch/commit (i.e. not just a new version of
> >> the same patch/commit), kindly add following tags
> >> | Reported-by: kernel test robot <lkp@intel.com>
> >> | Closes: https://lore.kernel.org/oe-kbuild-all/202311211005.Qwt1FHrO-lkp@intel.com/
> >>
> >> All warnings (new ones prefixed by >>):
> >>
> >>>> kernel/cgroup/debug.c:1: warning: no structured comments found
> >>
> >> vim +1 kernel/cgroup/debug.c
> >>
> >> ??? > 1??? #include <linux/ctype.h>
> >> ????? 2??? #include <linux/mm.h>
> >> ????? 3??? #include <linux/slab.h>
> >> ????? 4???
> > 
> > Yes, there is no function in this file with structure comments. This debug controller is used for debugging only and is not supposed to be used on production systems anyway. Its interface is unstable and so I don't see a need to properly document its interface.
> > 
> > I will leave this file as it is for now.
> 
> Yes :)
> 
> 
> This warning usually happens when some file is referenced in the
> Documentation/ tree while building 'make htmldocs', e.g.
> 
> But this source file is not used in Documentation/ at all,
> so this report seems to have some kind of a problem.
> Also, I could not reproduce the warning.

Thanks for the information. We've configured the bot to ignore this
warning. Sorry for the noise.

Best Regards,
Yujie