Received: by 2002:a05:6358:3188:b0:123:57c1:9b43 with SMTP id q8csp4174980rwd; Tue, 30 May 2023 01:21:22 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ6dCMoSNFuk6kh5ly7ZTyCSNbUqGwqRTsbW9JpW2VXuDbhS/VCgtcT04werkldiiBZSCeVJ X-Received: by 2002:a17:90a:38c7:b0:255:5a5e:df22 with SMTP id x65-20020a17090a38c700b002555a5edf22mr1676009pjb.43.1685434881903; Tue, 30 May 2023 01:21:21 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1685434881; cv=none; d=google.com; s=arc-20160816; b=aejmjQtCtqHcJ1D4UPMUpu4HilcRgh1bWvyYDU+zjGQChJke3g01sXHjz3nyLhcoVu KXPTFCm23+HE1oQLswANgWiIYsT6e18xQ4s+c2abjUMy13jo4wAB7iKxLmVm+mnSe+s4 JzwhBANKoED4FUTlEYzjQ4j8HcXnc05sP5cGZPpTVmXTF6z23kcwMJ3nOZK6Rl0xFbHD ZNBhOYKMREk2dM3Bi7tZIdZZWRxvSD03H2bMDOHrbeOfYH9tHNxecKR+169uIFQ9X0ke BTuAtCxC54cPI1Lf0plqFiQUxfvm308qzDeUn1/YOouxgoewbummuBvMXrHkjQZDr9Jx kbuw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:from:subject:message-id:mime-version:date :dkim-signature; bh=K7ytfWF+UN+RaMrVhdC48WtmycV9AzSbc9oaKd9zjxk=; b=x/ynrcojPjVsO6OBgCOgm5z8cdgUc8QgUc3xAuolEU/FwXzWLhitMlI1TtWun5rlps Bzio1bN3LTvPnejKasU7HC8m8o2d6QV6yd+c7aBgofWxJYqgWA2g122sAmfc4tpRm1ds J3WU0y5exduqE7D2cZ2ZEAMPV0YY4r9plKL30IfsspRocQgVTPOiBrtpy2/7FBdOZHMi yGCc1n2bGjWozBAvdwxGqt6Oaff3QGWNuGbmHAb1/ylQxrtqGLPTpVMGet46Xotn4IfF xbzvJzpWfgh4+PCvcNgqUKJ+PheI1qSiTCODIibkliuc2c3YJaq3ExDgHMHcvfKBnSdu 4dHg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@google.com header.s=20221208 header.b=hOUtLNfZ; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id o27-20020a63921b000000b00534919b4ca2si10069683pgd.151.2023.05.30.01.21.08; Tue, 30 May 2023 01:21:21 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@google.com header.s=20221208 header.b=hOUtLNfZ; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229745AbjE3H4h (ORCPT + 99 others); Tue, 30 May 2023 03:56:37 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50572 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229735AbjE3H4c (ORCPT ); Tue, 30 May 2023 03:56:32 -0400 Received: from mail-yw1-x1149.google.com (mail-yw1-x1149.google.com [IPv6:2607:f8b0:4864:20::1149]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C922F13A for ; Tue, 30 May 2023 00:56:11 -0700 (PDT) Received: by mail-yw1-x1149.google.com with SMTP id 00721157ae682-561eadd916fso88542057b3.1 for ; Tue, 30 May 2023 00:56:11 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20221208; t=1685433371; x=1688025371; h=cc:to:from:subject:message-id:mime-version:date:from:to:cc:subject :date:message-id:reply-to; bh=K7ytfWF+UN+RaMrVhdC48WtmycV9AzSbc9oaKd9zjxk=; b=hOUtLNfZE60vJA625/94v7A5IkhIJF8qwaDymhZkbTk20AZUukm+XNUXuRkmOqBxTQ emjuInDHpiaGcWk91ywLezj4ftmluptwp8vSo4w8KefDtWj+D2Ps2OOU1mbcK1i5du9q yMy3ZkSEaRjVafp68Qak+SPnUEp1k5F7V+1YHfWozVmiQcFDYWWNL39pvnJS6RdEHRkV mqqbnxM6DNQZ5I1bY2FVhqtq2EL1PeXX8affZ7fIFz9mMhdRvy2yrCUJ1bhyB4zfv9Lh jZBiWW68kOSEKWOgWGv3/UQVe5AWDzLldoYAa5pbq6d3fxUtiv4OqwznQkvfId9VTOdJ 29ag== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1685433371; x=1688025371; h=cc:to:from:subject:message-id:mime-version:date:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=K7ytfWF+UN+RaMrVhdC48WtmycV9AzSbc9oaKd9zjxk=; b=JcJgiprVGwl705SdpFIuzAlr0uOFVn67ZaAMqQyLzEzQADCfUUvGmgh3wnCK7WhJ2s bpSXhMYAqXtEpGra7IGT4L6TkV6FcikLtt/Hm2ovVr1o7x2bnImya20UvLqHxIZWxD8p R7E9AHtgax8hhsV9qzSyVvMN7nJ8pn0LZwRMOD2GlZFaU4PaSIjw7puUB+pbWTKLqNPE SOnnQCN6ro6rU9tAg1D4YoG1qFEUeCaIZR199w/zK6W5jR5DXr3k4oi4bYhsSh+uP6mU rDyQ9UGh+lpl2EzKavqUMECPm2nHy64k+2aLxw2VbWtVilAyBXRCPuIyQTMP+5yZBwfC XrNA== X-Gm-Message-State: AC+VfDzb2sQvTOmt52d+lmihvepfY/MGtV66Z+y2gQ54QJLeYVDqShib uUctx1JKcW7SOnxl8zsfOXotd5V8Uwbx6A== X-Received: from slicestar.c.googlers.com ([fda3:e722:ac3:cc00:4f:4b78:c0a8:20a1]) (user=davidgow job=sendgmr) by 2002:a81:ae09:0:b0:560:d237:43dc with SMTP id m9-20020a81ae09000000b00560d23743dcmr911546ywh.3.1685433371096; Tue, 30 May 2023 00:56:11 -0700 (PDT) Date: Tue, 30 May 2023 15:55:57 +0800 Mime-Version: 1.0 X-Mailer: git-send-email 2.41.0.rc0.172.g3f132b7071-goog Message-ID: <20230530075557.1558422-2-davidgow@google.com> Subject: [PATCH] kunit: Fix obsolete name in documentation headers (func->action) From: David Gow To: Brendan Higgins , Shuah Khan Cc: Benjamin Berg , Maxime Ripard , linux-kselftest@vger.kernel.org, kunit-dev@googlegroups.com, linux-kernel@vger.kernel.org, David Gow , Stephen Rothwell Content-Type: text/plain; charset="UTF-8" X-Spam-Status: No, score=-9.6 required=5.0 tests=BAYES_00,DKIMWL_WL_MED, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE, SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE,USER_IN_DEF_DKIM_WL 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: X-Mailing-List: linux-kernel@vger.kernel.org The kunit_add_action() and related functions named the kunit_action_t parameter 'func' in early drafts, which was later renamed to 'action' However, the doc comments were not properly updated. Fix these to avoid confusion and 'make htmldocs' warnings. Fixes: b9dce8a1ed3e ("kunit: Add kunit_add_action() to defer a call until test exit") Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/lkml/20230530151840.16a56460@canb.auug.org.au/ Signed-off-by: David Gow --- include/kunit/resource.h | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/include/kunit/resource.h b/include/kunit/resource.h index b64eb783b1bc..c7383e90f5c9 100644 --- a/include/kunit/resource.h +++ b/include/kunit/resource.h @@ -393,7 +393,7 @@ typedef void (kunit_action_t)(void *); /** * kunit_add_action() - Call a function when the test ends. * @test: Test case to associate the action with. - * @func: The function to run on test exit + * @action: The function to run on test exit * @ctx: Data passed into @func * * Defer the execution of a function until the test exits, either normally or @@ -415,7 +415,7 @@ int kunit_add_action(struct kunit *test, kunit_action_t *action, void *ctx); /** * kunit_add_action_or_reset() - Call a function when the test ends. * @test: Test case to associate the action with. - * @func: The function to run on test exit + * @action: The function to run on test exit * @ctx: Data passed into @func * * Defer the execution of a function until the test exits, either normally or @@ -441,7 +441,7 @@ int kunit_add_action_or_reset(struct kunit *test, kunit_action_t *action, /** * kunit_remove_action() - Cancel a matching deferred action. * @test: Test case the action is associated with. - * @func: The deferred function to cancel. + * @action: The deferred function to cancel. * @ctx: The context passed to the deferred function to trigger. * * Prevent an action deferred via kunit_add_action() from executing when the @@ -459,7 +459,7 @@ void kunit_remove_action(struct kunit *test, /** * kunit_release_action() - Run a matching action call immediately. * @test: Test case the action is associated with. - * @func: The deferred function to trigger. + * @action: The deferred function to trigger. * @ctx: The context passed to the deferred function to trigger. * * Execute a function deferred via kunit_add_action()) immediately, rather than -- 2.41.0.rc0.172.g3f132b7071-goog