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 055B42F1FE1; Wed, 3 Sep 2025 10:42:43 +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=1756896164; cv=none; b=r1JH7fOFW5qqt4tFJkoIeKO1LTwYd8YMXaDGk/0IzRXAgV0Al3A8WWoninXlXAKxppo15PtAywpBtqmCbzRFUWh8AohGr8QNGngKWKJ51STsJV4u3SeYZgUm2f4f4iwMttMKgG4/asstp1dbMlFqkNa0hiplwNGPjFEVzv/tD7o= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756896164; c=relaxed/simple; bh=nswBR64ViC/hUPCWHFJwHb30VGxS00bZA6cSKxGjObE=; h=Date:From:To:Cc:Subject:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=KcIBfN7aUQ1YRiOaTHbRIDE0wari3zszd4RGuo5fjAWSSb3qb0CBD/GQIQS5ztkBlxkGd5CJbP0014/teUWswUkPTjIGxv49Iwb5YFa7HG5uddzUWVKScSJ7cZOK1TfWXJ9QctAp+SXqbH9S0eZfZTULa1imCPgsdRJKR4qTxmk= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=mPM3ELMs; 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="mPM3ELMs" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 72382C4CEF0; Wed, 3 Sep 2025 10:42:41 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1756896163; bh=nswBR64ViC/hUPCWHFJwHb30VGxS00bZA6cSKxGjObE=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=mPM3ELMsON/gpoXLTjoBw18ZWNLXtJL15Rcd+I+MzssRclb/U/KNNshXpjBNBBHgI W7LtLDOH9Vr67CnpeyEil9cTMKkJfA4NO6Sq6pUe2NvYDCjJcLW/jvGZF8fQGJ/lBN uqnEDEl3IuK2aVcC2+1y3cI8FZxhrScrOMEUpxHV9lwpuGhTiEEcy2Nqkizton2ROM v0L2WezQ9Y/EXivir7eRZw83yq8K3+tLrT1KNXgpYc+WF08a///6CNiyoGpkvY9Q3m zh6HCDhcksc/o+S60m9jAhtWmpqvBQrO1tkgJpxIEoNoGY19svUpbcvPUH83rx1PDw lp6/hoYwEkrXw== Date: Wed, 3 Sep 2025 12:42:29 +0200 From: Mauro Carvalho Chehab To: Johannes Berg Cc: Jonathan Corbet , Randy Dunlap , Jani Nikula , Laurent Pinchart , Vegard Nossum , ksummit@lists.linux.dev, Linux Documentation , Akira Yokosawa , Bagas Sanjaya , Matthew Wilcox Subject: Re: [TECH TOPIC] Kernel documentation - update and future directions Message-ID: <20250903124229.332dfeae@foz.lan> In-Reply-To: References: <2f927f53-9af5-4e0c-be8f-f7bdf90e23ff@sirena.org.uk> <20250901204635.51b81ffd@foz.lan> <1bf8a898-e697-46e2-86b1-4158b021d652@sirena.org.uk> <865e583b-4c97-4db1-963c-ed8539fa56dc@sirena.org.uk> <20250902135938.35048fbc@foz.lan> <20250902141434.3e5b14e4@foz.lan> <8339a5dd-446d-4717-9d68-983f5e2354b3@sirena.org.uk> <87ecsox4uy.fsf@trenco.lwn.net> <20250902191929.504977bf@foz.lan> <87frd4vfys.fsf@trenco.lwn.net> X-Mailer: Claws Mail 4.3.1 (GTK 3.24.49; x86_64-redhat-linux-gnu) Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Em Wed, 03 Sep 2025 08:29:34 +0200 Johannes Berg escreveu: > On Tue, 2025-09-02 at 12:58 -0600, Jonathan Corbet wrote: > > > > > > The idea is not to override the search path: instead, to use it to > > > check if the user installed other /usr/bin/python3.* files (or on > > > some other part of PATH). Most distributions nowadays come with > > > multiple python versions. I can't see a downside (*) of not using > > > a newer version that the user had installed on his system and > > > has it on PATH. > > > > But overriding the path is exactly what this would be doing. It doesn't > > seem right to say "we know better than you do" and circumvent the > > configured path; the user may well have reasons for setting things up > > the way they did. > > Absolutely! Please don't ever do this. > > For example, use case we have: using nix-shell to lock down the software > used to build, for reproducible builds and similar reasons. Without -- > pure, PATH may still contain (last!) software from the system itself, > but it should basically never be used. if the PATH is mangled, you'll have a lot more problems than just building docs as it will pick wrong exec files anyway. In the particular case of docs, if you have, for instance, two different python versions, one with sphinx and another one without it, it may pick the wrong one, causing the build to fail. There's nothing the build system can do to solve it. The proper fix would be to wrap the calling logic to save the env before running under nix-shell, restoring env afterwards. Thanks, Mauro