Received: by 2002:a05:6512:2355:0:0:0:0 with SMTP id p21csp5516818lfu; Mon, 28 Mar 2022 15:49:12 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwM8y22pslZgaK2IpZ3EJ3823bToFMLEZZXSd1c5aeVFnOl2Bwy5e3ulVY4u63y+fIZ2sX+ X-Received: by 2002:a17:902:c949:b0:154:5215:1db1 with SMTP id i9-20020a170902c94900b0015452151db1mr27695773pla.163.1648507752040; Mon, 28 Mar 2022 15:49:12 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1648507752; cv=none; d=google.com; s=arc-20160816; b=m/DYVxmNmffFyMXlvmejNE2gaDt4gN35ziN1V01r/PU0dYAgUiWmfZhCOosQE3C/V4 k/RcOYLuXhVUjRdaL4o3UXG4h0JA4qIqrVpY61FqI2ZdPqmOKXgvY2X1W+KH4oLhaoIU 4tP6E5sNF3f6DZ7T4rjYji3RqIl+fOGu2HALZMPmwy6tulY0e5QeeByVtWm4cNY/+YwG H3seiCrWWw0guXOVl3z4CUfJX+BZP8Y1tTKbK9wMGVAHtjyElUYcaKnPKnCmTax4KkYL zeRjZ7PFZ7WbDeK5ZtaYTem9XQ2iDkVRH1bEDhnwO7fQ2ZYN3/Xg2UFRNlxqi6WI3PUb AjIw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:dkim-signature:dkim-filter; bh=PwIBFic52cB+8cV6Ms4Smf/K/c9Y0vVMor8KDA0YN2c=; b=fnwQGSGF8qnnkaWUi5sq1iPVkhfslmaTmvybquJ5e8yvrC+XQjqSSZjC4faRfQg1d6 VKafjG4n0R6MTCdtNNN2wgiX1wk04KkcZGFIiDEq8JJ8RQelszw9OCYZYQeukRaXJxrV 9rD+zxAL9PoGmcdJquSUnNF5LvYYDNN66mIajJgD6HYt1Lp+ymBY1FgjtkZ5+AGhxeJ3 I0Ew3OJMFpVDBjbVoOfXh+ekyx3clOTabvxfn7H3+97yzxAf/WUVb2alVHmnedkKYJI8 T5caOtJzGmf4hwOtTVioaD9meC3fQV1PV4eQjBhm7GdrZqHg4KxMpjNJkE1Zang89/ec RqDA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@lwn.net header.s=20201203 header.b=k0xDbu41; spf=softfail (google.com: domain of transitioning linux-kernel-owner@vger.kernel.org does not designate 23.128.96.19 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from lindbergh.monkeyblade.net (lindbergh.monkeyblade.net. [23.128.96.19]) by mx.google.com with ESMTPS id h12-20020a170902f54c00b00153b2d1643asi16972534plf.66.2022.03.28.15.49.11 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 28 Mar 2022 15:49:12 -0700 (PDT) Received-SPF: softfail (google.com: domain of transitioning linux-kernel-owner@vger.kernel.org does not designate 23.128.96.19 as permitted sender) client-ip=23.128.96.19; Authentication-Results: mx.google.com; dkim=pass header.i=@lwn.net header.s=20201203 header.b=k0xDbu41; spf=softfail (google.com: domain of transitioning linux-kernel-owner@vger.kernel.org does not designate 23.128.96.19 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by lindbergh.monkeyblade.net (Postfix) with ESMTP id BEE402467DB; Mon, 28 Mar 2022 14:53:33 -0700 (PDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S243780AbiC1UEe (ORCPT + 99 others); Mon, 28 Mar 2022 16:04:34 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39508 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234908AbiC1UEd (ORCPT ); Mon, 28 Mar 2022 16:04:33 -0400 Received: from ms.lwn.net (ms.lwn.net [IPv6:2600:3c01:e000:3a1::42]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id A27D83BA5E; Mon, 28 Mar 2022 13:02:52 -0700 (PDT) Received: from localhost (unknown [IPv6:2601:281:8300:35::5f6]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 47C3E37A; Mon, 28 Mar 2022 20:02:52 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net 47C3E37A DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1648497772; bh=PwIBFic52cB+8cV6Ms4Smf/K/c9Y0vVMor8KDA0YN2c=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=k0xDbu41Pd0W0r93jSo7/AJ7ki4ya8GQbyZgUmEkPeyKGxfaG9oZGu3jCV2gnVR5k WEPyPkuKiwawV2DwNKfy4R79Ba/VXT/lpm5iWEJj0fJsmM7huBYJlDkByq7pZLFXO8 l5qLkfHUQlIuFeFSg+9JD9rNTzIZMMlRd2qhsjkawHcLnwev4QnmRzIWSWekooKQgJ YitPxnxFVB8hjUUp6Fbq3U3pdQw+YuPyohNG3gavAnOnTn6WfQ1dpQFbUgKFMjIJbY 9oOKg7aIK+SzBfORYABsnkVU0ahODzR8+UP+/73O8gr8FcR8WXYrOQ/v7FgSDpqXNx /0DSV5XcbxGZQ== From: Jonathan Corbet To: David Gow , Brendan Higgins Cc: David Gow , 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 Subject: Re: [PATCH] Documentation: kunit: Fix cross-referencing warnings In-Reply-To: <20220326054414.637293-1-davidgow@google.com> References: <20220326054414.637293-1-davidgow@google.com> Date: Mon, 28 Mar 2022 14:02:51 -0600 Message-ID: <87r16l7slw.fsf@meer.lwn.net> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Status: No, score=-2.0 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RDNS_NONE,SPF_HELO_NONE,T_SCC_BODY_TEXT_LINE 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 David Gow writes: > 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 > --- > Documentation/dev-tools/kunit/architecture.rst | 13 ++----------- > 1 file changed, 2 insertions(+), 11 deletions(-) Applied, thanks. jon