From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtpout-02.galae.net (smtpout-02.galae.net [185.246.84.56]) (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 F34E23043D9 for ; Thu, 28 Aug 2025 16:51:24 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=185.246.84.56 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756399889; cv=none; b=L76KkzcdwOkuleqG+NNs+RkddAKu9nKqWOaFeqGA22wn9QhCW80+fB67NTwqZfH8hxWtB5G8vQQS8BVHp6JchWDF8wFkta1LdZjsSNGQw+DBAHlw+5g05qb9NnytsjURo0B9eDsDtbBxDSGFfhxxqqCr710pkUffCPLaENFMcRg= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756399889; c=relaxed/simple; bh=PVupvUbljqqv0l5EpslMuDT5j7QU3Ufuil+d3qdB5eA=; h=Date:From:To:Cc:Subject:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=DoOEiEFMvl+817GAJLaTtdOQxcz9vdq+9petPiBgrpZmfZ2vmyuD2Xeu+oOZDEZ0mEMB+yolAs3g+Qwf4J6KjXlhhZe+IgsIO8T7HziZBScpqWQdeDLKEEE3dfFpkQw2RI82x+pBYb+txyvapcdiXaf7CjYsqudL1WLBRpmwLJo= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=bootlin.com; spf=pass smtp.mailfrom=bootlin.com; dkim=pass (2048-bit key) header.d=bootlin.com header.i=@bootlin.com header.b=LF+gGwKi; arc=none smtp.client-ip=185.246.84.56 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=bootlin.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=bootlin.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=bootlin.com header.i=@bootlin.com header.b="LF+gGwKi" Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-02.galae.net (Postfix) with ESMTPS id 0EA941A0E42; Thu, 28 Aug 2025 16:51:23 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id BCAB960303; Thu, 28 Aug 2025 16:51:22 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 6EEC81C22DDE9; Thu, 28 Aug 2025 18:50:43 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1756399881; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=01CLvL+opovfhfkSRyspjEXFZkfbj0TTItWEljkWyHE=; b=LF+gGwKiR4u1aF8x9V/r/FYoaEYM5yIMM4utgdSxggzuD4ceJXDH52EapVHz1dRavntVmb Z/4leyNDKQ3csKFk80uvyyd/e5syNpIg1IV1Xyf2kelhcKowKrG3NfsAdB9M+WJVPpnYd+ d85Egg6pS5815TGmco9Nynhhhkjzgm1QF9rqUeHeBm59SlAjT1Fupc4Mnn5VODa3tirg8U n8wDXL4666720TL3hBZMVmYjB9PvgYgev95Id+9yn+IXQE2JDHZq4nbJ8lDujkGkQ/M/oF +wZyBzXCBG/NU6Lt30oQqy+shG9EVxYj5ClTuzgIhroq74/O8htu/GlXU16KSA== Date: Thu, 28 Aug 2025 18:50:37 +0200 From: Kory Maincent To: Mauro Carvalho Chehab Cc: "Message-ID :" , Linux Doc Mailing List , "Akira Yokosawa" , "Breno Leitao" , "David S. Miller" , "Donald Hunter" , "Eric Dumazet" , "Ignacio Encinas Rubio" , "Jakub Kicinski" , "Jan Stancek" , "Jonathan Corbet" , "Marco Elver" , "Paolo Abeni" , "Randy Dunlap" , "Ruben Wauters" , "Shuah Khan" , "Simon Horman" , joel@joelfernandes.org, linux-kernel-mentees@lists.linux.dev, linux-kernel@vger.kernel.org, lkmm@lists.linux.dev, netdev@vger.kernel.org, peterz@infradead.org, stern@rowland.harvard.edu Subject: Re: [PATCH v10 06/14] docs: use parser_yaml extension to handle Netlink specs Message-ID: <20250828185037.07873d04@kmaincent-XPS-13-7390> In-Reply-To: <4c97889f0674b69f584dedc543a879d227ef5de0.1753718185.git.mchehab+huawei@kernel.org> References: <4c97889f0674b69f584dedc543a879d227ef5de0.1753718185.git.mchehab+huawei@kernel.org> Organization: bootlin X-Mailer: Claws Mail 4.2.0 (GTK 3.24.41; x86_64-pc-linux-gnu) Precedence: bulk X-Mailing-List: linux-kernel-mentees@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Last-TLS-Session-Version: TLSv1.3 Le Mon, 28 Jul 2025 18:01:59 +0200, Mauro Carvalho Chehab a =C3=A9crit : > Instead of manually calling ynl_gen_rst.py, use a Sphinx extension. > This way, no .rst files would be written to the Kernel source > directories. >=20 > We are using here a toctree with :glob: property. This way, there > is no need to touch the netlink/specs/index.rst file every time > a new Netlink spec is added/renamed/removed. ... > diff --git a/Documentation/networking/index.rst > b/Documentation/networking/index.rst index ac90b82f3ce9..b7a4969e9bc9 100= 644 > --- a/Documentation/networking/index.rst > +++ b/Documentation/networking/index.rst > @@ -57,7 +57,7 @@ Contents: > filter > generic-hdlc > generic_netlink > - netlink_spec/index > + ../netlink/specs/index Faced a doc build warning that say netlink_spec/index.rst is not used. $ git grep netlink_spec Documentation/networking/mptcp.rst:netlink_spec/mptcp_pm.rst. Documentation/translations/zh_CN/networking/index.rst:* netlink_spec/index I think we can remove the whole directory and change these, right? Also got a doc build warning that says netlink/specs/index is not existing = even if it exists. Maybe a sphinx parsing issue ?! Regards, --=20 K=C3=B6ry Maincent, Bootlin Embedded Linux and kernel engineering https://bootlin.com