Received: by 2002:a05:7412:40d:b0:e2:908c:2ebd with SMTP id 13csp501981rdf; Tue, 21 Nov 2023 08:17:22 -0800 (PST) X-Google-Smtp-Source: AGHT+IF1B+sKpZWpv+mdHhm/uPgBJwclgPOGAGFSxEZ5G0bA8OTQK1jc3NB49OqcYs4ZlrGXmE5/ X-Received: by 2002:a05:6a20:3c8e:b0:187:4e8c:ac5c with SMTP id b14-20020a056a203c8e00b001874e8cac5cmr5070617pzj.1.1700583442137; Tue, 21 Nov 2023 08:17:22 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1700583442; cv=none; d=google.com; s=arc-20160816; b=rnBEBdqwNbGOjbIMg8kJy8ej9ShzH5DDgDxeykj0OeK8SHyG8jYB57EZPg0oO3p31k sHZax+rAw5FOzVCFr8PBSG6C7Bkz2tnngyzzSpoqzxpVmOYnR9pE3pIyyP3ovoyExTGS bm2R/UlZkhnNl/AMY1yOh9drd17nvzE+KLvVDRSoe0l7Z8aWbDZfpXBR4/J3VnIZEayK V2p8QIA+QSGyXjfjtpW9RhXZbz7dZ0GHXbKXXrM+sbVFuq/109nyHZTXKrWEBv9GCHoY p4K7B5C3ADiKJD7HMpnb3IeaOk8k5tYkl7DUwN03z29efWOHpUxrLJBvGcBRQHcwt0ix jcdA== 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 :references:in-reply-to:message-id:subject:cc:to:from:date :dkim-signature; bh=y/EWexlHebwbTg4fVTgZwgvDZVKfmd3tgGvqjhEX1KI=; fh=KehfvaW0+tm9W49uU+q8uGa5QTAxf/qXA4Tp4J6jk/k=; b=hk7ahnwl24q5Q/xdHUJHQzuf5ZDLJFuHsAeaw9kahmY7F1bu1zls64XZeIPhF848O3 J2SiMbfmH7qnyVRGA5XrAbBwd74FAfBrLLIDnhApjNBTwiCZMDIfFp87n79OaVCJRqMn deVY3B9Pw5IhaIlY/61B4351yg1nP0W2/SdRvoK2vShw2+zMFaiH8RDuyN8sdg5Jmsdl EdFCcTnaq17B5s0m7TxFdrIgXr+XC0bIjkS/hZd2d9dtN/GbNJR+cASVVf9v0hYu2pnO YKcyDPo6QGFkomgla6BCXC7OLo8SePXCC04L+N+MPKtQk9GI3s/ToIho61PUZn+PS+wX 2UVg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b="jcPyiw/L"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 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 groat.vger.email (groat.vger.email. [23.128.96.35]) by mx.google.com with ESMTPS id 128-20020a630286000000b005bdfe7528c9si10458510pgc.726.2023.11.21.08.17.21 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 21 Nov 2023 08:17:22 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) client-ip=23.128.96.35; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b="jcPyiw/L"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 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 out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by groat.vger.email (Postfix) with ESMTP id C89B18088A66; Tue, 21 Nov 2023 08:15:42 -0800 (PST) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.11 at groat.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231210AbjKUQP3 (ORCPT + 99 others); Tue, 21 Nov 2023 11:15:29 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:59806 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231551AbjKUQP1 (ORCPT ); Tue, 21 Nov 2023 11:15:27 -0500 Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id EB9A6192 for ; Tue, 21 Nov 2023 08:15:23 -0800 (PST) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 478BBC433BB; Tue, 21 Nov 2023 16:15:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1700583323; bh=GkJN6hJwY0IEsFz7BKwOr5uoLUCm7aY7Ss1OnguqbVM=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=jcPyiw/LekP14xSMdqxxkRSbDt4V0bjZcTxCsAREQbejJEya183Ksc3TWESmWAGYj vIPQkJZA4wJPqoQNsg1p9hiuAHZ+XxV/8ikh8loDBxe92L/qpgtvCUlC6C2xQU0U5p GfeKtpAi30IrHuoC0zIP1+qfeeDAWI044/bQ9EVQyGwKgXwKdWNgt6005pCDtY8uV5 YO7C8THNQYbuKdru1O2GKDCL0c/s9C0qbvT/ty5oHtCfFu/giDax2WMuPeIX+xmLqY 7vwdvkh6uZvCok59a6/EGzZoDp+EEKkGtMVuTyur6ej0fOPJZxSHaPN5AK3kqgpYov JfIaHLTlASZUw== Date: Tue, 21 Nov 2023 08:15:22 -0800 From: Jakub Kicinski To: Breno Leitao Cc: corbet@lwn.net, linux-doc@vger.kernel.org, netdev@vger.kernel.org, linux-kernel@vger.kernel.org, pabeni@redhat.com, edumazet@google.com Subject: Re: [PATCH v3] Documentation: Document each netlink family Message-ID: <20231121081522.6ea6969a@kernel.org> In-Reply-To: <20231121114831.3033560-1-leitao@debian.org> References: <20231121114831.3033560-1-leitao@debian.org> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-1.2 required=5.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS,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 groat.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (groat.vger.email [0.0.0.0]); Tue, 21 Nov 2023 08:15:43 -0800 (PST) On Tue, 21 Nov 2023 03:48:31 -0800 Breno Leitao wrote: > This is a simple script that parses the Netlink YAML spec files > (Documentation/netlink/specs/), and generates RST files to be rendered > in the Network -> Netlink Specification documentation page. > > Create a python script that is invoked during 'make htmldocs', reads the > YAML specs input file and generate the correspondent RST file. > > Create a new Documentation/networking/netlink_spec index page, and > reference each Netlink RST file that was processed above in this main > index.rst file. > > In case of any exception during the parsing, dump the error and skip > the file. > > Do not regenerate the RST files if the input files (YAML) were not > changed in-between invocations. I can confirm that it does what it says and incremental make htmldocs does not take forever. Reviewed-by: Jakub Kicinski Thanks!