Received: by 2002:a05:7412:7c14:b0:fa:6e18:a558 with SMTP id ii20csp327015rdb; Mon, 22 Jan 2024 05:39:09 -0800 (PST) X-Google-Smtp-Source: AGHT+IEWNQ19dws56T2OTUCN8fZ3VQkGFxAtcxUx5B6CU5CFXfZ2ufpjCdVq4nFutuczqodlT+DL X-Received: by 2002:a17:902:ea0d:b0:1d7:4d4f:db25 with SMTP id s13-20020a170902ea0d00b001d74d4fdb25mr2392097plg.131.1705930748706; Mon, 22 Jan 2024 05:39:08 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705930748; cv=pass; d=google.com; s=arc-20160816; b=UuzXxD3x8+0yYj17l19holAPj7vCbET0fN5Thlju9fB/5JLGYCCmEpoSnX6WgMuixv 0BP5AFn/bPHpVYa1IDAY6V1l/5ZF7sf7gu7pi/Le5UIROc+htTYw9k0+ZkzzqCJXwDba 3xPt11EHAifc/Qz4GUZR47H5mKc1PUn9nhNPITIaZkzxytk469VuvpLlHdjby/AGqJ9o +2kc1ZUQADI3K2iQwm/fXfH6tpzphprm34ltbVywDNCka5srgNlJlGFtXk/1qKzFkF9r 60qdZhNyE5SrccPIOzBzXEf0GRpGtK11RxQcl/H4oKTv7Uem3pa7vt80GfQAwNgk4Vo3 ilng== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:references:in-reply-to:message-id :date:subject:cc:to:dkim-signature:dkim-signature:from; bh=GvZno+kHevh2g23gq9x/FGgfnjZz8motFDnpxT/9ixo=; fh=r7vmVhCNp44A4uJBu/eEHnpVgozt215NeQBNYmwXaLY=; b=r3frAE2ELsSibjlCDtHNrUUsXc/YdIRZ+NXQVXMWG+r9DiQHMLZWFp+1b+VKn+ZaR4 N40V8b9EjrPr5eghvBJvnPgM2xQtBvr2fdQn2KW0sLHZ7CeUAiEGA1lz9xEwD+G6xZoA 4nmJiYYMzJvCj8KhtqcIDfcJk40CJ76mXBulA77p6nT7iRUq3CDoLvN02PvBM3f0Aciw gjTlEgUk7+ldr0pY2bc76ccWyIMV1noD3buMq/b5K5HZR28FsmA2BgEzGRNYW3uK+6QF 3nlyDY5/TR/CFbuiPFvPXmy1TGjkkCkEkpkklX+uPwMqCX/mpEXSbJzVC0wCOxyCY3LN T/XQ== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b="PIUvxB/S"; dkim=neutral (no key) header.i=@linutronix.de header.s=2020e header.b=C6DZJtBA; arc=pass (i=1 spf=pass spfdomain=linutronix.de dkim=pass dkdomain=linutronix.de dmarc=pass fromdomain=linutronix.de); spf=pass (google.com: domain of linux-kernel+bounces-33098-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-33098-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=linutronix.de Return-Path: Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id p3-20020a1709026b8300b001d70c1aa4c9si6902029plk.393.2024.01.22.05.39.08 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 22 Jan 2024 05:39:08 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-33098-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=@linutronix.de header.s=2020 header.b="PIUvxB/S"; dkim=neutral (no key) header.i=@linutronix.de header.s=2020e header.b=C6DZJtBA; arc=pass (i=1 spf=pass spfdomain=linutronix.de dkim=pass dkdomain=linutronix.de dmarc=pass fromdomain=linutronix.de); spf=pass (google.com: domain of linux-kernel+bounces-33098-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-33098-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=linutronix.de 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 497DA288778 for ; Mon, 22 Jan 2024 13:29:08 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id A26443D38D; Mon, 22 Jan 2024 13:28:43 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=linutronix.de header.i=@linutronix.de header.b="PIUvxB/S"; dkim=permerror (0-bit key) header.d=linutronix.de header.i=@linutronix.de header.b="C6DZJtBA" Received: from galois.linutronix.de (Galois.linutronix.de [193.142.43.55]) (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 794433D0A4; Mon, 22 Jan 2024 13:28:41 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=193.142.43.55 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705930122; cv=none; b=VyAIKQgMrqvMyUgTLfHd7LUgbhH/jiaG5PaS4Rg6lTT9DMpJ76dZhlSW01eg1e5Yctcf1vw0T4/YKNmgPxz+sgCvqmHLLQhpgyJ4bp/fk29UXJSR8S/rIdiZ2OexnHMvM8bb8gYY3aWs7HZ/YuarE7LL0GsMF/Wv/IQJ1AXFWUY= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705930122; c=relaxed/simple; bh=wp8CIgOze8zh7UuHcI2z6RuWp2qimi//9CWSfp979X4=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=oLhhKe9cUTYo8saZyt6Hodrr409y3KCIWc3EUkDItLO5jzJaAP4vXM4Y+W2Gyvf5C4YiddfLY93XJdTL12DAK4uIuCdYRLzC/JUOhaky3Hw3dlElDmVQXPnKPtS8fyMjb4iCUcX+cOO9QGKYjCTqibBLhoL4Ah9HYvT7uUM8bSg= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linutronix.de; spf=pass smtp.mailfrom=linutronix.de; dkim=pass (2048-bit key) header.d=linutronix.de header.i=@linutronix.de header.b=PIUvxB/S; dkim=permerror (0-bit key) header.d=linutronix.de header.i=@linutronix.de header.b=C6DZJtBA; arc=none smtp.client-ip=193.142.43.55 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linutronix.de Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linutronix.de From: Anna-Maria Behnsen DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020; t=1705930119; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=GvZno+kHevh2g23gq9x/FGgfnjZz8motFDnpxT/9ixo=; b=PIUvxB/SYWMC8waUFFQ7/UC2TVIVHS+BH/I6SQhE+1L70dC+9ZPyKzdZhFTB3x60g7BVCu 1PWjW9qZq7hOmAhcvV9z8N1CvviF0sjarzJAL5i1XiZ16cucMP0CkAqNc+qMg6my4wPxle 4ZixEKLw1ewCs7xsmJ1rKPrDZfpmW7+LAIRQPx2T5HLnD6CyzU2Z87A9uxWSLZCeF5BsYA wjmSyhLW7f/o7RddiCzSwOv8OtWuW7xk78UHg4bqGXlxPsNkItbg2rzpPPaqPLCNxLwO3r 68iF+TRZHPBmfEVSiztgrvnirt+MG+MnyhmYTJDqMH3Qr9sTEqU4mDH3+2NFGA== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020e; t=1705930119; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=GvZno+kHevh2g23gq9x/FGgfnjZz8motFDnpxT/9ixo=; b=C6DZJtBAz6GjBt4Hm9vjPbPUg4cy/VfW0WLxpMGcR+y85IU70jGFMPJmYXYx07ZV2x5jOM Q0oXOLBh739O2ZCQ== To: linux-doc@vger.kernel.org Cc: Jonathan Corbet , Thomas Gleixner , Ingo Molnar , Borislav Petkov , x86@kernel.org, Mike Rapoport , Herbert Xu , "David S. Miller" , Marco Elver , Alexander Potapenko , Shuah Khan , Johannes Berg , 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, Anna-Maria Behnsen Subject: [PATCH 2/2] Documentation: Remove deprecated kernel-doc option 'functions' Date: Mon, 22 Jan 2024 14:28:20 +0100 Message-Id: <20240122132820.46633-3-anna-maria@linutronix.de> In-Reply-To: <20240122132820.46633-1-anna-maria@linutronix.de> References: <20240122132820.46633-1-anna-maria@linutronix.de> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit As there are no more users of deprecated kernel-doc option 'functions', remove the related parts in documentation and scripts. Signed-off-by: Anna-Maria Behnsen --- Documentation/doc-guide/kernel-doc.rst | 3 --- Documentation/sphinx/kerneldoc.py | 5 ----- 2 files changed, 8 deletions(-) diff --git a/Documentation/doc-guide/kernel-doc.rst b/Documentation/doc-guide/kernel-doc.rst index 6ad72ac6861b..74d6408abcd3 100644 --- a/Documentation/doc-guide/kernel-doc.rst +++ b/Documentation/doc-guide/kernel-doc.rst @@ -505,9 +505,6 @@ no-identifiers: *[ function/type ...]* .. kernel-doc:: lib/bitmap.c :no-identifiers: bitmap_parselist -functions: *[ function/type ...]* - This is an alias of the 'identifiers' directive and deprecated. - doc: *title* Include documentation for the ``DOC:`` paragraph identified by *title* in *source*. Spaces are allowed in *title*; do not quote the *title*. The *title* diff --git a/Documentation/sphinx/kerneldoc.py b/Documentation/sphinx/kerneldoc.py index 7acf09963daa..2d57c464c76a 100644 --- a/Documentation/sphinx/kerneldoc.py +++ b/Documentation/sphinx/kerneldoc.py @@ -53,7 +53,6 @@ class KernelDocDirective(Directive): 'internal': directives.unchanged, 'identifiers': directives.unchanged, 'no-identifiers': directives.unchanged, - 'functions': directives.unchanged, } has_content = False @@ -74,10 +73,6 @@ class KernelDocDirective(Directive): tab_width = self.options.get('tab-width', self.state.document.settings.tab_width) - # 'function' is an alias of 'identifiers' - if 'functions' in self.options: - self.options['identifiers'] = self.options.get('functions') - # FIXME: make this nicer and more robust against errors if 'export' in self.options: cmd += ['-export'] -- 2.39.2