Received: by 2002:a05:6a10:6744:0:0:0:0 with SMTP id w4csp901292pxu; Fri, 23 Oct 2020 16:47:41 -0700 (PDT) X-Google-Smtp-Source: ABdhPJz42EPULUKPNneYO0wahJTLw3GXhrgqyu/xmbKC/n6V4FgeTfoY2qavfRXSFF9NKgAM/O6/ X-Received: by 2002:a05:6402:3064:: with SMTP id bs4mr4751404edb.140.1603496861048; Fri, 23 Oct 2020 16:47:41 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1603496861; cv=none; d=google.com; s=arc-20160816; b=Vob1N6qPv57IcfIlSsTZzegkufAU9mfPPGfuBNFIgW0KU6tA79yy5ju/vfmXNhCPGA IlUo+aVgK0M7IOvZ/7BY3Ne0BxET213UOtPeXiYbOEWqp68TH2KGN3ZsAADR6Vqv+9eP qaqNCQon0n84su27VJDOcltGgH6FGCouJxvY/R9GdnnNRAeETqrOowlf5UxKpjin9O3n eVUKpBcXbRaI/m1+iBxB52GU6VPLdUjXPIjwQUR/eYzM+n1mhbLxaEJTZsLl20vHNKqA wc8oq7j00vdN4HHPNmNsLx6Qit4MPFOBHrp0YYEo7sYJXykbF5n14920p6gO/3zmykM7 /FnQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :organization:references:in-reply-to:message-id:subject:cc:to:from :date; bh=LeU3uPLwXYlAE7KMuwWljy5Geqjq7wGGV7DyhJsr0qA=; b=fTBaiB9O0NGtUQXtmL/HqOdNM3lpJ/MXO+vbRjj2ETlutYZWIum4a4hbtIMNv8d4wp OhAu6HTtUl9ucHdirUc162N2/2eSjXRGPazIsoZzU/4iBodM0L7UgeY8lZDEQ+XjtR36 JCXOTHW3+rxuRFDxSoytjQOZ5mOZdOzQV+ybLbNPuAkxygXZ4UjpGRidPl0vMpZ128DG RkRUaYoHzDIEhaKnfpsL5XlkVdl2gr7WSPIL6uMbICPr1kgU9Pcl9o9veenMHJyJLRud dVxJmH9IWhb3GWyUwapwFtShOr4HDgSBkEPzeAM0ocXa31adBK3L/isplqG3/hjQ43AW 1D0Q== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id bm17si1910216edb.140.2020.10.23.16.47.19; Fri, 23 Oct 2020 16:47:41 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754942AbgJWTsB (ORCPT + 99 others); Fri, 23 Oct 2020 15:48:01 -0400 Received: from ms.lwn.net ([45.79.88.28]:51894 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754840AbgJWTsB (ORCPT ); Fri, 23 Oct 2020 15:48:01 -0400 Received: from lwn.net (localhost [127.0.0.1]) (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 996EA7DE; Fri, 23 Oct 2020 19:47:59 +0000 (UTC) Date: Fri, 23 Oct 2020 13:47:57 -0600 From: Jonathan Corbet To: Peter Zijlstra Cc: Kees Cook , Mauro Carvalho Chehab , Linux Doc Mailing List , Ard Biesheuvel , Ingo Molnar , Jann Horn , Will Deacon , linux-kernel@vger.kernel.org Subject: Re: [PATCH v3 49/56] refcount.h: fix a kernel-doc markup Message-ID: <20201023134757.628f91b7@lwn.net> In-Reply-To: <20201023193907.GI2974@worktop.programming.kicks-ass.net> References: <202010231039.DE05B63@keescook> <20201023193907.GI2974@worktop.programming.kicks-ass.net> Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, 23 Oct 2020 21:39:07 +0200 Peter Zijlstra wrote: > > > /** > > > - * struct refcount_t - variant of atomic_t specialized for reference counts > > > + * struct refcount_struct - variant of atomic_t specialized for reference counts > > > > Hm, this is a weird one. Yes, it's actually "struct refcount_struct", > > but the usage should be refcount_t (through the typedef). I'm not sure > > what the right way to document this is. > > Yeah, this is wrong. If this is due to a kernel doc warning, the kernel > doc machinery is wrong *again*. ...except that, since refcount_t is a typedef, "struct refcount_t" doesn't actually exist. Whether it works properly after doing s/struct// remains to be seen... jon