Received: by 2002:a05:6a10:2726:0:0:0:0 with SMTP id ib38csp3165996pxb; Sat, 26 Mar 2022 12:29:29 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzJKQdwlr3QZmy4ZD1rnhlJhLZVyeeuwuEfHyybY8FFcMuMhBU/fdM/Ir7mI7ryLBBhL4D+ X-Received: by 2002:aa7:86c6:0:b0:4fa:46d:6005 with SMTP id h6-20020aa786c6000000b004fa046d6005mr16229946pfo.86.1648322968980; Sat, 26 Mar 2022 12:29:28 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1648322968; cv=none; d=google.com; s=arc-20160816; b=oIvgk5iN8bLs+eXMY55iPsy/LMjCJRKMXlfUdOgmmULKmOMOwToaOoWqJnUUMQjBCi cnT1UsSxgatyPNsQNexw4a/jAbRBzbesY/UjkEeoHfJGVf+ujRN/R8Ux18oEm3fptKVL 58zF5ePNj/N2hBEd5aFE6XmWYGyY/8RB4h4kif2+D1d79Lud/lUcH3eLboprg28Gi/N4 OdW+EFSiTKhLlOim832VYvE2VKSLzYdELDM+rENjwUUl8h0ln1clsGgK4qrboMUkdfXc UriS+inxeHR85Ox7O+hCuCNfazGYfaNYriSLdAUzMvG4jf+u4T0g82HeFiyd9ggQdC2m NmIg== 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=LLEmnI3YBVwHZ3ge4qC/xrtf/4zXKMiCTM4zsOfAfyc=; b=VWzjc9SCDkSvgEoojlgM8bYaHlH9HPC/oq9rH8pazYhUBs4XaRuIMUr55kFN45PO5v lABC0CjYkkgOW4XTnw8CeJT0MysXk1CFvl4o679Z/Qmqb3cCmXpFg4QEcT9Fw1gTZf85 Q5eIDFd2WhYJpTrzCreCzIapuN8KRD46RUO9SPp+fwMljGjE5fqy7G30WnwsoNC6eFoy SjZhq8BoA2ExhKxvOTDgn0h1P+aVKe2jwgOOxoh0Jeab3XzzMa7mm3p9v6H7k+qMg+j5 NPGlG8Pxf2j/k1h7dG2plyRo1zKmfi12ujXi2h/hLE4MJzqsPc6WBF5+zhunUNbbsF9j VTsQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=RTiVsOW4; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 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 out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id z7-20020a170903018700b00153b7d70c76si6832215plg.349.2022.03.26.12.29.15; Sat, 26 Mar 2022 12:29:28 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=RTiVsOW4; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232582AbiCZK3X (ORCPT + 99 others); Sat, 26 Mar 2022 06:29:23 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:54182 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232524AbiCZK3F (ORCPT ); Sat, 26 Mar 2022 06:29:05 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C5F7F2F008; Sat, 26 Mar 2022 03:27:28 -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 3EB6A60B84; Sat, 26 Mar 2022 10:27:28 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 83BAAC340F3; Sat, 26 Mar 2022 10:27:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1648290447; bh=gkLuPChh/62HzYG8JNKGaCyt+9mhI4s5dURFTooh/lk=; h=From:To:Cc:Subject:Date:From; b=RTiVsOW4NGyhKP6jdrcOqAswGCTi0l8FGIBZTPOcnAxcbuLtX0iG/u/dHqPEsmMCg 7w4V0q2kA4zwCT43jwVzBqko0U9mxVQKKBAvmbSjlKSoz9MFNiBnR6h1Q2tT4ew9tQ aPYkbyQsaU6SZUoUKv9ErCRdVeGclQq0/3euHhy7f7EzFY7LynjAYPmutDsNM2Vw48 i9WM2yu4+a0/ST3P64NZOGuhrypwTkZWcD5Kr0L4A2rKSCFPGw1AcUefpR+SJwglHz K1qoiXb3BNsvCfc3plLl8PVEmroHrbZqFnCvZU+Pf1qQ2QFCRH8VCIDR75V+qMh3qf 02bzbtbeFYBzQ== Received: from mchehab by mail.kernel.org with local (Exim 4.94.2) (envelope-from ) id 1nY3dl-00Co0R-0e; Sat, 26 Mar 2022 11:27:25 +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 v3 0/6] Better handle dependencies on Sphinx extensions Date: Sat, 26 Mar 2022 11:27:18 +0100 Message-Id: X-Mailer: git-send-email 2.35.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-7.9 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_HI, SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=ham 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. --- v3: - Changed the meta-tag used when --enable-lineno and --enable-fname are used at the scripts that generate ReST output. Mauro Carvalho Chehab (6): scripts/get_feat.pl: allow output the parsed file names docs: kernel_feat.py: add build dependencies docs: kernel_abi.py: add sphinx build dependencies docs: kernel_include.py: add sphinx build dependencies scripts/get_abi: change the file/line number meta info scripts/kernel-doc: change the line number meta info Documentation/sphinx/kernel_abi.py | 6 +++++- Documentation/sphinx/kernel_feat.py | 20 ++++++++++++++++++-- Documentation/sphinx/kernel_include.py | 3 +++ Documentation/sphinx/kerneldoc.py | 2 +- scripts/get_abi.pl | 4 ++-- scripts/get_feat.pl | 11 +++++++++++ scripts/kernel-doc | 4 ++-- 7 files changed, 42 insertions(+), 8 deletions(-) -- 2.35.1