From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (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 06B5D3D34AB; Mon, 4 May 2026 20:26:47 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777926408; cv=none; b=dA2SUsV4RA2oqs9lvfFQSmUPqENAYtQlM6qLT+XnQbks8qY4dtot0YGuqqF5WFjm0f4UyZ8LHJP3aqq6w+rT3zj1TMDNY2CFhaLVw8k7iPdjWxjsRc1dvSpSNyyqnAwnMzt0eoPVoOOBnsmHmNire8ITRt07z6MX3KTyizHCEgs= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777926408; c=relaxed/simple; bh=VmFH5tiYZWd8I7xGp2Ix9lfuNXwvMmk6MoNhtVPAo7A=; h=Date:From:To:Cc:Subject:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=b5+kgEek1C4rdBckSY5O8sloVvq+T1Fi3lCK7BG6W+KB39h4mMgFVlalMhOKYBhRXfW9qWBk4bfTtrMFKPd23R7jxar9TuRWBTR+Z6F91WCm/qAPkjtFEO/yLaa9f51l6+0AZkRO2jmBuUyaqJJpWjoRoKdrZDxdmvlbj1UpwbE= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=Xh5qp7Xh; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="Xh5qp7Xh" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 65116C2BCB8; Mon, 4 May 2026 20:26:40 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1777926403; bh=VmFH5tiYZWd8I7xGp2Ix9lfuNXwvMmk6MoNhtVPAo7A=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=Xh5qp7XhOyZj6VGsOizQ3hVHLhoYasE3XpX1L0fuwdAuHy2JceCEtLuuMIEA7YL+Q YDi9QlQ82CJ8iKUR9ddQWMvmVRZ+iXSLkftAqzneKPnzMPtUCnqpzzjNxwCLGjLLzU 6CtHSkEsvBvfPCDfxDPIv9dX1Z6o8x2Z91JIKXXMfa61OYAMVfj3mONYMshJFJ+ni+ QLjCP985pz90FuBpFD9h2Bd/SwkEh/toeY6bHxF84OC0MGTXy5FxOoXAR70qsQm5QE 34chl961rzFUjNA6dLsDz/ixZodP1fWwGAm1lqNBBVSZG58JgeGFdHl8OIcNfaCgMM pQ2m3MOAns7xw== Date: Mon, 4 May 2026 22:26:37 +0200 From: Mauro Carvalho Chehab To: Miguel Ojeda Cc: Jonathan Corbet , Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, rust-for-linux@vger.kernel.org, =?UTF-8?B?QmrDtnJu?= Roy Baron , Alice Ryhl , Andreas Hindborg , Benno Lossin , Boqun Feng , Danilo Krummrich , Gary Guo , Miguel Ojeda , Shuah Khan , Trevor Gross Subject: Re: [PATCH 8/9] docs: maintainers_include: don't ignore invalid profile entries Message-ID: <20260504222637.176edc7c@foz.lan> In-Reply-To: References: X-Mailer: Claws Mail 4.4.0 (GTK 3.24.52; x86_64-redhat-linux-gnu) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable On Mon, 4 May 2026 18:08:06 +0200 Miguel Ojeda wrote: > On Mon, May 4, 2026 at 5:51=E2=80=AFPM Mauro Carvalho Chehab > wrote: > > > > Currently, there is a "P" entry for Rust pin-point that is > > neither a valid ReST file nor an hyperlink. While the real =20 >=20 > I guess you mean pin-init above, i.e. this entry: >=20 > P: rust/pin-init/CONTRIBUTING.md >=20 > It would be nice to clarify it in the commit message that it refers to > a file (which is allowed for `P:` entries according to the docs). It is not written there, but by file, it would actually be expected a file within Documentation in ReST format ;-) > And, yeah, ideally we could make it a hyperlink to the raw file. I'm afraid that this is not possible. Sphinx doesn't allow hyperlinks to point to files outside the documentation root (which is Documentation/ when SPHINXDIRS is not used). IMO the best would be to run: pandoc -i rust/pin-init/CONTRIBUTING.md -t rst -o Documentation/rust/pin-i= nit-profile.rst sed s,rust/pin-init/CONTRIBUTING.md,Documentation/rust/pin-init-profile.rs= t, -i MAINTAINERS This way, it will generate a proper hyperlink. Thanks, Mauro