Received: by 2002:a05:6a10:2726:0:0:0:0 with SMTP id ib38csp2120985pxb; Fri, 25 Mar 2022 11:27:07 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyDvd3sTJ7d6TIFymwrDSrGHd78uNyK44T5t9gcRtQq0p9pqVnNXIj2z5XDOvxTKj2SJRFf X-Received: by 2002:a05:6a00:890:b0:4f6:686e:a8a9 with SMTP id q16-20020a056a00089000b004f6686ea8a9mr11357712pfj.83.1648232827267; Fri, 25 Mar 2022 11:27:07 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1648232827; cv=none; d=google.com; s=arc-20160816; b=g7o1TxBNlSb0kG6leD2exz5wauZix5S1ABONm6JtPf5xb7ipS+1TQ8pEnCjOnEhfh1 /ioJd5QyjQBzonn+DCOenR7+Na2j7/4x4wmxGwKOd7yDgtm+hsbBi+y9v3tpIyGTtxHs TYUd2xH5WZzk+ifvv0jQZCDL0cC5xzUXsxYmrLPH3A3E+aHhKC2fZy2Bibp3JC7g1vbS puoudXTdE4E/SHUJ02A42Mhk95pQvzUsBHy/165uSXEbwHmg2WW4PJmj7UHOvRLefPoF jF+G++jVRMXqrRvSPBF6NXnV25HPGqSyhpGvAalqZZDnO/QZ8V3VD3ISP4ryABwlPZsd 5X8w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=BDV6EcHrjEBFtxDAkJAKPMvrotef9rgKdXOVKyTxExE=; b=Rdgdk4oAAiZFF45hEWEHkOE5QE7I/iIKtF5JviEOM9WRC+ZRkDh2uKq/5j+9szxT+z 8YHoUvTs4YLKPptAouUjLnGli8iZ2BJEH+iAyG+UPlYxlv8hx8thWFdv2caxrkehMJdm lWi0cG4lFhvFbqAuJplpZm3sYe+N2YXQf2mol15h5PSQRhTGPLzZebSENBA65BWwBHH5 EQTX41Xm1E8mjCtnmSbEholzAONv5jeE5UdLmYmimwULqekTj1zIV8AyjfYrAz10qENv kZWwyO2Cmz9D78/Of8riw9Vx28adAtSl2R7yJ51XN8fwT0rzq5J5NImBRuOXMyywIgj0 iM4Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=ekOFR67P; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from lindbergh.monkeyblade.net (lindbergh.monkeyblade.net. [2620:137:e000::1:18]) by mx.google.com with ESMTPS id d3-20020a170902aa8300b00153b2d164fesi2780178plr.262.2022.03.25.11.27.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 25 Mar 2022 11:27:07 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:18 as permitted sender) client-ip=2620:137:e000::1:18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=ekOFR67P; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by lindbergh.monkeyblade.net (Postfix) with ESMTP id 3C325176D30; Fri, 25 Mar 2022 10:50:08 -0700 (PDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1359275AbiCYOGz (ORCPT + 99 others); Fri, 25 Mar 2022 10:06:55 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50318 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1347601AbiCYOGx (ORCPT ); Fri, 25 Mar 2022 10:06:53 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [IPv6:2604:1380:4641:c500::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 4BFC5D8F48; Fri, 25 Mar 2022 07:05:19 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id DD05461B1C; Fri, 25 Mar 2022 14:05:18 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 38E3AC340F1; Fri, 25 Mar 2022 14:05:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1648217118; bh=pta3b2i458q4DOeFSWpPG82xTqU/eugW9Qk2+QMRASE=; h=From:To:Cc:Subject:Date:From; b=ekOFR67PakEopy/yHzEcEG+xRkdoyZGGm+lpSLTpZDmTOhA95V16uKBqlNvkRCABM lero2MrA6tEwo8AIm+0yJ+QPQFh9KdBhK+5GUQ4+gUNvrw4aHEmFJSFmAYFhKWF0Yz sPj1ixL/QbwdD7bch47OqNsLANqGEMXzmbOks6ngCzmF3FvEZAwOJ6dUtdbALSrV33 S+KXWJ9hZrKnJg5lDayOKc0LutO2ZDLCrqwS5fdFKGkAeutCBqkNXM1Icj7W7bYJqV hzTroxjJUJDfPGR8k25ZCgir9j8c+YxTqBufVfj3IZ4jbPcuYNYELfkhRca5rWUmq/ HJN8YEDvHotWw== Received: from mchehab by mail.kernel.org with local (Exim 4.94.2) (envelope-from ) id 1nXkZ1-00Axyq-Le; Fri, 25 Mar 2022 15:05:15 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List , Jonathan Corbet Cc: Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Hans de Goede , Stephen Rothwell Subject: [PATCH v2 0/4] Better handle dependencies on Sphinx extensions Date: Fri, 25 Mar 2022 15:05:10 +0100 Message-Id: X-Mailer: git-send-email 2.35.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-3.5 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,MAILING_LIST_MULTI, RDNS_NONE,SPF_HELO_NONE,T_SCC_BODY_TEXT_LINE autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Sphinx has its own way to identify the need of rebuilding the documentation. It means that extensions need to use an internal API in order to notify about the need to consider other files. The kerneldoc.py extension already does that, maintainers_include.py doesn't need (as it uses an API that internally does that), and kfigure.py does it on a different way. So, those are already safe. However, other extensions don't notify nor implement their own checks, so, when a file that was parsed by them is changed, the corresponding documentation won't be rebuilt. This series add support for it for ABI, features and kernel-include. Mauro Carvalho Chehab (4): scripts/get_feat.pl: allow output the parsed file names docs: kernel_abi.py: add sphinx build dependencies docs: kernel_feat.py: add build dependencies docs: kernel_include.py: add sphinx build dependencies Documentation/sphinx/kernel_abi.py | 4 ++++ Documentation/sphinx/kernel_feat.py | 20 ++++++++++++++++++-- Documentation/sphinx/kernel_include.py | 3 +++ scripts/get_feat.pl | 11 +++++++++++ 4 files changed, 36 insertions(+), 2 deletions(-) -- 2.35.1