Received: by 2002:a05:6a10:2726:0:0:0:0 with SMTP id ib38csp5633492pxb; Mon, 28 Mar 2022 15:15:29 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwMixQsBPsjefoXYj37p3O3jWQMyZTjgYJqtKmHnRDPPVuUJOeVGCIDOidrWlqyiJ163i5n X-Received: by 2002:ac8:7d56:0:b0:2e0:6591:2bbb with SMTP id h22-20020ac87d56000000b002e065912bbbmr24196058qtb.505.1648505729139; Mon, 28 Mar 2022 15:15:29 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1648505729; cv=none; d=google.com; s=arc-20160816; b=wughf8Zi7tXWEsoxGlJCg24K4cgZKtE9mzuloK7tg/m6C3ZN61LGkW1yTezzutG851 jX3TbQuSkL5KF5RhAULFAbTCfAwwbS9CkNQoIuNRByfnDLg8qze6MoDCsUuNTDVKHHS+ IVYwU7Myl/AJ6kC7dAXNsNKE31Zx8zP4qi3nuK+a9GEdkk3wAGkrwLnnrNHn/NrVRNiZ 5wudyKJ+fG3JOq0GSqT0BXOt7HPFDt6TDUJI8ZhJ0WPZmpb0VldXzow6Sx/L1OryJsCw kk18DKd6ThkEJFGuJ3OPFNjom55MC9i5mBnBRZKNZPk5fHcO1mnQsZSz7VTholRg6ihD XxUw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:subject:message-id:date:from:in-reply-to :references:mime-version:dkim-signature; bh=TjNuhCXe+PjFnTXBHLrLoeoTTYDdDeH8ei+EheLHkDc=; b=eCDlbHpjH3+tmoOF6AN0qKAqjsi8tMRWaDhI6RlXUDUhgtMP9NZL/cm54lIyFqit+J G73ZG8jsG+S3LPOfHkUHK82Q4CeIzqmfO7g8zu+3Xgo+6dVtZ4lUIoB2swvHhIsJeEx/ IyPry3Ufijghlfq5Syhz0D+Rahlmp+trW4eaCnqu6Jh/PHUqZP5hMdF9j6teN0WPgC1K gujSPDio+p2DGL02Rj7kxOrdS084MTZLurBHFHjmazHUZazX4XEQRsJgcf6y8wfEls38 tRTiuqvTnalhG47VWD1fHIGEqmbBU9Da/36Wf0+2o+SjU1in4yk2JmoMsdnrHcUPJ8P2 50ZQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@google.com header.s=20210112 header.b=MyfZrav6; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:18 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 lindbergh.monkeyblade.net (lindbergh.monkeyblade.net. [2620:137:e000::1:18]) by mx.google.com with ESMTPS id x13-20020a67ae0d000000b003253c21449csi3531049vse.351.2022.03.28.15.15.28 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 28 Mar 2022 15:15:29 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:18 as permitted sender) client-ip=2620:137:e000::1:18; Authentication-Results: mx.google.com; dkim=pass header.i=@google.com header.s=20210112 header.b=MyfZrav6; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by lindbergh.monkeyblade.net (Postfix) with ESMTP id 542281760C6; Mon, 28 Mar 2022 14:33:55 -0700 (PDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S243534AbiC1Qx4 (ORCPT + 99 others); Mon, 28 Mar 2022 12:53:56 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42482 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S244439AbiC1QxM (ORCPT ); Mon, 28 Mar 2022 12:53:12 -0400 Received: from mail-ej1-x633.google.com (mail-ej1-x633.google.com [IPv6:2a00:1450:4864:20::633]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 5F8FD52E2A for ; Mon, 28 Mar 2022 09:51:31 -0700 (PDT) Received: by mail-ej1-x633.google.com with SMTP id pv16so30004989ejb.0 for ; Mon, 28 Mar 2022 09:51:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=TjNuhCXe+PjFnTXBHLrLoeoTTYDdDeH8ei+EheLHkDc=; b=MyfZrav6RgVjpKFdewxmvRPK3g8FVlWpFb0ATz57iua3B4pBl1QfVbGAhpJj+wif/X zTaSikLrHqFkPCcjkGeCg2uYN1eI+SzvtyKPbnerWds66SzTQYxlP4tvsakATAdmnvU6 YPHyaWANcejF028m7vh50waXCYMhqqtAbmijQhm7hb+lVtsfKTnyrWWi47jlvP3Ux53D 4yKpm1j5btuQDw53Iqud6mEVTKdXMZm09X1has8IrWks1DrRrOZwLduZ8vygERXf0dUN WWfAl4rn6WWHkw0/shVKhml2sHveGN6mTjNhMW9eZncM3wiza2Mn+LLb5Fz2NZWtOd6Z uJmA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=TjNuhCXe+PjFnTXBHLrLoeoTTYDdDeH8ei+EheLHkDc=; b=Fs0e/lb7OSdqMhonbfCoZlRXLzF73mhBbb9JwH7sIetuijpplIeIpgmKLCHiyk1424 n08z1oZs4WlDOymnJrIZAe/gngflqD6RMgIXwn9p95B1oPyugz+7arEds3E5vqmdt83e LtAHNmEUK1lmr9ap3sBad2/U3vDsoIyKUqdtIJLY7dQNivBQjocvhrF3zsSEDm25w9MG KNr5a+cmB2Dg+ZTWOfmIiesTRWXWb+yD5tQdCgV52AtwPHqYwC+uqxtufynzBrMzgw7p FG1cRtqsLAHbwSX1d6pbAphC9P+og0tQlOmyg4UfGcYu5axUFT06rogsuWtTYea3wXiW pOXQ== X-Gm-Message-State: AOAM530N3GMjzIZbUKhygSXXtGDLcpSKGBPhwLuXRAF2QhFspL29gmbp u4pm+2330IsFhA2yEKhjGNDiaEK+VU4GhHVR5n2JDw== X-Received: by 2002:a17:907:c018:b0:6df:e31b:d912 with SMTP id ss24-20020a170907c01800b006dfe31bd912mr28886127ejc.196.1648486286570; Mon, 28 Mar 2022 09:51:26 -0700 (PDT) MIME-Version: 1.0 References: <20220326054414.637293-1-davidgow@google.com> In-Reply-To: <20220326054414.637293-1-davidgow@google.com> From: Brendan Higgins Date: Mon, 28 Mar 2022 12:51:15 -0400 Message-ID: Subject: Re: [PATCH] Documentation: kunit: Fix cross-referencing warnings To: David Gow Cc: Jonathan Corbet , Marco Elver , Daniel Latypov , skhan@linuxfoundation.org, kunit-dev@googlegroups.com, linux-doc@vger.kernel.org, linux-kselftest@vger.kernel.org, linux-kernel@vger.kernel.org Content-Type: text/plain; charset="UTF-8" X-Spam-Status: No, score=-9.5 required=5.0 tests=BAYES_00,DKIMWL_WL_MED, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RDNS_NONE,SPF_HELO_NONE,T_SCC_BODY_TEXT_LINE, USER_IN_DEF_DKIM_WL autolearn=no 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 On Sat, Mar 26, 2022 at 1:45 AM David Gow wrote: > > The Architecture chapter of the KUnit documentation tried to include > copies of the kernel-doc for a couple of things, despite these already > existing in the API documentation. This lead to some warnings: > > architecture:31: ./include/kunit/test.h:3: WARNING: Duplicate C declaration, also defined at dev-tools/kunit/api/test:66. > Declaration is '.. c:struct:: kunit_case'. > architecture:163: ./include/kunit/test.h:1217: WARNING: Duplicate C declaration, also defined at dev-tools/kunit/api/test:1217. > Declaration is '.. c:macro:: KUNIT_ARRAY_PARAM'. > architecture.rst:3: WARNING: Duplicate C declaration, also defined at dev-tools/kunit/api/test:66. > Declaration is '.. c:struct:: kunit_case'. > architecture.rst:1217: WARNING: Duplicate C declaration, also defined at dev-tools/kunit/api/test:1217. > Declaration is '.. c:macro:: KUNIT_ARRAY_PARAM'. > > Get rid of these, and cleanup the mentions of the struct and macro in > question so that sphinx generates a link to the existing copy of the > documentation in the api/test document. > > Fixes: bc145b370c ("Documentation: KUnit: Added KUnit Architecture") > Signed-off-by: David Gow Reviewed-by: Brendan Higgins Tested-by: Brendan Higgins