From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 84A77FF885E for ; Mon, 27 Apr 2026 13:00:31 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:Message-ID:Date:Subject:Cc :To:From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References: List-Owner; bh=cP5hc5zURXWAoNWCxau9W1R5tC2NAabEFaVIeCWAgb8=; b=b+M7xyfOfJ0fm4 7M9n9n2JfnGWzBTV0cGd39hFnExhfoAwds81KSx1AXR2O2uBDFFVKHfdAFGk8sC0ReIN4B46dATN9 SV2g/InLBLrq6PARduYpAWZLiCtnXfwEBiVwjIXAhysa21AFMEcf8lDOJD4o4hZoxb1jfMMvzBt2q AuCPgZUo3Yum2d/vJH+vAZ2QQhd5xAryRPC9SjFvQqJ2VEqhRrSgsCmFOCurrlRseBvDapZPgR1wb FdKu+icFlNPcYIwKxCaG9OS9bAKYC/FlSs8GRgtIcuVl7mnSUlGAbK1zOF0IX+Vp9YNANBYlvWpFz 2SaKqHFsHbrHfl18oKQw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.98.2 #2 (Red Hat Linux)) id 1wHLZU-0000000GwqW-37dW; Mon, 27 Apr 2026 13:00:20 +0000 Received: from tor.source.kernel.org ([2600:3c04:e001:324:0:1991:8:25]) by bombadil.infradead.org with esmtps (Exim 4.98.2 #2 (Red Hat Linux)) id 1wHLZS-0000000GwoM-3Llf for linux-riscv@lists.infradead.org; Mon, 27 Apr 2026 13:00:18 +0000 Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by tor.source.kernel.org (Postfix) with ESMTP id C8D166014C; Mon, 27 Apr 2026 13:00:17 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 7A1DBC19425; Mon, 27 Apr 2026 13:00:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1777294817; bh=8uNsWXd48y2d3zF795/5fA+wmbyhrDh/2zHCjgxewvY=; h=From:To:Cc:Subject:Date:From; b=hPrHVwDJukihnGevCo0iVj0JaS3sD9EvuDLl1hdSM6qbgE4D56wpvoQvuxJqkxNVc F1eXyCU19gvUk3NxbtxwUfFATvdVwyy1Pn+dxqUwcFgv3vgd5cfH2CbkgmuiaTDI+Q 6j7U91ZnlRrcAY+gTx3HGcb4T8+r3j6ZIWK7Ry8fIkpjI2deFJZAGzzaeyv7BGfAGb 9cjVwx7IC456XXau2Vi3WCyhoinAMsxENU18UFX38aovgzsgazmkftmN8coEz3sd+p Zw9f8Bd3JIN+8mHUMysmFcKhv60vLpQzfgIpaudNOYsnpBtz9Owx1QODga3CtGpo1q oV3GgpB0rQezA== Received: from mchehab by mail.kernel.org with local (Exim 4.99.1) (envelope-from ) id 1wHLZP-0000000Bx1A-1wNM; Mon, 27 Apr 2026 15:00:15 +0200 From: Mauro Carvalho Chehab To: Albert Ou , Jonathan Corbet , Mauro Carvalho Chehab , Palmer Dabbelt , Paul Walmsley Cc: Mauro Carvalho Chehab , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-riscv@lists.infradead.org, workflows@vger.kernel.org, Alexandre Ghiti , Shuah Khan , Randy Dunlap , Dan Williams Subject: [PATCH v3 00/12] Auto-generate maintainer profile entries Date: Mon, 27 Apr 2026 15:00:00 +0200 Message-ID: X-Mailer: git-send-email 2.53.0 MIME-Version: 1.0 X-BeenThere: linux-riscv@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-riscv" Errors-To: linux-riscv-bounces+linux-riscv=archiver.kernel.org@lists.infradead.org Hi Jon, This is basically the same patch series I sent during the merge window, rebased on the top of post 7.1-rc1 docs-next branch. It is tested both with and without O=DOCS. It contains just one extra trivial patch adding a missing SPDX header. This patch series change the way maintainer entry profile links are added to the documentation. Instead of having an entry for each of them at an ReST file, get them from MAINTAINERS content. That should likely make easier to maintain, as there will be a single point to place all such profiles. The output is a per-subsystem sorted (*) series of links shown as a list like this: - Arm And Arm64 Soc Sub-Architectures (Common Parts) - Arm/Samsung S3C, S5P And Exynos Arm Architectures - Arm/Tesla Fsd Soc Support ... - Xfs Filesystem Please notice that the series is doing one logical change per patch. I could have merged some changes altogether, but I opted doing it in small steps to help reviews. If you prefer, feel free to merge maintainers_include changes on merge. There is one interesting side effect of this series: there is no need to add rst files containing profiles inside a TOC tree: Just creating the file anywhere inside Documentation and adding a P entry is enough. Adding them to a TOC won't hurt. Reported-by: Randy Dunlap Suggested-by: Dan Williams Closes: https://lore.kernel.org/linux-doc/69dd6299440be_147c801005b@djbw-dev.notmuch/ (*) At the end, I opted to use sorted(), just to ensure it, even knowing that MAINTAINER entries are supposed to be sorted, as the cost of sorting ~20 already-sorted entries is negligible. --- v3: - Added SPDX entry to process/maintainers.rst file; - rebased after 7.1-rc1 release. v2: - I placed the to MAINTAINERS changes at the beginning. - fix a bug when O=DOCS is used; - proper handle glob "P" entries (just in case, no profiles use it ATM); - when SPHINXDIRS=process, instead of producing warnings, point to entries at https://docs.kernel.org; - MAINTAINERS parsing now happens just once; - The output won't be numered for entries inside numered TOC trees; - TOC tree is now hidden; - instead of display a TOC tree, it shows a list of profiles, ordered and named after file system name taken from MAINTAINERS file; - At the output list, both https and file profiles are shown the same way. Mauro Carvalho Chehab (12): MAINTAINERS: add an entry for media maintainers profile MAINTAINERS: add maintainer-tip.rst to X86 docs: maintainers: add SPDX license to the file docs: maintainers_include: auto-generate maintainer profile TOC docs: auto-generate maintainer entry profile links docs: maintainers_include: use a better title for profiles docs: maintainers_include: add external profile URLs docs: maintainers_include: preserve names for files under process/ docs: maintainers_include: Only show main entry for profiles docs: maintainers_include: improve its output docs: maintainers_include: fix support for O=dir docs: maintainers_include: parse MAINTAINERS just once .../maintainer/maintainer-entry-profile.rst | 24 +-- .../process/maintainer-handbooks.rst | 17 +- Documentation/process/maintainers.rst | 2 + Documentation/sphinx/maintainers_include.py | 161 +++++++++++++++--- MAINTAINERS | 2 + 5 files changed, 152 insertions(+), 54 deletions(-) -- 2.53.0 _______________________________________________ linux-riscv mailing list linux-riscv@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-riscv