From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pj1-f41.google.com (mail-pj1-f41.google.com [209.85.216.41]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id B1D19277011 for ; Tue, 18 Nov 2025 23:23:51 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.41 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763508233; cv=none; b=CjJAXPL3C/49hPOGzFA3Gc7zjSD0AYtS20wSdcl6GIARB/BatKYcnpaQ5Lq5RKV7lZKxE0OzCuiDl0GCBA2H4NJt7K8vaIatabR+fbGJDfQf6TwPMnaLDPhTIqLiKYDQ8kTutYsGML2NsDySdBE+rd5C/A6ss2cHsaC6ZOL97bM= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763508233; c=relaxed/simple; bh=yCG2aQS7HGg9MR9oFyJL261e0/79kqNAoo2GoWTkiZ8=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=AnCWV5WTXSfXK+J1oz4hW/hCnzv5teg6nQAnrOpf9FEFpUoCoav/buvEF9OPepJIwc4lrGXGLWEpWI4QfPueMAewJi92NjY3SsKU9wQ8oCT2k20j9zZ2yFMFm9YzSnDCukdrQokH7c7rXE1xX4isnFcbINP3wmZ8vEUg71yTF9E= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=Z7b9do+J; arc=none smtp.client-ip=209.85.216.41 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="Z7b9do+J" Received: by mail-pj1-f41.google.com with SMTP id 98e67ed59e1d1-3418ac74bffso4371669a91.1 for ; Tue, 18 Nov 2025 15:23:51 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1763508231; x=1764113031; darn=vger.kernel.org; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date:message-id:reply-to; bh=yCG2aQS7HGg9MR9oFyJL261e0/79kqNAoo2GoWTkiZ8=; b=Z7b9do+J8c58flzv8atRoDbAiHX7Cdg0L2Z290OwvFzmRC5L6XmzZ3RdjHB29p/jpQ tGaP1aA5TcbfigElwFGk9rvhlJfHawzYlQC7bLXzGOZiQG8xc3ctWppTOWQTijn8KgLa J4zKTO55SCJ5HnHzFwiPDc9iRWVAbm9CuZfwKnb5Y9L+Upp+rNVH/OILrztQqJ+q/sM2 xcqhDfvhrTGixf7GkR8iVN4Tu8pMQK032yJ23lLcfR7ds9K4pQHU1Sg+r0sdR6DJkUzE 6XnD6kXwotobohxcF1BO0nJiS3GOqCZOU4tsan/ur+s+LCuqIkpi+0iqPchhxD7gPmFw 3xww== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1763508231; x=1764113031; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:date:message-id :x-gm-gg:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=yCG2aQS7HGg9MR9oFyJL261e0/79kqNAoo2GoWTkiZ8=; b=KhKa8tq4IEgo1yU4NkmKmuxyYUoCY+BqWFdGIYFOihDFc0jRb4iQVHkz17Sd5zCs3P DsXXzUPInTiit3LFZ2IWZVridSTdnzRSSOvuMZQpIK3hssx++CHzvGya/88AFsN05bxR Z8hJDf1IKzRNR4nZuANWSB5fgLPVnY+CsKkO6hh2hw67W2n/fKJ+ojvcRAV3Vr0yvO1L u0dawqCpy5rZXVz/0Kalbk+HUzyyvcqmVvSavvazYJJBc3HA2ZocgS8eLemX1OJNCMbu AJvhc/pkAeTr3WZ3QiDR27ddab0zo29W4yE9chQgVLNR9qfNhVWQZ/+PkqJEsOscM42a TPBw== X-Forwarded-Encrypted: i=1; AJvYcCXW9Tvs2O8nI7vCTuBhIJpw/yE4p8z8e0vqBjtRPWfB9uPZ8lVsZjrt3FbFEjyYsQoR5fN4SQL+3rMMDsU=@vger.kernel.org X-Gm-Message-State: AOJu0Yw0eN6IbpHH9NsKlT6RUunAez4wVmObtwmWRpQRBpm1mQR5gMEI 4KJY4Ft7QnKX06/limVVYhEC//q/Dxz4AaMYajaU4htLzh9cTAIHz+4M X-Gm-Gg: ASbGncvXKD2pAEKcONty4njrog7iGMaPcWYFtn3qsdGUZfUo6EOzixG+0chPYAjCyw0 or0NcJMPThOBQIHdAWfXYE3vVYAfhc0jnbd2PYoYbcN6sNaK4AMaHSmMsRKuaKt+DFKmeHh3QGy lYgIU09dacPCUt7TJmesaoZvNBRBhd0AfaygS9bOydIuKZEss9Z/MoPfJH1AUZd3bk1xuVFaPoQ LUEk34TNqgmCOBxm/qvx9gDgYwdGELn9ZP01ui1XDhUQdoPQx8daRsfD574cFHlA0hrnlxE2gs+ ubEEkwelJPbwbFUAM8/7j2HyZQ8BILNxSNE/VTL6zm2AW2lFVmQNrMqFNS5nJHDj6jw8UHS5Hh4 q6yp3XLmCYmEcnRKEu2p9K/pFh4x/ziIUCDdvIHVEQXvJbOsp9zbiynjTMsThpSjPGP7JVLEKoD +DvyByo3iVxCcYJCVPlv0bWsPi4kma6C+NSfI7vA== X-Google-Smtp-Source: AGHT+IFQEOTeK6CTsapHBFegMkdrPGZvr5eeFWcIJ3et1+OnA1zKWKRZ195rBZ9AYwPzKQ9Us7FHIg== X-Received: by 2002:a17:90b:3eca:b0:340:f40c:169c with SMTP id 98e67ed59e1d1-343fa757fe6mr19220321a91.32.1763508230920; Tue, 18 Nov 2025 15:23:50 -0800 (PST) Received: from [192.168.86.23] ([136.25.189.61]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-345bc111e72sm558354a91.15.2025.11.18.15.23.49 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 18 Nov 2025 15:23:50 -0800 (PST) Message-ID: Date: Tue, 18 Nov 2025 17:23:48 -0600 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH 0/1] fix rustdoc build detection To: Miguel Ojeda , Mauro Carvalho Chehab , Carlos Bilbao Cc: Linux Doc Mailing List , Jonathan Corbet , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Miguel Ojeda References: <6sczezthaixabzw5lddhemrx2yivfdf65zfvpew7tpzl3gqire@vjx4rpju5wxc> Content-Language: en-US From: Carlos Bilbao In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Hey there, On 11/17/25 05:22, Miguel Ojeda wrote: > On Mon, Nov 17, 2025 at 11:48 AM Mauro Carvalho Chehab > wrote: >> Sure, Sphinx (including kernel-doc) build and rust doca build are >> independent. Yet, Makefile "htmldocs" target currently does both. >> >> It could make sense to have a separate target if one want to build >> them both, e.g. something like: > My understanding (Cc'ing Carlos) is that the idea was that `htmldocs` > built the Rust docs if possible. Thanks! I'll also take a look at this, although I fear it'll be complicated without a way to reproduce what Mauro experienced. > > I don't mind if that is changed etc., but I think it is important to > keep the `rustdoc` target simple and focused: it is a "basic" > operation (which is also used to lint docs too), and way faster than > building the HTML docs, and it doesn't depend on them. > > Apologies if I put it perhaps a bit too tersely in my previous message > -- everyone contributing to Rust code is supposed to rely on that > target to test their commits, and needing the whole Sphinx setup would > make the target way worse in practice. > > Now, in the future, if we start relying on generating references for > the Rust docs from the C side and things like that (which is my plan, > but it is long term: first item in > https://github.com/Rust-for-Linux/linux/issues/350), we may need to > rethink things a bit (i.e. we may need to run a subset of the kernel > normal docs to build the Rust docs), but even then ideally we should > only introduce the minimal dependency needed. > > I hope that clarifies -- thanks! > > Cheers, > Miguel Thanks, Carlos