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 X-Spam-Level: X-Spam-Status: No, score=-13.5 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH,MAILING_LIST_MULTI,NICE_REPLY_A,SIGNED_OFF_BY,SPF_HELO_NONE, SPF_PASS,USER_AGENT_SANE_1 autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 3B1E7C388F9 for ; Mon, 26 Oct 2020 19:29:46 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id E2DDD21D41 for ; Mon, 26 Oct 2020 19:29:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1603740586; bh=a26wdCdf9bCqw85y/sGFeprLmddBy9xlonDWIuHfyno=; h=Subject:To:Cc:References:From:Date:In-Reply-To:List-ID:From; b=jfzRghj55Mq8jWfxfje0CL4l5f2aiEMHz72urLPjh8yLY8/nM5OR2aoCPBR3XrwJ5 iSqcrPiKzBSqi78MWt68JmBMTNIrIIUNUWSBIG8m3WbrF20Uu6HyCWjRYO8bs+feQ/ qEWxJJEjjuxWg6We+PpiSA/93O06Tu9kKsQV3Akk= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1793094AbgJZT3p (ORCPT ); Mon, 26 Oct 2020 15:29:45 -0400 Received: from mail-io1-f68.google.com ([209.85.166.68]:43607 "EHLO mail-io1-f68.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2504902AbgJZT3p (ORCPT ); Mon, 26 Oct 2020 15:29:45 -0400 Received: by mail-io1-f68.google.com with SMTP id h21so11404670iob.10 for ; Mon, 26 Oct 2020 12:29:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linuxfoundation.org; s=google; h=subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=UMV5byUKBjbBGS6Lt1DrWfPHlC3+k9ZgGBZmo2bLocc=; b=Q2TAQigSsVBfc+3CtfsNyg/xBg6mB+wEu2UwOsnqhHvLtie0fi2k3LgUhq7gVqvQWa 1Eg0/mCkWS1xcmH5+MRIvOQx1MPUNHfsEqLjWKBULAjhKy2JjILOm99EqchS5v1emELF o/9BMEgQEMRcPoFEofpxQb6etWgTp9KT1HNtI= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=UMV5byUKBjbBGS6Lt1DrWfPHlC3+k9ZgGBZmo2bLocc=; b=P9nCWZqi3P9FvP7lfSzuwgu5ym9VTG7CelIhJ0LpPKXZpK/6/KcaemvbddNUkyD9l8 dVjxiIr6oqxXkdMgcHfekiIWvyFK1xEnWY7MzooOKx5/AwIDH/ZFg1BlmA4mcKiloGaV aKB9DuF366yFdEjHeZ/VSgXp2zEvuBY7fYxQzRQgI7K3ZpG50VZ7g8vL21Ib2pz+2bhb KbHEUVW2XL096nCByDKCphLz8QFCiDj6obclEITuYkX0W0C5Rs/XxSDe0xl+AEy84drx oUDUCRhWEOor/Q00KuoR5mY4n8L6lLShVrUBACnBzCdvY5gjX1fZsB2yRhI5aas3D5zV 2DNw== X-Gm-Message-State: AOAM533kI+oUHIGHLvvYvQVSoay/qUQXlqiSPXijz2bx+5PhbYs7mMyk RH9cBFBl4IR7EzjZ4b66oquVlw== X-Google-Smtp-Source: ABdhPJz50kxjhnGkA7tBJjMYJGZglHA4rKONQTN2uG2aHF17DqnA88/SVwblrea06Ncp3KP5nlY4MQ== X-Received: by 2002:a02:7348:: with SMTP id a8mr12316682jae.76.1603740584118; Mon, 26 Oct 2020 12:29:44 -0700 (PDT) Received: from [192.168.1.112] (c-24-9-64-241.hsd1.co.comcast.net. [24.9.64.241]) by smtp.gmail.com with ESMTPSA id f85sm7066759ill.39.2020.10.26.12.29.42 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 26 Oct 2020 12:29:43 -0700 (PDT) Subject: Re: [PATCH v3 5/6] kunit: test: fix remaining kernel-doc warnings To: Mauro Carvalho Chehab , Linux Doc Mailing List Cc: Jonathan Corbet , Alan Maguire , Brendan Higgins , Iurii Zaikin , Kees Cook , Stephen Boyd , kunit-dev@googlegroups.com, linux-kernel@vger.kernel.org, linux-kselftest@vger.kernel.org, Shuah Khan References: <1c36d295423c5c20c21a7edede0eb29e338dd62a.1603282193.git.mchehab+huawei@kernel.org> From: Shuah Khan Message-ID: <7d7b8947-38db-2b96-21ca-78428b01365b@linuxfoundation.org> Date: Mon, 26 Oct 2020 13:29:42 -0600 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.10.0 MIME-Version: 1.0 In-Reply-To: <1c36d295423c5c20c21a7edede0eb29e338dd62a.1603282193.git.mchehab+huawei@kernel.org> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On 10/21/20 6:17 AM, Mauro Carvalho Chehab wrote: > test.h still produce three warnings: > > include/kunit/test.h:282: warning: Function parameter or member '__suites' not described in 'kunit_test_suites_for_module' > include/kunit/test.h:282: warning: Excess function parameter 'suites_list' description in 'kunit_test_suites_for_module' > include/kunit/test.h:314: warning: Excess function parameter 'suites' description in 'kunit_test_suites' > > They're all due to errors at kernel-doc markups. Update them. > > It should be noticed that this patch moved a kernel-doc > markup that were located at the wrong place, and using a wrong > name. Kernel-doc only supports kaving the markup just before the > function/macro declaration. Placing it elsewhere will make it do > wrong assumptions. > > Fixes: aac35468ca20 ("kunit: test: create a single centralized executor for all tests") > Signed-off-by: Mauro Carvalho Chehab > --- > include/kunit/test.h | 16 ++++++++-------- > 1 file changed, 8 insertions(+), 8 deletions(-) > > diff --git a/include/kunit/test.h b/include/kunit/test.h > index a423fffefea0..14224baca3be 100644 > --- a/include/kunit/test.h > +++ b/include/kunit/test.h Applied to linux-kselftest kunit-fixes branch after auto-fixing the checkpatch warn WARNING: please, no space before tabs #108: FILE: include/kunit/test.h:258: + * ^I^I^I &struct kunit_suite with KUnit.$ total: 0 errors, 1 warnings, 45 lines checked thanks, -- Shuah