Received: by 2002:a25:31c3:0:0:0:0:0 with SMTP id x186csp1443269ybx; Thu, 7 Nov 2019 11:57:38 -0800 (PST) X-Google-Smtp-Source: APXvYqwscA6uAC2nu98iDOrim75/2ojAECVMOZIWeOWfZ8JgBCTpHIyo8s+bguJZ5RAcLH9LDye/ X-Received: by 2002:a50:85cb:: with SMTP id q11mr5595557edh.141.1573156658659; Thu, 07 Nov 2019 11:57:38 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1573156658; cv=none; d=google.com; s=arc-20160816; b=gL6pu1/uwyEz0wn/+H41htElUYze/Yg3y2ZaVLTnILsO+bMY5xW84+pimcrMdCN0Yi O+3cbENLEi4oskpGSQSHKJEp/NlNKYEySwmWnPYZtVp7qbTIZEU8H6Rr1qh4ScnUeK/R OqFuE1Vg8+2nrBpEoqndufBRzv2fmf09DzSaV1QifoMGL09XsisoJ5GjC9reg5A0b/ng 3g55QjtYghieB+3Kl3zbfNZP2C15GiFejOSsQwd0pHnORzY53EgY5q/O3JhuO4OF8hjY CZ5fnhBns3KigeZbu2RiY1LSfJ2TlEiQwOWxntYA88qakh4DCTPkGhcZ/9z4013CcWev IlPA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :organization:references:in-reply-to:message-id:subject:cc:to:from :date; bh=owBpguoZBHbDYf5+Gg7RS5Vy/7ECqPUcP2/FP1s7q54=; b=TXiqNrOGpTX5EdefehT6ToH/Dn2hzvvX/6LQo8A60yVSrcptT8OS9k8kVgVlSk88wN 25/YRuM5EaYeRG4ZFn0FhsOmACxiv2VngjlcRZpBJT/h4sBdTadUveutiu2mcHJzE4Pm dnXp1ZJrEKt9LRwrM/6yBuwG2LsAzlMveV4GL3CcXHZLtF5rDRcfc2SgUg5fk7spCtrQ IVYcYanKE1Po+z1SwanG8sRl5nRtu+8Wmt1H5J+Ms8FpnsFQkRhCTIZewv0D9VnDEGJl j9UMR6GiB0VqRKRGnxk6RB8D4RsGzF9EAJGo6krHQWxHOmYcRG/rMJYUkv0CCxmMOxjb +UlA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id b14si2438214edv.216.2019.11.07.11.57.16; Thu, 07 Nov 2019 11:57:38 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727401AbfKGT4A (ORCPT + 99 others); Thu, 7 Nov 2019 14:56:00 -0500 Received: from ms.lwn.net ([45.79.88.28]:39350 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725844AbfKGTz7 (ORCPT ); Thu, 7 Nov 2019 14:55:59 -0500 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 EA5F62C1; Thu, 7 Nov 2019 19:55:58 +0000 (UTC) Date: Thu, 7 Nov 2019 12:55:57 -0700 From: Jonathan Corbet To: Changbin Du Cc: Jiri Kosina , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH v3] kernel-doc: rename the kernel-doc directive 'functions' to 'identifiers' Message-ID: <20191107125557.0522eb49@lwn.net> In-Reply-To: <20191031135245.7984-1-changbin.du@gmail.com> References: <20191031135245.7984-1-changbin.du@gmail.com> Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Thu, 31 Oct 2019 21:52:45 +0800 Changbin Du wrote: > The 'functions' directive is not only for functions, but also works for > structs/unions. So the name is misleading. This patch renames it to > 'identifiers', which specific the functions/types to be included in > documentation. We keep the old name as an alias of the new one before > all documentation are updated. > > Signed-off-by: Changbin Du > > --- > v2: > o use 'identifiers' as the new directive name. It would have been nice to update that last text for v3 ... but the patch looks better, so I've gone ahead and applied it, thanks. jon