Received: by 2002:a05:6358:3188:b0:123:57c1:9b43 with SMTP id q8csp2893093rwd; Mon, 22 May 2023 06:02:38 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ73sJEo6KPpNCYuwd6FlhyBdujN9X+FmC5OIv+lSfy4QAdQ8V57BkaGBX/mHYS2qp+bCi9K X-Received: by 2002:a05:6a00:23d5:b0:646:421f:500b with SMTP id g21-20020a056a0023d500b00646421f500bmr13433507pfc.10.1684760558330; Mon, 22 May 2023 06:02:38 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1684760558; cv=none; d=google.com; s=arc-20160816; b=TExsfHvUi8U1ToTB7vxGMSi9imqOyYubtQKewBSciPjTsQRJAA3Hf8b4xOcX4B9eoj GKXtexIb6QlA4deOFMiA4VmyG0P/QiUuYJhSYHsfwrGIFgcWPRrnQ+EY0vR6/fwXccjg iwMt1wLCPuZIW6uZx28SqUNpVlRITWV+1a047qXooBTX/K+BkeoHHrYKzFppyjLsm09S oPybxM6hmXvVGbvQQ52Rj1P48RQ0or/frJ9ZGS9IMHzY77+doBrH8DhYNIcCFdjlg9tw N6ZDzgLqmdHlDGva1qf+RjVxorBkXev5gVKxxe14FVWtQr8RXbjl/PYxQTDRRu6Xmp+l z3RA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:in-reply-to:content-disposition:mime-version :references:message-id:subject:cc:to:from:date; bh=aWDkiblK+3c+46ayXCz/y5QV8W7Jv1ytPpLWsMzpXwk=; b=qGLhc7HJT9Q99f0M+oU4qiDG9dhDnPNuBVmHVVMrXbD+wNRk3j2tLMeGDN26FXHPg1 nxnzOpWdCR9EfaJjdD0puMIGzY/YIuuAhoGp+FQtiphYJykRl5BeuKN69CDb87hjzsWm 4WoVIB9K6indwl+w72A22Or0676cgleCYdP1zdZUSofwjEsrVXkLXpcwtTO/f6Fr0WIK lQgv0D02sc7F2npC8S1dwjhzyfOpxoIiruuZmCm63nr0XK4Dv0BxQydJ7DdHd4qdzf5k z7WeIopVBt8M+xOIPjwi+2C2KZjdgNIJ+Z3RzynjrjGKKmMoZSKPWxUwoER9nv2vZsU/ 7FXg== ARC-Authentication-Results: i=1; mx.google.com; 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=fail (p=NONE sp=NONE dis=NONE) header.from=arm.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id p67-20020a625b46000000b0064cce871b49si4802770pfb.137.2023.05.22.06.02.23; Mon, 22 May 2023 06:02:38 -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; 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=fail (p=NONE sp=NONE dis=NONE) header.from=arm.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233603AbjEVMif (ORCPT + 99 others); Mon, 22 May 2023 08:38:35 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42258 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230489AbjEVMic (ORCPT ); Mon, 22 May 2023 08:38:32 -0400 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by lindbergh.monkeyblade.net (Postfix) with ESMTP id DC266C5; Mon, 22 May 2023 05:38:03 -0700 (PDT) Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 00FC511FB; Mon, 22 May 2023 05:31:12 -0700 (PDT) Received: from FVFF77S0Q05N (unknown [10.57.25.61]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 2C47A3F59C; Mon, 22 May 2023 05:30:26 -0700 (PDT) Date: Mon, 22 May 2023 13:30:16 +0100 From: Mark Rutland To: "Paul E. McKenney" Cc: Kees Cook , linux-kernel@vger.kernel.org, x86@kernel.org, akiyks@gmail.com, linux-doc@vger.kernel.org, kernel-team@meta.com, Jonathan Corbet , Will Deacon , Peter Zijlstra , Boqun Feng Subject: Re: [PATCH locking/atomic 19/19] docs: Add atomic operations to the driver basic API documentation Message-ID: References: <19135936-06d7-4705-8bc8-bb31c2a478ca@paulmck-laptop> <20230510181717.2200934-19-paulmck@kernel.org> <202305161433.C015F9E@keescook> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Spam-Status: No, score=-4.2 required=5.0 tests=BAYES_00,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: X-Mailing-List: linux-kernel@vger.kernel.org On Wed, May 17, 2023 at 03:10:44AM -0700, Paul E. McKenney wrote: > On Tue, May 16, 2023 at 02:33:29PM -0700, Kees Cook wrote: > > On Wed, May 10, 2023 at 11:17:17AM -0700, Paul E. McKenney wrote: > > > Add the include/linux/atomic/atomic-arch-fallback.h file to the > > > driver-api/basics.rst in order to provide documentation for the Linux > > > kernel's atomic operations. > > > > > > Signed-off-by: Paul E. McKenney > > > > Reviewed-by: Kees Cook > > Thank you, Kees, I will apply on my next rebase. > > Given Mark's ongoing atomics rework, a later version of this patch is > likely to remove ".. kernel-doc:: arch/x86/include/asm/atomic.h" from > that same file. (One of the benefits of Mark's rework is that all the > kernel-doc headers can be in the same file.) FWIW, I retained that in the series I just posted at: https://lore.kernel.org/lkml/20230522122429.1915021-1-mark.rutland@arm.com/ ... which drops ".. kernel-doc:: arch/x86/include/asm/atomic.h" as mentioned above. Please let me know if you'd like that R-b dropped. Thanks, Mark.