From patchwork Mon Jan 22 13:28:18 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anna-Maria Behnsen X-Patchwork-Id: 19259 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2bc4:b0:101:a8e8:374 with SMTP id hx4csp2568425dyb; Mon, 22 Jan 2024 05:29:18 -0800 (PST) X-Google-Smtp-Source: AGHT+IHewPQOJNoOmqSlfTmMs/fDWLfxtGNykXseeC1FMjr4nnZkmI+e/GnBKoa0qOr7sXIZsvWt X-Received: by 2002:a05:6122:912:b0:4b7:e5c2:73db with SMTP id j18-20020a056122091200b004b7e5c273dbmr1297492vka.4.1705930157800; Mon, 22 Jan 2024 05:29:17 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705930157; cv=pass; d=google.com; s=arc-20160816; b=LaRtzgKhEROxU25vk4l53p3BKB231BG3gCyNGO1w+NzDDnjU4w9YdGZ9X1en/W31dh 5G4zou4Re8vb0QUFHK6VIKCozSaiSGzwZFnouxiXMtL8uX5e3R4UwMynX0X8I8i8EOrz sWYag2pBQ3V1c8z2cK/wgRGF7uafgFqd7cY9dM/EPM6SIy7bg1C/2X0Q/1EQRrtDy20x SV8qFyZBKV5MxzzLe00x5ciCXpRSLdtC5DheywyFlhAgAJi5yic4x0DJYDpplgRfTs2d Ir6i06TtBAhPj4Sk5lqZxQvEi3oOZbi7CkVujRjid9Tl0HNwhpJNy5AlzuM+v5ez9uT+ CjYg== 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:message-id:date:subject:cc:to :dkim-signature:dkim-signature:from; bh=uKZCnmT0rQ7xvCextkDvrtIUvMCCC3PPe7T7/Wyualk=; fh=r7vmVhCNp44A4uJBu/eEHnpVgozt215NeQBNYmwXaLY=; b=yJyrsq6fVjMMjXhKgeTMl5wRBpeguwTZzvf/qiNKNNIdxSpG1+ATyO60cqjQXHtiRL YwslrGb2MQVokTL7GL8dKOFkA+Mky4RdGk90v2km/6EAXB1vSNv9ALtO1H71MyJfrkNC mQVSx/Fa5vkodkf5Rp7QziWYUK/BZ3LdcfBcIJBEgv35qY03SjgDJ6SUaB4Yjj1s5s+k bkLllnO9/uIjoTJdwwu6yUzSH19VX4a28KQttcf8Sxob/fRM4Jcs/qAYIoEuUtB43Dxv 4Z22Tf67s9ttDOVJ316klNSOQMalffkAUcgSm/oUJX0bWlNcbljMaYM2YASoiD/PIOnr OklA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b=Raor0MWw; dkim=neutral (no key) header.i=@linutronix.de header.s=2020e; 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-33097-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-33097-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=linutronix.de Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [147.75.199.223]) by mx.google.com with ESMTPS id p7-20020a0cf547000000b0068170e72546si5437800qvm.159.2024.01.22.05.29.17 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 22 Jan 2024 05:29:17 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-33097-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223; Authentication-Results: mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b=Raor0MWw; dkim=neutral (no key) header.i=@linutronix.de header.s=2020e; 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-33097-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-33097-ouuuleilei=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 ny.mirrors.kernel.org (Postfix) with ESMTPS id 872A21C22974 for ; Mon, 22 Jan 2024 13:29:17 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id B940F3D3B3; Mon, 22 Jan 2024 13:28:44 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=linutronix.de header.i=@linutronix.de header.b="Raor0MWw"; dkim=permerror (0-bit key) header.d=linutronix.de header.i=@linutronix.de header.b="q8TzPILh" 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 3FB2B3CF57; Mon, 22 Jan 2024 13:28:39 +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=1705930121; cv=none; b=AGGR+Ht7cYlfLO9x3BzCuBlsdQiP5ncEhgJ1Y22Ix3pY9If8qpuas7YtwuxAo18IZ9KMNbaVrzd7fE0EDhOKijF977h++l65LkQ85udttMAtxy7s9x4QeRakFe6xLR7dJyZ39HnGbQ7bA0Uj2aV3ZdLX2W/fykC2pv5Zi8gyyrE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705930121; c=relaxed/simple; bh=KD9CzXDI3FSpEchHjIpMd6dRa37p1zEkYPrCD6KgGOk=; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version; b=rEStQrC7Z9rI1bVD4KcwBx/D3Ibru33gkzdWDs3L4UmVZByBsgjpTiS0Fpvm3Et4RXh0JHry/bODDcFm0ISxot0Wdp4hELpY+VnJ4VGVf/NBorohoSL1+Ibp2CEPUrQgB9OGRnU26kr+GxJBstUIflIxeSAHvZK+l6OfqkvpNbk= 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=Raor0MWw; dkim=permerror (0-bit key) header.d=linutronix.de header.i=@linutronix.de header.b=q8TzPILh; 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=1705930118; 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; bh=uKZCnmT0rQ7xvCextkDvrtIUvMCCC3PPe7T7/Wyualk=; b=Raor0MWwk1oF1SxQ7Ze8VNww2sdo/sPpop0PCrLNm2ls02Ioq0GJW6O+i/E1B+Zqwp0IIL O5BJPhKiCyfmXIrWDnAYqCiVypvpei5kMDFuEP4EB5odb3IoiWv6o+h5kKGxjllOdwGs1j 4pyM764bjLDuC1+LaLcr0pQlsxxU3rS3WSUi9JYjQfeLXmOkafzXh1gL9WU1J6rtPiJkss Mm+jcCtBP3vtS6UOOBQv0WHV+JMQRi0xCEiduOWw7nkyrxqlVYHkpr99iAKAGRVU7TlgHp WplPkTMYrUz3dSt3wA/wQVWhLV4OsGJaob2LsvTUG8PjlSmHeQWmAK7bMrlLVw== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020e; t=1705930118; 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; bh=uKZCnmT0rQ7xvCextkDvrtIUvMCCC3PPe7T7/Wyualk=; b=q8TzPILh4eJvE7QAeIHvk96RAVdnuUUBDtMZ11+lHqDQxwHvsd24EbagSL8sK2DZ8tPQUr vczrSi1+FGylKKCg== 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 0/2] kernel-doc: Remove deprecated kernel-doc option 'functions' Date: Mon, 22 Jan 2024 14:28:18 +0100 Message-Id: <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 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1788797421181531086 X-GMAIL-MSGID: 1788797421181531086 Hi, the kernel-doc option 'functions' is marked deprecated and is simply an alias for 'identifiers' and the conversion didn't looked that bad. So the first patch replaces all existing users of 'functions' and the second removes all parts in documentation and also inside the scripts. Thanks, Anna-Maria Anna-Maria Behnsen (2): Documentation: Replace deprecated 'functions' by 'identifiers' Documentation: Remove deprecated kernel-doc option 'functions' Documentation/PCI/pci.rst | 4 +- Documentation/arch/x86/sgx.rst | 16 ++--- Documentation/core-api/boot-time-mm.rst | 2 +- Documentation/core-api/debug-objects.rst | 14 ++-- Documentation/core-api/genalloc.rst | 34 +++++----- Documentation/core-api/generic-radix-tree.rst | 2 +- .../core-api/gfp_mask-from-fs-io.rst | 4 +- Documentation/core-api/idr.rst | 4 +- Documentation/core-api/kernel-api.rst | 12 ++-- Documentation/core-api/mm-api.rst | 6 +- Documentation/core-api/printk-basics.rst | 4 +- Documentation/crypto/api-aead.rst | 6 +- Documentation/crypto/api-akcipher.rst | 6 +- Documentation/crypto/api-digest.rst | 8 +-- Documentation/crypto/api-kpp.rst | 10 +-- Documentation/crypto/api-rng.rst | 4 +- Documentation/crypto/api-skcipher.rst | 8 +-- Documentation/dev-tools/kcsan.rst | 6 +- Documentation/dev-tools/kfence.rst | 10 +-- Documentation/dev-tools/kselftest.rst | 16 ++--- Documentation/doc-guide/kernel-doc.rst | 3 - Documentation/driver-api/80211/cfg80211.rst | 16 ++--- .../driver-api/80211/mac80211-advanced.rst | 26 ++++---- Documentation/driver-api/80211/mac80211.rst | 12 ++-- Documentation/driver-api/device_link.rst | 2 +- .../firmware/fallback-mechanisms.rst | 4 +- .../driver-api/firmware/other_interfaces.rst | 10 +-- .../driver-api/firmware/request_firmware.rst | 14 ++-- Documentation/driver-api/fpga/fpga-bridge.rst | 8 +-- Documentation/driver-api/fpga/fpga-mgr.rst | 18 +++--- .../driver-api/fpga/fpga-programming.rst | 8 +-- Documentation/driver-api/fpga/fpga-region.rst | 22 +++---- Documentation/driver-api/hte/hte.rst | 4 +- Documentation/driver-api/i2c.rst | 2 +- Documentation/driver-api/infiniband.rst | 16 ++--- Documentation/driver-api/mei/hdcp.rst | 2 +- Documentation/driver-api/reset.rst | 34 +++++----- Documentation/driver-api/spi.rst | 2 +- Documentation/driver-api/usb/typec.rst | 26 ++++---- Documentation/driver-api/usb/typec_bus.rst | 10 +-- .../gpu/amdgpu/display/display-manager.rst | 10 +-- Documentation/gpu/drm-kms-helpers.rst | 10 +-- Documentation/gpu/i915.rst | 64 +++++++++---------- Documentation/gpu/rfc/i915_scheduler.rst | 2 +- Documentation/gpu/rfc/i915_small_bar.rst | 4 +- Documentation/gpu/vga-switcheroo.rst | 14 ++-- Documentation/hid/hid-bpf.rst | 6 +- Documentation/mm/ksm.rst | 2 +- Documentation/security/tpm/tpm_vtpm_proxy.rst | 2 +- Documentation/sphinx/kerneldoc.py | 5 -- 50 files changed, 263 insertions(+), 271 deletions(-) Acked-by: Jiri Kosina