Received: by 2002:a05:7412:5112:b0:fa:6e18:a558 with SMTP id fm18csp756761rdb; Tue, 23 Jan 2024 14:11:59 -0800 (PST) X-Google-Smtp-Source: AGHT+IGRLLf9yZvC6w2aU6fjQqea7W2UQ6TrKR6jw9yG2hQpKyp3qC35RUUpY0h/UchyUbOb9Je0 X-Received: by 2002:a17:902:bb01:b0:1d5:f383:cfde with SMTP id im1-20020a170902bb0100b001d5f383cfdemr3307066plb.139.1706047918915; Tue, 23 Jan 2024 14:11:58 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1706047918; cv=pass; d=google.com; s=arc-20160816; b=uGtPvKI0xD9TJAIaGhow94VxUHcT9+bHCXNb7WqeRBDB3+i/6uxaAu13fsSNK8N4bp jmT3PN7pd6tdRuylM097XFZWRirABn2mXOgJduqBYAbHGZVKEiciXGrIcAkZFODnV40D HwXS4FfrOmgtPim4pXR5rZMjYEN1PN6SJfPNybGXP16obQOEDB6Pfcb+N2mJxxz2esvW nrbSNLAcsr+0pwJloyYmDont78H9mFBjM0rc56ghbBJA8scNyzyoZ2bik/L+yHS3+sFh EXmWl9hV3OgANrG76/QzsaHiSwKCVPn/oXd4EVMg4cMCdBE/03tS2hO0GvCDfhSQHEyH Pkqg== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=mime-version:list-unsubscribe:list-subscribe:list-id:precedence :message-id:date:references:in-reply-to:subject:cc:to:from :dkim-signature:dkim-filter; bh=AWWL4iYA+MZqL21ji1WtCk6P5p3u03ID/E92YUVOgO8=; fh=Ek+y9bXHLrV33hjERbNwvsl3P+owGJf4s1ZzIkyWV5M=; b=0ujcehHZmq0lIc5xGqmREQ9kqt3HeX3gbTM3hjrX0wHENpZTBcD+2aDJyExeMfrPVn g7FMO1hG8m8ZC5/K3iPBiX4GBHzCjQjSEvw+fxnCgSVGuATjzSSP6e0nkkX4hQKONeBz tFEEQVij1rWPp/6LSGd0vAmgyt95DlmjtiU/kf7ZuHWo3xOn/kGmbL3lTSF1Rf28hw1H 00NMYdcpyFk9NVcKT2WxVHjIeX6MG3eTj5W/uG23830bVqPI+x6iN6bbqGukdD4RvJyw m7ujb4oYl0c/qF0bSzZF4yNNlXLM5+T6wxPRBx9ti0WI+xqtMJRed3hHwMcqCO5X3Fm4 U/0Q== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@lwn.net header.s=20201203 header.b=EYCKNGPE; arc=pass (i=1 spf=pass spfdomain=lwn.net dkim=pass dkdomain=lwn.net dmarc=pass fromdomain=lwn.net); spf=pass (google.com: domain of linux-kernel+bounces-36110-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-36110-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=lwn.net Return-Path: Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id s20-20020a170902b19400b001d72da064b6si6621827plr.519.2024.01.23.14.11.58 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 23 Jan 2024 14:11:58 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-36110-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) client-ip=2604:1380:45e3:2400::1; Authentication-Results: mx.google.com; dkim=pass header.i=@lwn.net header.s=20201203 header.b=EYCKNGPE; arc=pass (i=1 spf=pass spfdomain=lwn.net dkim=pass dkdomain=lwn.net dmarc=pass fromdomain=lwn.net); spf=pass (google.com: domain of linux-kernel+bounces-36110-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-36110-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=lwn.net Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sv.mirrors.kernel.org (Postfix) with ESMTPS id 79CA628A186 for ; Tue, 23 Jan 2024 22:06:26 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id C14684F890; Tue, 23 Jan 2024 22:05:48 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=lwn.net header.i=@lwn.net header.b="EYCKNGPE" Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 88C0D4F5FD; Tue, 23 Jan 2024 22:05:43 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=45.79.88.28 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706047547; cv=none; b=qghYvUW/709f/nR0IGR5sIg6J4qawHQCXITDEpJu24tlJXDVPuaTHyGxvfPZUMDijcv0QHdtMpVEJv1H962iAOYQnxbKMd+brKoJk8x34iY0AJoGJmDsCyFUbvE/SzVKqCHTCvHKC1INlYvkKUc7J95UPLJy5TcbSwK0gEIBFVE= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706047547; c=relaxed/simple; bh=MntEIl33BbwzmYFNhMkgC2vX3QF+6CNeWuSo21tZvWo=; h=From:To:Cc:Subject:In-Reply-To:References:Date:Message-ID: MIME-Version:Content-Type; b=k/LLWq+WFXxLfT8AmbuKqi3wBkX6IPzvrcHj25ueA+8aWW7sKqPjyWbRnGnS7TXGx9hHq7hnXPNNsPVGzKGTkE0exodgOu4SxeVJtL6UIFr1KqfihzjOapgIho1Xr9Hi1xd1YIyH8MqRDIUb4XoDlN63fqfngxxux4VuZPPPgHQ= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=lwn.net; spf=pass smtp.mailfrom=lwn.net; dkim=pass (2048-bit key) header.d=lwn.net header.i=@lwn.net header.b=EYCKNGPE; arc=none smtp.client-ip=45.79.88.28 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=lwn.net Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=lwn.net Received: from localhost (c-98-53-138-11.hsd1.co.comcast.net [98.53.138.11]) (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 985127ABF; Tue, 23 Jan 2024 22:05:42 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net 985127ABF DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1706047542; bh=AWWL4iYA+MZqL21ji1WtCk6P5p3u03ID/E92YUVOgO8=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=EYCKNGPEAwo/Qk8IwS7+VpYCVc3Hr65d3C0czS27DE4do1pl9IyQYQgQKfI4KUWn2 8Ylazh4Pl4QutIaaKlpZ4DLaa77l3p0akGgJlZxEMVqPqHRe+sHemVyGZD/isxjtyb cfFxNG/+Z7N25TTt+/ZyhXpS9t8pv4o3gEJZWvgHtM3hJOx04cPa5LsY7vtlezH+8/ p2I/WkaIQj3d+RsBf5QO2bVYi7wehzOVlYW5rQN92qe/ilKONZXOpza/NxokpEbc5v +e18niA3NW5a2oS50ib2ogThj7yiO2WqTOARmPDh7E28ecz++NIGGjf0/TPiJ6Mjcr CLiTy1k4sCnYQ== From: Jonathan Corbet To: Johannes Berg , Anna-Maria Behnsen , linux-doc@vger.kernel.org Cc: Thomas Gleixner , Ingo Molnar , Borislav Petkov , x86@kernel.org, Mike Rapoport , Herbert Xu , "David S. Miller" , Marco Elver , Alexander Potapenko , Shuah Khan , Moritz Fischer , Wu Hao , Xu Yilun , Dipen Patel , Philipp Zabel , Heikki Krogerus , David Airlie , Daniel Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Jiri Kosina , Benjamin Tissoires , linux-kernel@vger.kernel.org Subject: Re: [PATCH 0/2] kernel-doc: Remove deprecated kernel-doc option 'functions' In-Reply-To: References: <20240122132820.46633-1-anna-maria@linutronix.de> Date: Tue, 23 Jan 2024 15:05:41 -0700 Message-ID: <87y1cfiu2y.fsf@meer.lwn.net> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain Johannes Berg writes: > On Mon, 2024-01-22 at 14:28 +0100, Anna-Maria Behnsen wrote: > >> the kernel-doc option 'functions' is marked deprecated and is simply an >> alias for 'identifiers' > > Is it actually a good idea though that it's deprecated and an alias? > > I mean, we have a problem today that sphinx/kernel-doc/whatever cannot > deal with having both > > - struct cfg80211_rx_assoc_resp > - cfg80211_rx_assoc_resp() > > I think at some point I found there's some kind of ticket open against > that, and while I don't hope it will be fixed soon (and we renamed that > struct because of it), maybe doing these changes will make it harder to > eventually deal with such a thing? So I feel like I'm missing something; the problem with Sphinx and namespacing is separate from whether kernel-doc recognizes "-functions"; I don't think that taking out this support will make the other problem any harder to solve. Do you see something I'm not? Thanks, jon