From nobody Sat Oct 4 14:32:49 2025 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 8CF65288534; Fri, 15 Aug 2025 11:37:26 +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=1755257846; cv=none; b=JtEP3Yk5Uf8ZPam/H6DfHaeS2pX7PXUoZxsMNsI4tNyRFlmkAvS2Byv6YBzf4o6MvBmjtC08Is3tp8aGqYOLP17ZCY+FtgLCZ3gqdTZAVd960nnuryeYe9Dpc1sh8TwnQvM9exfz5dKs1xA7sO2IChC/SrssqEvp8X/n+Ka61Nc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755257846; c=relaxed/simple; bh=7SndwlVAORMkK7k0a/gvSMQNE5mjIwPthu9bKP5Mrso=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=GQ05T8Uo5Fk/nk6OrOIUwLhGXrjUTuHtPBFfTJu0AgfLR7XXFFxpbExD58EYNenGLUCdB+oCxIn9LjWIFVMr8L2zH4d8oCC5wEaw2NGdQUiFXSAtVjDO7UNijcebAzfl+wY7Rns7yuprxgHwtswzz1ixjAja8TILtrjrwox99ks= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=qa0D/W3L; 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="qa0D/W3L" Received: by smtp.kernel.org (Postfix) with ESMTPSA id ED8ECC4CEFA; Fri, 15 Aug 2025 11:37:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755257846; bh=7SndwlVAORMkK7k0a/gvSMQNE5mjIwPthu9bKP5Mrso=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=qa0D/W3L1vVbnx0fuGkz0fymKiaoMUfekX1W72hERS0tb55pFPXjmCJY7tAka/AfZ SwA8G7zrExK9qqmEo10fipDd0VgyCf/XlYBxVApJM5REBBjwP+vMoq8t/MrE8mdqXb okSgBTNAxyxrL7TCeJG1UKeoHD3QE+4+1Vz3XvFIySD4zOKJk8OUgr1SGfIT5cvvna WMVvZG3Q6fbFCgsxcgoArDWV4tLBcJq2f2iDv6NL7v1evH3vNMl5H9a/mZL62q9lJu VG/xhJ+6KS6QKCEmME/X3faial/EeQHhlC3XlAogkNyhiislMYvevoKrlSw1ecf+Hq psZbc9unYaJbg== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1umskN-000000042Sx-44Pn; Fri, 15 Aug 2025 13:37:23 +0200 From: Mauro Carvalho Chehab To: Jonathan Corbet , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org Subject: [PATCH 01/11] docs: Makefile: Fix LaTeX paper size settings Date: Fri, 15 Aug 2025 13:36:17 +0200 Message-ID: <963bf2736855387e092d3e1b455cbe2ec47b61f4.1755256868.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.50.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" According with: https://www.sphinx-doc.org/en/master/latex.html The variable that handles paper size changed during version 1.5, as pointed at: https://www.sphinx-doc.org/en/master/changes/1.5.html Signed-off-by: Mauro Carvalho Chehab Reviewed-by: Akira Yokosawa --- Documentation/Makefile | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/Makefile b/Documentation/Makefile index 820f07e0afe6..2ed334971acd 100644 --- a/Documentation/Makefile +++ b/Documentation/Makefile @@ -60,8 +60,8 @@ ifeq ($(HAVE_LATEXMK),1) endif #HAVE_LATEXMK =20 # Internal variables. -PAPEROPT_a4 =3D -D latex_paper_size=3Da4 -PAPEROPT_letter =3D -D latex_paper_size=3Dletter +PAPEROPT_a4 =3D -D latex_elements.papersize=3Da4paper +PAPEROPT_letter =3D -D latex_elements.papersize=3Dletterpaper ALLSPHINXOPTS =3D -D kerneldoc_srctree=3D$(srctree) -D kerneldoc_bin=3D$= (KERNELDOC) ALLSPHINXOPTS +=3D $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) ifneq ($(wildcard $(srctree)/.config),) --=20 2.50.1 From nobody Sat Oct 4 14:32:49 2025 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 47E3A2877FA; Fri, 15 Aug 2025 11:37:26 +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=1755257846; cv=none; b=pAQ7nBHSO9UXHhEkwb1IbM8oVDcQ8eE8NwKB7Eyc2F/0SHgY2xCBnKzHAoFIx5YDvzWiviCnN6lRP8YNrqCiazX81Bd2MBqN0D8j8uzGvyQ6fmd3DywfiZZjACDb5ObCDzodykVulq/kYxCo+0CwYFcFnGDOZTwl4CI9Bv+BpIM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755257846; c=relaxed/simple; bh=x7MW3bRve0BOOp4971V2uJ3c3u7EbdqpTM9d9SjBZLs=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Mg9eABHvCbD8JOlX8CPNR0wSBvSIruUJY/CtJ3oSiDeJ09PE7fUPxY8FNRUQqmuDUGNAvfoKhJLWBsXalrZax9CFMhWo984X8BrpUjLh0nl2iI2TfgHmWOi5xOwYPAvGgHwRLmjLb7XTYvUBRrbL0+Yym+po3XxkzCk9tnPnWnc= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=m1KeOAvS; 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="m1KeOAvS" Received: by smtp.kernel.org (Postfix) with ESMTPSA id E0606C4CEF5; Fri, 15 Aug 2025 11:37:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755257845; bh=x7MW3bRve0BOOp4971V2uJ3c3u7EbdqpTM9d9SjBZLs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=m1KeOAvS3r3Q4dPyVQdSrawwkVjsICuOoJwjEygIdbsVlELusUsHS1Wf+iQv1Iivb S2ixF27n4WTIrQ+x5EDNinCvEGHYfvzRm3DfQSf4uDsAIgs09RsA1EmG+Pnqi5eoTz 6MsGcjavkZBHL0NjgEk8CQWsVk+qkJx9M3YOVcmhZ6DIg6rbtskdIrUG8OiKuw9m8u Qsu9L2Sr3jQU6cBPpOS6ukauSExINjEMblv1KVxxZgiwmljgMjexEMB3Qep0EeiaAO ANS0Gm8I6ROiwbBQ6ffPllBfzwK/aMUhc+Rb978gi5Cpp/o7dI4uYyxlDZW6YrYog1 dm1lk61LhBFZw== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1umskN-000000042T1-4B7h; Fri, 15 Aug 2025 13:37:24 +0200 From: Mauro Carvalho Chehab To: Jonathan Corbet , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org Subject: [PATCH 02/11] docs: conf.py: better handle latex documents Date: Fri, 15 Aug 2025 13:36:18 +0200 Message-ID: <6856916fe21b4ad31c692517b4a7fcb3bd320935.1755256868.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.50.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" The original logic assumed that app.srcdir is identical to the current working dir. This is the case for a normal build, but, when SPHINXDIRS=3D"some dir" is used, this is not the case anymore. Adjust the logic to fill the LaTeX documents considering app.srcdir, in a way that it will work properly on all cases. Signed-off-by: Mauro Carvalho Chehab Reviewed-by: Akira Yokosawa --- Documentation/conf.py | 54 +++++++++++++++++++++---------------------- 1 file changed, 26 insertions(+), 28 deletions(-) diff --git a/Documentation/conf.py b/Documentation/conf.py index f9828f3862f9..2c1be59fd54b 100644 --- a/Documentation/conf.py +++ b/Documentation/conf.py @@ -51,11 +51,13 @@ else: dyn_exclude_patterns.append("devicetree/bindings/**.yaml") dyn_exclude_patterns.append("core-api/kho/bindings/**.yaml") =20 -# Properly handle include/exclude patterns -# ---------------------------------------- +# Properly handle directory patterns and LaTeX docs +# ------------------------------------------------- =20 -def update_patterns(app, config): +def config_init(app, config): """ + Initialize path-dependent variabled + On Sphinx, all directories are relative to what it is passed as SOURCEDIR parameter for sphinx-build. Due to that, all patterns that have directory names on it need to be dynamically set, after @@ -86,6 +88,25 @@ def update_patterns(app, config): =20 config.exclude_patterns.append(rel_path) =20 + # LaTeX and PDF output require a list of documents with are dependent + # of the app.srcdir. Add them here + + for fn in os.listdir(app.srcdir): + doc =3D os.path.join(fn, "index") + if not os.path.exists(os.path.join(app.srcdir, doc + ".rst")): + continue + + has =3D False + for l in latex_documents: + if l[0] =3D=3D doc: + has =3D True + break + + if not has: + latex_documents.append((doc, fn + ".tex", + "Linux %s Documentation" % fn.capitali= ze(), + "The kernel development community", + "manual")) =20 # helper # ------ @@ -456,32 +477,9 @@ latex_elements["preamble"] +=3D """ \\input{kerneldoc-preamble.sty} """ =20 -# Grouping the document tree into LaTeX files. List of tuples -# (source start file, target name, title, -# author, documentclass [howto, manual, or own class]). -# Sorted in alphabetical order +# This will be filled up by config-inited event latex_documents =3D [] =20 -# Add all other index files from Documentation/ subdirectories -for fn in os.listdir("."): - doc =3D os.path.join(fn, "index") - if os.path.exists(doc + ".rst"): - has =3D False - for l in latex_documents: - if l[0] =3D=3D doc: - has =3D True - break - if not has: - latex_documents.append( - ( - doc, - fn + ".tex", - "Linux %s Documentation" % fn.capitalize(), - "The kernel development community", - "manual", - ) - ) - # The name of an image file (relative to this directory) to place at the t= op of # the title page. # latex_logo =3D None @@ -577,4 +575,4 @@ loadConfig(globals()) def setup(app): """Patterns need to be updated at init time on older Sphinx versions""" =20 - app.connect('config-inited', update_patterns) + app.connect('config-inited', config_init) --=20 2.50.1 From nobody Sat Oct 4 14:32:49 2025 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 47D1B15A87C; Fri, 15 Aug 2025 11:37:26 +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=1755257846; cv=none; b=ZnmS63OIdag6e8qcjBIUVXgRQFAaSBwXcXleK5x9xyhaeTwFLevKBgyegTbqfdISvsD1ITqZCPorVj1Wt8sg/kD9m4nDAopOJnMYGXLNRgsTHILqNEGxA+VraX29H8ovrmVQL6WJY4a8rGQqNk+f6jSql7zeeRXRmY06q2l9EBA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755257846; c=relaxed/simple; bh=zMOHwhAKrRV4C5jWXOxsmB8Ttf0MQwEXFsiqcts/lkQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=mFqxzjg7V7F4+9s+J0RQAr1Ncu+CeqnNNZc2XLeQcolgiZoIjDM3Ggg7GkqWNoQkB8V8kDZL5qURDrXQ59Q+9s+LvkrbNJE+RJ88P+jZBRhkTkE9oOiU7pw+9AWT32H+emZoBDPbkPiaHqu9A54winUuHborGDo/DQUDmOyTP3s= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=HnWaEtuT; 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="HnWaEtuT" Received: by smtp.kernel.org (Postfix) with ESMTPSA id DD536C4CEF0; Fri, 15 Aug 2025 11:37:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755257845; bh=zMOHwhAKrRV4C5jWXOxsmB8Ttf0MQwEXFsiqcts/lkQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=HnWaEtuTsnRFP9auXiYPtn8ty957O3uKjiWJt9xUq6Y1NRspqWzhdRC2T7Pjhb/ga Ruxf6zuONywsxVkGjMMBTYzLylIKS4Ub+GxXixELQBTQUJFe+vvPGynzrLd9D58pYB 77zkd3/FFDloFzYWqF6H/uqv7CmRFZjp7BMM67mdb/XplRr9mQoxvZAbN6KtNTWaI6 e/9xMw1C1g4jTgbVsKooQA3TnqHzg12jLLuE6mP8tBrByd/oOgPaqTMwFrzZY/LZbH U0QPE2uhzM5iOgsi7Fs+Gn+XXnOSqq5uBj4Td2JGDtG4DsCqgwjY8TKp9YMwNl1Y3Z hzf91QH586l8g== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1umskO-000000042T5-05gc; Fri, 15 Aug 2025 13:37:24 +0200 From: Mauro Carvalho Chehab To: Jonathan Corbet , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org Subject: [PATCH 03/11] docs: conf.py: fix doc name with SPHINXDIRS Date: Fri, 15 Aug 2025 13:36:19 +0200 Message-ID: <51360d73e925ddedb39bad2f9a4c184e16261fdf.1755256868.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.50.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" When SPHINXDIRS is used, the current logic produces a wrong list of files, as it will not pick the SPHINXDIRS directory, picking instead their children. Add a rule to detect it and create the PDF doc with the right name. Signed-off-by: Mauro Carvalho Chehab Reviewed-by: Akira Yokosawa --- Documentation/conf.py | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/Documentation/conf.py b/Documentation/conf.py index 2c1be59fd54b..c8401ed75402 100644 --- a/Documentation/conf.py +++ b/Documentation/conf.py @@ -91,6 +91,19 @@ def config_init(app, config): # LaTeX and PDF output require a list of documents with are dependent # of the app.srcdir. Add them here =20 + # When SPHINXDIRS is used, we just need to get index.rst, if it exists + if not os.path.samefile(doctree, app.srcdir): + doc =3D "index" + doc_name =3D os.path.basename(app.srcdir) + if os.path.exists(os.path.join(app.srcdir, doc + ".rst")): + latex_documents.append((doc, doc_name + ".tex", + "Linux %s Documentation" % doc_name.ca= pitalize(), + "The kernel development community", + "manual")) + return + + # When building all docs, or when a main index.rst doesn't exist, seek + # for it on subdirectories for fn in os.listdir(app.srcdir): doc =3D os.path.join(fn, "index") if not os.path.exists(os.path.join(app.srcdir, doc + ".rst")): --=20 2.50.1 From nobody Sat Oct 4 14:32:49 2025 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 74AA72882D9; Fri, 15 Aug 2025 11:37:26 +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=1755257846; cv=none; b=ZMeVLwu5Cveu9BLIUzmmUI2XRoQh4uDH3F4TKqWWLtv0Mjo0t4FviOPRmFilndYWNpiIb4/XIOwgYnjCzuMDzU3dmPB6WEBhz/v5DkQ8Bq5ryh1VXIuKHCEyypA6zBxpa2yESMrUigY8zDRd/yYCHa9PZeoj0fHTKDqzo+e/z1M= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755257846; c=relaxed/simple; bh=DJ6PKIVf54EN0EVhgnkCRmWpgby/c+jMwkXMtSedHKY=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=n+7kYEeCxJXyz6AC0vXdzczO75hTuKgrZ+eR1YIGNON5BIQWTIa12A1LUOYUDsMhqd4ZzSIq3wnjzjYtUHfArUxMHfHKBBCa0OAyqoQLPo5/fSDcVm5ah5ypoJ/VbRznLBPAySZJQpWarjTcZgkTusQlY30+yK8k3BdR6queJ9w= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=oEiNrh4A; 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="oEiNrh4A" Received: by smtp.kernel.org (Postfix) with ESMTPSA id F2ABBC4CEF9; Fri, 15 Aug 2025 11:37:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755257846; bh=DJ6PKIVf54EN0EVhgnkCRmWpgby/c+jMwkXMtSedHKY=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=oEiNrh4ABj+qWKIVW68luFPDGQLHKAgttGTwtsc72LU9xVoOhpAtbHuU9RuXk6pJA qznykEih+00AH4X4jSDJ/9MfjIR+MmD+7ffPJp8Qd4HtJCQZk8r1LEAfA+/qEx7jI1 InDT/4NtgC9GIu4W9QaqCqgvtdOgj2D/hYe7uWRgakn274zS+PaluoMFGi5kQGLrlC B1X/DCNC7G59F9KgNJF+VocT7HEPqC2MaX8Y9ovkeHq9pFQAoFPRhm012zqgfmDHdE SO8hEyoAp9rwh6vU33HRjHStF3CmH3UJJY4xRo3BmyKJ51iWEw4Cl6/VD00Ke17RzV EntO3ofGVxGtw== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1umskO-000000042T9-0CGZ; Fri, 15 Aug 2025 13:37:24 +0200 From: Mauro Carvalho Chehab To: Jonathan Corbet , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org Subject: [PATCH 04/11] docs: conf.py: rename some vars at latex_documents logic Date: Fri, 15 Aug 2025 13:36:20 +0200 Message-ID: <8105a4afe3210cd974a4e0cba9c280226a9aa63e.1755256868.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.50.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" Currently, the logic uses fn and doc vars, but they don't properly describe what such vars do. Make them clearer: - fname: points to the file name to search (index.rst); - doc: contains the name of the LaTeX or PDF doc to be produced. With that, the checks for SPHINXDIRS and for subdirs will be more coherent. Signed-off-by: Mauro Carvalho Chehab Reviewed-by: Akira Yokosawa --- Documentation/conf.py | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/Documentation/conf.py b/Documentation/conf.py index c8401ed75402..6e12c7d8e07e 100644 --- a/Documentation/conf.py +++ b/Documentation/conf.py @@ -93,31 +93,31 @@ def config_init(app, config): =20 # When SPHINXDIRS is used, we just need to get index.rst, if it exists if not os.path.samefile(doctree, app.srcdir): - doc =3D "index" - doc_name =3D os.path.basename(app.srcdir) - if os.path.exists(os.path.join(app.srcdir, doc + ".rst")): - latex_documents.append((doc, doc_name + ".tex", - "Linux %s Documentation" % doc_name.ca= pitalize(), + doc =3D os.path.basename(app.srcdir) + fname =3D "index" + if os.path.exists(os.path.join(app.srcdir, fname + ".rst")): + latex_documents.append((fname, doc + ".tex", + "Linux %s Documentation" % doc.capital= ize(), "The kernel development community", "manual")) return =20 # When building all docs, or when a main index.rst doesn't exist, seek # for it on subdirectories - for fn in os.listdir(app.srcdir): - doc =3D os.path.join(fn, "index") - if not os.path.exists(os.path.join(app.srcdir, doc + ".rst")): + for doc in os.listdir(app.srcdir): + fname =3D os.path.join(doc, "index") + if not os.path.exists(os.path.join(app.srcdir, fname + ".rst")): continue =20 has =3D False for l in latex_documents: - if l[0] =3D=3D doc: + if l[0] =3D=3D fname: has =3D True break =20 if not has: - latex_documents.append((doc, fn + ".tex", - "Linux %s Documentation" % fn.capitali= ze(), + latex_documents.append((fname, doc + ".tex", + "Linux %s Documentation" % doc.capital= ize(), "The kernel development community", "manual")) =20 --=20 2.50.1 From nobody Sat Oct 4 14:32:49 2025 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 47EA62882A1; Fri, 15 Aug 2025 11:37:26 +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=1755257846; cv=none; b=Do9+e1uOF7mlHGrg4wKCnjQ5mHgg7QxM1pjHFMPUg/khfeqfdF4kLkhLQ0J+tBN/A1+JsFhsr3YBnznVrt63tI4d+mmmC3QGdCfDELlWkAvfItg1oSOcO4SS6tcYoGsbxsZJp7uFHAXYPCa5LLmxYRH8NcjjDs2+yucn7jH4PP4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755257846; c=relaxed/simple; bh=PgoMVLECaBOExEXb56ZJhk6niEL59BPqFAalBLW0AT4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=uln0scuNQm6rpHVFWcBlBXvl1PzJG2TZze53uJaCeXH+jkE3iM6rgdxzC6ikVLHtjJ5NHtI6Zv2zE3g6zKzqWgOpBd57Qa2FlnvitVnR33mwCsRL3Z6CiWgYQlRQWSXbMqU27xLeJcuv2l4EQugPpO9yNGdqvNf1qZ229L89cTU= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=iSxNQKfS; 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="iSxNQKfS" Received: by smtp.kernel.org (Postfix) with ESMTPSA id E2B4CC4AF0B; Fri, 15 Aug 2025 11:37:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755257845; bh=PgoMVLECaBOExEXb56ZJhk6niEL59BPqFAalBLW0AT4=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=iSxNQKfSH1Vzj91lLyfJbN5JIeU84GyLRPGigVSEhDoTj4NiUYeWb6NwLHTMJrexe L3xlUj6NgYz9QArzHSlpYLGxKviHiUS1t0Uh31PWH+ppV6wxctF0VSgFRn/WQTW/R3 704OeQ6pmQQ56rZpjvL4mQWtwpdxgb3tTVy+JwbSNE2TW0aQyVInYUETPUM8wML+Ze NtRsbOnj4VGsKLuPCo/3kHejcQFUWp+j5QzWkFj0sZZAAWw51+F5/1Ai15az//XD2h THJt9Qtvbex3KcDv/4NK7HnWQwHT0roc3/wa1VwzCfxpsuS33QOPdaDVbdYNJowxrk g6QDPwKuS30KQ== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1umskO-000000042TD-0J3P; Fri, 15 Aug 2025 13:37:24 +0200 From: Mauro Carvalho Chehab To: Jonathan Corbet , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org Subject: [PATCH 05/11] docs: conf.py: fix some troubles for LaTeX output Date: Fri, 15 Aug 2025 13:36:21 +0200 Message-ID: X-Mailer: git-send-email 2.50.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" While PDF docs work fine on RPM-based distros, it causes conflicts on Debian & friends: Documentation/output/process/latex/process.log: Package: fontenc 2021/04/29 v2.0v Standard LaTeX package LaTeX Font Info: Trying to load font information for T1+lmr on input li= ne 11 6. LaTeX Font Info: No file T1lmr.fd. on input line 116. LaTeX Font Warning: Font shape `T1/lmr/m/n' undefined (Font) using `T1/lmr/m/n' instead on input line 116. ! Corrupted NFSS tables. wrong@fontshape ...message {Corrupted NFSS tables} error@fontshape else let = f... l.116 ...\familydefault\seriesdefault\shapedefault Change some logic inside latex_elements to avoid such issues, following the example from Sphinx documentation: https://www.sphinx-doc.org/en/master/latex.html Signed-off-by: Mauro Carvalho Chehab Reviewed-by: Akira Yokosawa --- Documentation/conf.py | 39 +++++++++++++++++++++++---------------- 1 file changed, 23 insertions(+), 16 deletions(-) diff --git a/Documentation/conf.py b/Documentation/conf.py index 6e12c7d8e07e..712e0a016727 100644 --- a/Documentation/conf.py +++ b/Documentation/conf.py @@ -9,6 +9,8 @@ import os import shutil import sys =20 +from textwrap import dedent + import sphinx =20 # If extensions (or modules to document with autodoc) are in another direc= tory, @@ -454,19 +456,38 @@ htmlhelp_basename =3D "TheLinuxKerneldoc" latex_elements =3D { # The paper size ('letterpaper' or 'a4paper'). "papersize": "a4paper", + "passoptionstopackages": dedent(r""" + \PassOptionsToPackage{svgnames}{xcolor} + % Avoid encoding troubles when creating indexes + \PassOptionsToPackage{xindy}{language=3Denglish,codepage=3Dutf8,no= automatic} + """), # The font size ('10pt', '11pt' or '12pt'). "pointsize": "11pt", + # Needed to generate a .ind file + 'printindex': r'\footnotesize\raggedright\printindex', # Latex figure (float) alignment # 'figure_align': 'htbp', # Don't mangle with UTF-8 chars + "fontenc": "", "inputenc": "", "utf8extra": "", + 'fontpkg': dedent(r''' + \usepackage{fontspec} + \setmainfont{DejaVu Serif} + \setsansfont{DejaVu Sans} + \setmonofont{DejaVu Sans Mono} + \newfontfamily\headingfont{DejaVu Serif} + '''), # Set document margins - "sphinxsetup": """ + "sphinxsetup": dedent(r""" hmargin=3D0.5in, vmargin=3D1in, parsedliteralwraps=3Dtrue, verbatimhintsturnover=3Dfalse, - """, + """), + "preamble": dedent(r""" + % Load kerneldoc specific LaTeX settings + \input{kerneldoc-preamble.sty} + """), # # Some of our authors are fond of deep nesting; tell latex to # cope. @@ -474,22 +495,8 @@ latex_elements =3D { "maxlistdepth": "10", # For CJK One-half spacing, need to be in front of hyperref "extrapackages": r"\usepackage{setspace}", - # Additional stuff for the LaTeX preamble. - "preamble": """ - % Use some font with UTF-8 support with XeLaTeX - \\usepackage{fontspec} - \\setsansfont{DejaVu Sans} - \\setromanfont{DejaVu Serif} - \\setmonofont{DejaVu Sans Mono} - """, } =20 -# Load kerneldoc specific LaTeX settings -latex_elements["preamble"] +=3D """ - % Load kerneldoc specific LaTeX settings - \\input{kerneldoc-preamble.sty} -""" - # This will be filled up by config-inited event latex_documents =3D [] =20 --=20 2.50.1 From nobody Sat Oct 4 14:32:49 2025 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 47DA62877DA; Fri, 15 Aug 2025 11:37:26 +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=1755257846; cv=none; b=lZIxnBcFchywbkFpW4tU9J5FdhssVk9DQpUlJRVL4mtgbGHSAQNcRJAOpEp7Iu/ekFds5ljwx9cYhhJI5NDx8DyQWEf4wWV0HwK4V/tvOAK8dnOBgvFwX8WLjM1QwYJJ1TY5MNqlVw+n52wCJctfEV6eo8vnyYFB5A+IO0iqVj4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755257846; c=relaxed/simple; bh=U/g86Ig1pMFruBqlvyzjZIHjO9UsMDLq3GNFDgoQFww=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=cMG+TBVhOK8OZdjAyAoknQgHQScZ+cyDcV9H4yd7gw1Wf+BV+aKsKvG9rbvbr/wbIusvnu4ZOAphtl8lY8z2vPpc+1QVMFZzq4dAkhIMpyHojz22qzWHka7OS1hzXtFb7dWZcoum/nd3uVNA9qr8hcNaJVqcLE0DV0LamhmcW3w= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=USYkRbnE; 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="USYkRbnE" Received: by smtp.kernel.org (Postfix) with ESMTPSA id E8744C4CEF8; Fri, 15 Aug 2025 11:37:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755257846; bh=U/g86Ig1pMFruBqlvyzjZIHjO9UsMDLq3GNFDgoQFww=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=USYkRbnEwnF4+qENTLbHftnrPtONckoKAuM+TucKwcCuz5bN7omBDrfEGRp65OBcC 4k3sDdAZQraKoYZK79ZqgX+lcSjl0CXwaYkUo9hE/l81D8U8iVlMV8w5cLZdu0Qu2x ukY/+FKMNF66kCL3htCyMnVwkeZ+s/Zh+3IyVY9h7iw9c0B3IE9cc4NX7s1FfX2DRI pldxzF88fiCsWy9D9M0ypnb64DAcv2iZX6kisk6iWGwRGHgcn6wT4adr3WQd0H74rv m6qa5Tl3YNl+w/Oh6vmlSv3EsHDg3sJN/zvFpPl8hiNTsa2siTyUxkRMJasclVI+rM eBNwOude/Ewew== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1umskO-000000042TH-0QUu; Fri, 15 Aug 2025 13:37:24 +0200 From: Mauro Carvalho Chehab To: Jonathan Corbet , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , =?UTF-8?q?Bj=C3=B6rn=20Roy=20Baron?= , "Mauro Carvalho Chehab" , Alex Gaynor , Alice Ryhl , Andreas Hindborg , Benno Lossin , Boqun Feng , Danilo Krummrich , Gary Guo , Miguel Ojeda , Trevor Gross , bpf@vger.kernel.org, linux-kernel@vger.kernel.org, rust-for-linux@vger.kernel.org, Akira Yokosawa Subject: [PATCH 06/11] scripts: sphinx-pre-install: fix PDF build issues on Ubuntu Date: Fri, 15 Aug 2025 13:36:22 +0200 Message-ID: X-Mailer: git-send-email 2.50.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" PDF output with current Debian-based distros require other packages for it to work. The main one is pzdr.tfm. Without that, \sphinxhyphen{} won't work, affecting multiple docs. For CJK, tex-gyre is required. Add the missing packages to the list. After the change, all PDF files build on latest Ubuntu: Ubuntu 25.04: Reported-by: Akira Yokosawa Reviewed-by: Akira Yokosawa ------------- PASSED: OS detection: Ubuntu 25.04 SKIPPED (Sphinx Sphinx 8.1.3): System packages SKIPPED (Sphinx already installed either as venv or as native package):= Sphinx on venv SKIPPED (Sphinx already installed either as venv or as native package):= Sphinx package PASSED: Clean documentation: Build time: 0:00, return code: 0 PASSED: Build HTML documentation: Build time: 3:28, return code: 0 PASSED: Build PDF documentation: Build time: 11:08, return code: 0 PDF docs: --------- PASSED: dev-tools: pdf/dev-tools.pdf PASSED: tools: pdf/tools.pdf PASSED: filesystems: pdf/filesystems.pdf PASSED: w1: pdf/w1.pdf PASSED: maintainer: pdf/maintainer.pdf PASSED: process: pdf/process.pdf PASSED: isdn: pdf/isdn.pdf PASSED: fault-injection: pdf/fault-injection.pdf PASSED: iio: pdf/iio.pdf PASSED: scheduler: pdf/scheduler.pdf PASSED: staging: pdf/staging.pdf PASSED: fpga: pdf/fpga.pdf PASSED: power: pdf/power.pdf PASSED: leds: pdf/leds.pdf PASSED: edac: pdf/edac.pdf PASSED: PCI: pdf/PCI.pdf PASSED: firmware-guide: pdf/firmware-guide.pdf PASSED: cpu-freq: pdf/cpu-freq.pdf PASSED: mhi: pdf/mhi.pdf PASSED: wmi: pdf/wmi.pdf PASSED: timers: pdf/timers.pdf PASSED: accel: pdf/accel.pdf PASSED: hid: pdf/hid.pdf PASSED: userspace-api: pdf/userspace-api.pdf PASSED: spi: pdf/spi.pdf PASSED: networking: pdf/networking.pdf PASSED: virt: pdf/virt.pdf PASSED: nvme: pdf/nvme.pdf PASSED: translations: pdf/translations.pdf PASSED: input: pdf/input.pdf PASSED: tee: pdf/tee.pdf PASSED: doc-guide: pdf/doc-guide.pdf PASSED: cdrom: pdf/cdrom.pdf PASSED: gpu: pdf/gpu.pdf PASSED: i2c: pdf/i2c.pdf PASSED: RCU: pdf/RCU.pdf PASSED: watchdog: pdf/watchdog.pdf PASSED: usb: pdf/usb.pdf PASSED: rust: pdf/rust.pdf PASSED: crypto: pdf/crypto.pdf PASSED: kbuild: pdf/kbuild.pdf PASSED: livepatch: pdf/livepatch.pdf PASSED: mm: pdf/mm.pdf PASSED: locking: pdf/locking.pdf PASSED: infiniband: pdf/infiniband.pdf PASSED: driver-api: pdf/driver-api.pdf PASSED: bpf: pdf/bpf.pdf PASSED: devicetree: pdf/devicetree.pdf PASSED: block: pdf/block.pdf PASSED: target: pdf/target.pdf PASSED: arch: pdf/arch.pdf PASSED: pcmcia: pdf/pcmcia.pdf PASSED: scsi: pdf/scsi.pdf PASSED: netlabel: pdf/netlabel.pdf PASSED: sound: pdf/sound.pdf PASSED: security: pdf/security.pdf PASSED: accounting: pdf/accounting.pdf PASSED: admin-guide: pdf/admin-guide.pdf PASSED: core-api: pdf/core-api.pdf PASSED: fb: pdf/fb.pdf PASSED: peci: pdf/peci.pdf PASSED: trace: pdf/trace.pdf PASSED: misc-devices: pdf/misc-devices.pdf PASSED: kernel-hacking: pdf/kernel-hacking.pdf PASSED: hwmon: pdf/hwmon.pdf Reported-by: Akira Yokosawa Signed-off-by: Mauro Carvalho Chehab --- scripts/sphinx-pre-install | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/scripts/sphinx-pre-install b/scripts/sphinx-pre-install index b8474848df4e..b24a6f91ec0a 100755 --- a/scripts/sphinx-pre-install +++ b/scripts/sphinx-pre-install @@ -764,9 +764,6 @@ class SphinxDependencyChecker(MissingCheckers): =20 if self.pdf: pdf_pkgs =3D { - "texlive-lang-chinese": [ - "/usr/share/texlive/texmf-dist/tex/latex/ctex/ctexhook= .sty", - ], "fonts-dejavu": [ "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf", ], @@ -775,6 +772,15 @@ class SphinxDependencyChecker(MissingCheckers): "/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.tt= c", "/usr/share/fonts/opentype/noto/NotoSerifCJK-Regular.t= tc", ], + "tex-gyre": [ + "/usr/share/texmf/tex/latex/tex-gyre/tgtermes.sty" + ], + "texlive-fonts-recommended": [ + "/usr/share/texlive/texmf-dist/fonts/tfm/adobe/zapfdin= g/pzdr.tfm", + ], + "texlive-lang-chinese": [ + "/usr/share/texlive/texmf-dist/tex/latex/ctex/ctexhook= .sty", + ], } =20 for package, files in pdf_pkgs.items(): --=20 2.50.1 From nobody Sat Oct 4 14:32:49 2025 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 8BED528852D; Fri, 15 Aug 2025 11:37:26 +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=1755257846; cv=none; b=cKv5k4TDb6gPgJe0ca/UU2msDn06cwOc/UrzdCiovuXF+wdOZBFaAJqZgc8m3gY/I1zgtaNiqqTfFyXuE9Vr3n+mGpMfqp9roNhSrUx/KWpgqRsi23ct+lfCRzDk+V+aA+iHqbJIF2IWENjmV8mRsQApDr4CKD09ScNVvb3NQmw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755257846; c=relaxed/simple; bh=41pClSqrGKyS+WUV3sXkeu12bzUgmg2ZeJUiAXxatDs=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=A1O3krRxVIOb1f6sP9tnvsPp146/dvLpvNygOQbww1hG6AMN4HS6qhOlyIIcdMucIiu5yOlYAOHs23itSAb3IpCPRcjA+SclXj3GmhhRKkcZWarWTtDO6U6v/CBcaYYBTD2Usz1cM8xeT6cETBz5B4EkjFLbitFtUIq85qDjffw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=gQ5MDXz2; 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="gQ5MDXz2" Received: by smtp.kernel.org (Postfix) with ESMTPSA id F008DC4AF09; Fri, 15 Aug 2025 11:37:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755257846; bh=41pClSqrGKyS+WUV3sXkeu12bzUgmg2ZeJUiAXxatDs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=gQ5MDXz2tJyeUjch/T6OPRGT4o34nT48A42+kY36KmVHeLiGieCK31KQafsAXm/DD wWHE+zJ/RjPQwg1qzn5HYcrtfRg9LxETAJswKLIf16l2CpjgDgMWzZgAmCtJJOXy0J hY3qX81ARZ1apcHhOj+8co/3kUZEau+UNueZyOa9ltlBrh712aHFyR19aJAAN9EICZ Hm0oX98GXiR7qSG7PCO3DqMvLjZVbAoT/elL00F2AxC5pwbPc/SutnhdlRtok6l2m4 H+k6N3JEt0dlitmv2xitt6abN2RDAsXaTgoexWFTE3DZT+iYB4Iqdaqf7Cq47Stno2 YAdrYgx+Jm7jQ== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1umskO-000000042TL-0XzB; Fri, 15 Aug 2025 13:37:24 +0200 From: Mauro Carvalho Chehab To: Jonathan Corbet , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , =?UTF-8?q?Bj=C3=B6rn=20Roy=20Baron?= , "Mauro Carvalho Chehab" , Alex Gaynor , Alice Ryhl , Andreas Hindborg , Benno Lossin , Boqun Feng , Danilo Krummrich , Gary Guo , Miguel Ojeda , Trevor Gross , bpf@vger.kernel.org, linux-kernel@vger.kernel.org, rust-for-linux@vger.kernel.org Subject: [PATCH 07/11] scripts: sphinx-pre-install: add missing gentoo pdf dependencies Date: Fri, 15 Aug 2025 13:36:23 +0200 Message-ID: <3772eb51d1af3653dcd05b4d31cca8e52bad974b.1755256868.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.50.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" There are two packages that are required to build PDF at gentoo: dev-texlive/texlive-latexextra media-fonts/lm Place latex_dependencies on a list to make it easier to maintain and add the missing ones. With that, most PDF documents now build on Gentoo: Gentoo Base System release 2.17: Reviewed-by: Akira Yokosawa -------------------------------- PASSED: OS detection: Gentoo Base System release 2.17 SKIPPED (Sphinx Sphinx 8.2.3): System packages SKIPPED (Sphinx already installed either as venv or as native package):= Sphinx on venv SKIPPED (Sphinx already installed either as venv or as native package):= Sphinx package PASSED: Clean documentation: Build time: 0:00, return code: 0 PASSED: Build HTML documentation: Build time: 5:28, return code: 0 PARTIAL: Build PDF documentation: Test failed (Build time: 9:19, return= code: 2) PDF docs: --------- PASSED: dev-tools: pdf/dev-tools.pdf PASSED: tools: pdf/tools.pdf PASSED: filesystems: pdf/filesystems.pdf PASSED: w1: pdf/w1.pdf PASSED: maintainer: pdf/maintainer.pdf PASSED: process: pdf/process.pdf PASSED: isdn: pdf/isdn.pdf PASSED: fault-injection: pdf/fault-injection.pdf PASSED: iio: pdf/iio.pdf PASSED: scheduler: pdf/scheduler.pdf PASSED: staging: pdf/staging.pdf PASSED: fpga: pdf/fpga.pdf PASSED: power: pdf/power.pdf PASSED: leds: pdf/leds.pdf PASSED: edac: pdf/edac.pdf PASSED: PCI: pdf/PCI.pdf PASSED: firmware-guide: pdf/firmware-guide.pdf PASSED: cpu-freq: pdf/cpu-freq.pdf PASSED: mhi: pdf/mhi.pdf PASSED: wmi: pdf/wmi.pdf PASSED: timers: pdf/timers.pdf PASSED: accel: pdf/accel.pdf PASSED: hid: pdf/hid.pdf FAILED: userspace-api: Build failed (FAILED) PASSED: spi: pdf/spi.pdf PASSED: networking: pdf/networking.pdf PASSED: virt: pdf/virt.pdf PASSED: nvme: pdf/nvme.pdf FAILED: translations: Build failed (FAILED) PASSED: input: pdf/input.pdf PASSED: tee: pdf/tee.pdf PASSED: doc-guide: pdf/doc-guide.pdf PASSED: cdrom: pdf/cdrom.pdf FAILED: gpu: Build failed (FAILED) FAILED: i2c: Build failed (FAILED) FAILED: RCU: Build failed (FAILED) PASSED: watchdog: pdf/watchdog.pdf PASSED: usb: pdf/usb.pdf PASSED: rust: pdf/rust.pdf PASSED: crypto: pdf/crypto.pdf PASSED: kbuild: pdf/kbuild.pdf PASSED: livepatch: pdf/livepatch.pdf PASSED: mm: pdf/mm.pdf PASSED: locking: pdf/locking.pdf PASSED: infiniband: pdf/infiniband.pdf PASSED: driver-api: pdf/driver-api.pdf PASSED: bpf: pdf/bpf.pdf PASSED: devicetree: pdf/devicetree.pdf PASSED: block: pdf/block.pdf PASSED: target: pdf/target.pdf FAILED: arch: Build failed (FAILED) PASSED: pcmcia: pdf/pcmcia.pdf PASSED: scsi: pdf/scsi.pdf PASSED: netlabel: pdf/netlabel.pdf PASSED: sound: pdf/sound.pdf PASSED: security: pdf/security.pdf PASSED: accounting: pdf/accounting.pdf PASSED: admin-guide: pdf/admin-guide.pdf FAILED: core-api: Build failed (FAILED) PASSED: fb: pdf/fb.pdf PASSED: peci: pdf/peci.pdf PASSED: trace: pdf/trace.pdf PASSED: misc-devices: pdf/misc-devices.pdf PASSED: kernel-hacking: pdf/kernel-hacking.pdf PASSED: hwmon: pdf/hwmon.pdf Signed-off-by: Mauro Carvalho Chehab --- scripts/sphinx-pre-install | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/scripts/sphinx-pre-install b/scripts/sphinx-pre-install index b24a6f91ec0a..f987abfec802 100755 --- a/scripts/sphinx-pre-install +++ b/scripts/sphinx-pre-install @@ -1058,12 +1058,19 @@ class SphinxDependencyChecker(MissingCheckers): """ Provide package installation hints for Gentoo. """ + texlive_deps =3D [ + "dev-texlive/texlive-latexextra", + "dev-texlive/texlive-xetex", + "media-fonts/dejavu", + "media-fonts/lm", + ] + progs =3D { "convert": "media-gfx/imagemagick", "dot": "media-gfx/graphviz", "rsvg-convert": "gnome-base/librsvg", "virtualenv": "dev-python/virtualenv", - "xelatex": "dev-texlive/texlive-xetex media-fonts/dejavu= ", + "xelatex": " ".join(texlive_deps), "yaml": "dev-python/pyyaml", "python-sphinx": "dev-python/sphinx", } --=20 2.50.1 From nobody Sat Oct 4 14:32:49 2025 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 47F352882A6; Fri, 15 Aug 2025 11:37:26 +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=1755257846; cv=none; b=W9xlkK7QVypobNLlIk47M0UQCwrhjtX+k9o5qyaX2gcA7eNfDPG39AkLtWFIPwvcHF4ohaKO5j8k+jqHIeazfIIoHYUv6Mr6tedG0hfrBiOUMlAHNq9mEAUwgUmmxdRwbvOKOJXww9DNtepKSpUfM8HavZuNmduPoC59Yw+jj38= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755257846; c=relaxed/simple; bh=fC/Zs5gmjYzgmfpcSoCA1d9edA3MkAXrkitO6YzqW1c=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=G5sEmWVIUQNmCJTc1TAk72ClIH8RQ5tuEQf2G+3ib7XtOjWz9/xvXpX8nHInVkaxT+wDkzApl535xBZOqPs1eIFWK0Ds8Omk5JmYaiz0gy426PipDkBF8+25PFhPMG5Nfs+TEXuf8x8k0TkFExX4Dvw8DiqXLUE5u1SFe56KFf8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=hzI8qDci; 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="hzI8qDci" Received: by smtp.kernel.org (Postfix) with ESMTPSA id EACC6C4CEF6; Fri, 15 Aug 2025 11:37:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755257846; bh=fC/Zs5gmjYzgmfpcSoCA1d9edA3MkAXrkitO6YzqW1c=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=hzI8qDciN69UTB2znPj5Ito1AtBzw9HaDuTdo0Ji6Tgx6E3zE0caxJbD8exUXHWT/ dzFdXjMcTL5ukEN/KU37QTDXwgJ6WJCOpfRgD+IhXxp18LF7pOeE+VCZYkVgcOsKAM I/b+01mTvP0eaHc1sBU+GII++QGpQFlCS1CTkLtxfp7SRoQ4/J5cpBQJxwKCB2/vRC XjjZW1vr3WOKkto1eGJMJRCVnBOylF9jUynKFIUuSMLkeJk3dz3wfkkSOk91fl9dIt ATHBjg28i0Ub/vz64Mp6JA9Tc2rZMN/oNa37+w+0qm/naC2+bL1z6OpQm7wm0fgPtH 61nfcGdBxUpWw== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1umskO-000000042TP-0et3; Fri, 15 Aug 2025 13:37:24 +0200 From: Mauro Carvalho Chehab To: Jonathan Corbet , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org Subject: [PATCH 08/11] scripts: sphinx-pre-install: fix PDF dependencies for openSuse Date: Fri, 15 Aug 2025 13:36:24 +0200 Message-ID: X-Mailer: git-send-email 2.50.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" The dependencies are outdated: both versions need texlive-dejavu fonts. Also, for PDF generation, python311-Sphinx-latex is required. With that, all PDF files are now tuilt on both: openSUSE Leap 15.6: Reviewed-by: Akira Yokosawa ------------------- PASSED: OS detection: openSUSE Leap 15.6 SKIPPED (Sphinx Sphinx 7.2.6): System packages SKIPPED (Sphinx already installed either as venv or as native package):= Sphinx on venv SKIPPED (Sphinx already installed either as venv or as native package):= Sphinx package PASSED: Clean documentation: Build time: 0:00, return code: 0 PASSED: Build HTML documentation: Build time: 5:29, return code: 0 PASSED: Build PDF documentation: Build time: 13:45, return code: 0 openSUSE Tumbleweed: -------------------- PASSED: OS detection: openSUSE Tumbleweed SKIPPED (Sphinx Sphinx 8.2.3): System packages SKIPPED (Sphinx already installed either as venv or as native package):= Sphinx on venv SKIPPED (Sphinx already installed either as venv or as native package):= Sphinx package PASSED: Clean documentation: Build time: 0:00, return code: 0 PASSED: Build HTML documentation: Build time: 4:33, return code: 0 PASSED: Build PDF documentation: Build time: 13:18, return code: 0 Summary =3D=3D=3D=3D=3D=3D=3D PASSED - openSUSE Leap 15.6 (7 tests) PASSED - openSUSE Tumbleweed (7 tests) Signed-off-by: Mauro Carvalho Chehab --- scripts/sphinx-pre-install | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/scripts/sphinx-pre-install b/scripts/sphinx-pre-install index f987abfec802..86f129c76ecd 100755 --- a/scripts/sphinx-pre-install +++ b/scripts/sphinx-pre-install @@ -901,7 +901,7 @@ class SphinxDependencyChecker(MissingCheckers): "dot": "graphviz", "python-sphinx": "python3-sphinx", "virtualenv": "python3-virtualenv", - "xelatex": "texlive-xetex-bin", + "xelatex": "texlive-xetex-bin texlive-dejavu", "yaml": "python3-pyyaml", } =20 @@ -937,7 +937,7 @@ class SphinxDependencyChecker(MissingCheckers): self.recommend_python =3D True =20 progs.update({ - "python-sphinx": "python311-Sphinx", + "python-sphinx": "python311-Sphinx python311-Sphinx-la= tex", "virtualenv": "python311-virtualenv", "yaml": "python311-PyYAML", }) @@ -945,7 +945,7 @@ class SphinxDependencyChecker(MissingCheckers): # Tumbleweed defaults to Python 3.11 =20 progs.update({ - "python-sphinx": "python313-Sphinx", + "python-sphinx": "python313-Sphinx python313-Sphinx-latex", "virtualenv": "python313-virtualenv", "yaml": "python313-PyYAML", }) --=20 2.50.1 From nobody Sat Oct 4 14:32:49 2025 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 8950D288529; Fri, 15 Aug 2025 11:37:26 +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=1755257846; cv=none; b=jQ2LVRYRPPRclX4Otlnsv+9Y9lN6npZ8LMEFqtXeN+18ntHJM3seJ6d6yT2h2sAaQFfLHjdb8nzYAsWCsiOcWzTZRcMz2wYla4ndDItEHJ98TjocTEr3in70GaWImyDCrGrCWdJy0JTu/AtFotqRR42pLtsAnes7Gh5z11P0KCA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755257846; c=relaxed/simple; bh=DbSg1eVMzWOl8sp3iwWjKfFikdD3ZrhJkW3NI3ZW7Hk=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=kl871T8WOrRiu8mJQfMDCnZkSawl0lch2NoBWGNXe/EjtaS8w2HJGuEl7Laz109fykv3hPnFjFMwC3n88we0uh1jR3Lu0i5ez+n47CdXjRCpotaoeLXf5iul1xeRSLXqBg6oFSO9MX7+usRheHxStCRPQrt0L94SUApQ3re0zoI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=lir05pcN; 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="lir05pcN" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 0D6A3C4CEFF; Fri, 15 Aug 2025 11:37:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755257846; bh=DbSg1eVMzWOl8sp3iwWjKfFikdD3ZrhJkW3NI3ZW7Hk=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=lir05pcNITHZGagABV6/OicIXK6PyLn8cU+Ikx2xcaYgyXGWujmjzHpXwbgjy7CYY nShNUZ34Oxhxwjp1RmfJyl+chUSMirQsb6R+FO9kxD6BVLjK0U53jeFuSJ47Us0Nhw s/jX33AzUcSuEWXfaKsCvO0AAJkFmFd0ZjER6kfEcY7zQAq1ODZbI14aE0QV0zrI5t B4Mqdpu5gyo7wAe4P90PBnW8nQvlI35e+CZhlKL9Ei46ug+RszcCFv3Qrxd2nB1a/r 3D/xRm6CNYUVXIpNwy0c48gmgkgb7yXhrFPHG1vEQc0lizoz6Ae03HeOzYMVsBZcgB aNY1V4EvLqHtQ== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1umskO-000000042TT-0lfq; Fri, 15 Aug 2025 13:37:24 +0200 From: Mauro Carvalho Chehab To: Jonathan Corbet , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org Subject: [PATCH 09/11] scripts: sphinx-pre-install: fix dependencies for OpenMandriva Date: Fri, 15 Aug 2025 13:36:25 +0200 Message-ID: <73a2384db32429ac6640474d63af9a7440c7a211.1755256868.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.50.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" The dependeny list for OpenMandriva is wrong. Update it. Yet, on my tests with OpenMandriva LX 4.3, the texlive packages are broken: xelatex can't build anything there, as it lacks xelatex.sfm. Yet, this could be a problem at the way I created the container. Just in case, add a note about that. Signed-off-by: Mauro Carvalho Chehab Reviewed-by: Akira Yokosawa --- scripts/sphinx-pre-install | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/scripts/sphinx-pre-install b/scripts/sphinx-pre-install index 86f129c76ecd..224db3af17db 100755 --- a/scripts/sphinx-pre-install +++ b/scripts/sphinx-pre-install @@ -984,13 +984,19 @@ class SphinxDependencyChecker(MissingCheckers): if re.search(r"OpenMandriva", self.system_release): packager_cmd =3D "dnf install" noto_sans =3D "noto-sans-cjk-fonts" - tex_pkgs =3D ["texlive-collection-fontsextra"] + tex_pkgs =3D [ + "texlive-collection-basic", + "texlive-collection-langcjk", + "texlive-collection-fontsextra", + "texlive-collection-fontsrecommended" + ] =20 # Tested on OpenMandriva Lx 4.3 progs["convert"] =3D "imagemagick" progs["yaml"] =3D "python-pyyaml" progs["python-virtualenv"] =3D "python-virtualenv" progs["python-sphinx"] =3D "python-sphinx" + progs["xelatex"] =3D "texlive" =20 self.check_program("python-virtualenv", DepManager.PYTHON_MAND= ATORY) =20 @@ -1004,7 +1010,9 @@ class SphinxDependencyChecker(MissingCheckers): =20 if not self.distro_msg: self.distro_msg =3D \ - "Note: for venv, ensurepip could be broken, preventing= its install method." + "Notes:\n"\ + "1. for venv, ensurepip could be broken, preventing it= s install method.\n" \ + "2. at least on OpenMandriva LX 4.3, texlive packages = seem broken" =20 else: packager_cmd =3D "urpmi" --=20 2.50.1 From nobody Sat Oct 4 14:32:49 2025 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 74B5928850C; Fri, 15 Aug 2025 11:37:26 +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=1755257846; cv=none; b=jyDt/TDC0EIF91KcWT7JwdHp/E/kD2jMdOcaOeVDEo+4S/wT1bEkHhcH9U+Cws9EMlDAu+A1nPQ8C5mL/TfQtL2olvO1o7ots8aido0ZDTUWxK16f4SdF8ytZ84Crq3hotcfXfx7vmj2hFtxYsUfpZH3q9ngLTK0dFcHeeSv1lE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755257846; c=relaxed/simple; bh=+/6Ro+Dnlq3YRqR0pERxWJ2pVEtF9E0U8Tw5zszBXiA=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=U6jo03oD2O83igjeBO5VZ6icHA6iulmJE4XlV87OPZZrhgyfWr2ngzP6QT+QdqFiJj/jcuKA+TPvlW3KMbc/ZxUhpTdML0vWphFUwecigg2FOSV4ufhXbj9h++TWfG3iLSdf+LP5jDgu0cb2vAcmTuRIlaLpk1th4JEHknJ2xsY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=FZ/eoI7h; 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="FZ/eoI7h" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 1AF2FC116C6; Fri, 15 Aug 2025 11:37:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755257846; bh=+/6Ro+Dnlq3YRqR0pERxWJ2pVEtF9E0U8Tw5zszBXiA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=FZ/eoI7hgGjAOCA/3mIAwwuH9K9EOlHvwUhndcA3cDo9yKMesrquaJPB6iKLYS8IS D0B/eV+Wgbk996r8FUUaAYpyQafzvqRf2/MRw1j7KJbX9eRI8M0ioSIrK9uXB1XTT8 mmkR6xvkpgM2fdoxhFZfvZVVy/tGYYQJMwFZuqdyWgiy6YmsrqT8ooSdjKKr5Z04CL wonNQmhgc1Q+CJtTCkhvnc/bJhPU0nA+BQuGOOc8VDAhFT/EDIBwqA78xFCQVX8ZMi ixhbAcyG5zTEq5XiscEgV9fQNlIrlr2dXUqxFwGTa2O/Mduu9wnwbN6F47U4HwevyN biK2iIIeD2p4w== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1umskO-000000042TX-0sw8; Fri, 15 Aug 2025 13:37:24 +0200 From: Mauro Carvalho Chehab To: Jonathan Corbet , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , =?UTF-8?q?Bj=C3=B6rn=20Roy=20Baron?= , "Mauro Carvalho Chehab" , Alex Gaynor , Alice Ryhl , Andreas Hindborg , Benno Lossin , Boqun Feng , Danilo Krummrich , Gary Guo , Miguel Ojeda , Trevor Gross , bpf@vger.kernel.org, linux-kernel@vger.kernel.org, rust-for-linux@vger.kernel.org Subject: [PATCH 10/11] scripts: sphinx-pre-install: fix pdf dependencies for Mageia 9 Date: Fri, 15 Aug 2025 13:36:26 +0200 Message-ID: X-Mailer: git-send-email 2.50.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" On Mageia 9, two packages are missing. Add them. With that, all PDF packages now build: Mageia 9: Reviewed-by: Akira Yokosawa --------- PASSED: OS detection: Mageia 9 PASSED: System packages: Packages installed PASSED: Sphinx on venv: Sphinx Sphinx 8.1.3 PASSED: Sphinx package: Sphinx Sphinx 6.1.3 PASSED: Clean documentation: Build time: 0:00, return code: 0 PASSED: Build HTML documentation: Build time: 5:17, return code: 0 PASSED: Build PDF documentation: Build time: 14:28, return code: 0 PDF docs: --------- PASSED: dev-tools: pdf/dev-tools.pdf PASSED: tools: pdf/tools.pdf PASSED: filesystems: pdf/filesystems.pdf PASSED: w1: pdf/w1.pdf PASSED: maintainer: pdf/maintainer.pdf PASSED: process: pdf/process.pdf PASSED: isdn: pdf/isdn.pdf PASSED: fault-injection: pdf/fault-injection.pdf PASSED: iio: pdf/iio.pdf PASSED: scheduler: pdf/scheduler.pdf PASSED: staging: pdf/staging.pdf PASSED: fpga: pdf/fpga.pdf PASSED: power: pdf/power.pdf PASSED: leds: pdf/leds.pdf PASSED: edac: pdf/edac.pdf PASSED: PCI: pdf/PCI.pdf PASSED: firmware-guide: pdf/firmware-guide.pdf PASSED: cpu-freq: pdf/cpu-freq.pdf PASSED: mhi: pdf/mhi.pdf PASSED: wmi: pdf/wmi.pdf PASSED: timers: pdf/timers.pdf PASSED: accel: pdf/accel.pdf PASSED: hid: pdf/hid.pdf PASSED: userspace-api: pdf/userspace-api.pdf PASSED: spi: pdf/spi.pdf PASSED: networking: pdf/networking.pdf PASSED: virt: pdf/virt.pdf PASSED: nvme: pdf/nvme.pdf PASSED: translations: pdf/translations.pdf PASSED: input: pdf/input.pdf PASSED: tee: pdf/tee.pdf PASSED: doc-guide: pdf/doc-guide.pdf PASSED: cdrom: pdf/cdrom.pdf PASSED: gpu: pdf/gpu.pdf PASSED: i2c: pdf/i2c.pdf PASSED: RCU: pdf/RCU.pdf PASSED: watchdog: pdf/watchdog.pdf PASSED: usb: pdf/usb.pdf PASSED: rust: pdf/rust.pdf PASSED: crypto: pdf/crypto.pdf PASSED: kbuild: pdf/kbuild.pdf PASSED: livepatch: pdf/livepatch.pdf PASSED: mm: pdf/mm.pdf PASSED: locking: pdf/locking.pdf PASSED: infiniband: pdf/infiniband.pdf PASSED: driver-api: pdf/driver-api.pdf PASSED: bpf: pdf/bpf.pdf PASSED: devicetree: pdf/devicetree.pdf PASSED: block: pdf/block.pdf PASSED: target: pdf/target.pdf PASSED: arch: pdf/arch.pdf PASSED: pcmcia: pdf/pcmcia.pdf PASSED: scsi: pdf/scsi.pdf PASSED: netlabel: pdf/netlabel.pdf PASSED: sound: pdf/sound.pdf PASSED: security: pdf/security.pdf PASSED: accounting: pdf/accounting.pdf PASSED: admin-guide: pdf/admin-guide.pdf PASSED: core-api: pdf/core-api.pdf PASSED: fb: pdf/fb.pdf PASSED: peci: pdf/peci.pdf PASSED: trace: pdf/trace.pdf PASSED: misc-devices: pdf/misc-devices.pdf PASSED: kernel-hacking: pdf/kernel-hacking.pdf PASSED: hwmon: pdf/hwmon.pdf Summary =3D=3D=3D=3D=3D=3D=3D PASSED - Mageia 9 (7 tests) Signed-off-by: Mauro Carvalho Chehab --- scripts/sphinx-pre-install | 2 ++ 1 file changed, 2 insertions(+) diff --git a/scripts/sphinx-pre-install b/scripts/sphinx-pre-install index 224db3af17db..758a84ae6347 100755 --- a/scripts/sphinx-pre-install +++ b/scripts/sphinx-pre-install @@ -979,6 +979,8 @@ class SphinxDependencyChecker(MissingCheckers): =20 tex_pkgs =3D [ "texlive-fontsextra", + "texlive-fonts-asian", + "fonts-ttf-dejavu", ] =20 if re.search(r"OpenMandriva", self.system_release): --=20 2.50.1 From nobody Sat Oct 4 14:32:49 2025 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 79F4A28851C; Fri, 15 Aug 2025 11:37:26 +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=1755257846; cv=none; b=iKC5J+k6hScXz0xl27QuhxYJP6g3kkayr7GrVvQ3fb9a6uQyWZLkjGMMnJczUNfTXn5uAZHRX2gq1c8+ybhRO7H+dM37UvsmZ1rbsYvu1n+IP5eHB/r2No/jg2zXeVjeYT9MwS2Fqgkds4EoO/I++gwcJZazw3w+mnCWNGwKCTY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755257846; c=relaxed/simple; bh=FF6CTJItuLQX4L+saUiPgdc0K549DCILUpiRkhl6c30=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=jHa1NBYDj5VeBRoaCU961DUxyPSXjuna6nd+Eg1fYPnEIqGA1oDrJFz/P+KDGk4sTHJpHCP8Y2jmSFH+AzGTrLMfg72DoxnUjWjp5Iz2QnLlPs4ArYZdxk7eD3P5S6LdW52oACn0q0i/H2K3YJJh0hvFYi5p+3eB1z5kXvh1a6E= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=vLOIUVNc; 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="vLOIUVNc" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 16F36C116B1; Fri, 15 Aug 2025 11:37:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755257846; bh=FF6CTJItuLQX4L+saUiPgdc0K549DCILUpiRkhl6c30=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=vLOIUVNcxzibC03/MJr57laqLFHNh4zKfsrDIxXugUTygc+6I2VcnO+yYYaYIdigV BcEusm2FKdC0qRq9zLxzPV11cMpY2wUoBT/5S8Ta/KcxhqaP5ju7hvVp6FyiYv5yUu +VLBXIoD3XY+WMM3ap6bcDAnXUQ3xlHwmH6voojjAx+RDRxmKLLG7xnJWy8f8Qtje/ 3Ro0XSOWzlaOhHJuSc0NAluRaYF0VQP74F3FPR2N4nhGFrSu3vYbWFFoYoGaFKpKSz ZWd6VG93gkAY3uCSwspTvmUi3jbgNxEx8tKv4fTkqNfB1u01jRzKT0pCdSQCiM6+wW 0mAsqyZWSHirg== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1umskO-000000042Tb-10C5; Fri, 15 Aug 2025 13:37:24 +0200 From: Mauro Carvalho Chehab To: Jonathan Corbet , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , =?UTF-8?q?Bj=C3=B6rn=20Roy=20Baron?= , "Mauro Carvalho Chehab" , Alex Gaynor , Alice Ryhl , Andreas Hindborg , Benno Lossin , Boqun Feng , Danilo Krummrich , Gary Guo , Miguel Ojeda , Trevor Gross , bpf@vger.kernel.org, linux-kernel@vger.kernel.org, rust-for-linux@vger.kernel.org Subject: [PATCH 11/11] scripts: sphinx-pre-install: fix PDF dependencies for gentoo Date: Fri, 15 Aug 2025 13:36:27 +0200 Message-ID: X-Mailer: git-send-email 2.50.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" Package fonts are wrong. Fix it. With that, most PDF files now builds. PDF docs: --------- PASSED: dev-tools: pdf/dev-tools.pdf PASSED: tools: pdf/tools.pdf PASSED: filesystems: pdf/filesystems.pdf PASSED: w1: pdf/w1.pdf PASSED: maintainer: pdf/maintainer.pdf PASSED: process: pdf/process.pdf PASSED: isdn: pdf/isdn.pdf PASSED: fault-injection: pdf/fault-injection.pdf PASSED: iio: pdf/iio.pdf PASSED: scheduler: pdf/scheduler.pdf PASSED: staging: pdf/staging.pdf PASSED: fpga: pdf/fpga.pdf PASSED: power: pdf/power.pdf PASSED: leds: pdf/leds.pdf PASSED: edac: pdf/edac.pdf PASSED: PCI: pdf/PCI.pdf PASSED: firmware-guide: pdf/firmware-guide.pdf PASSED: cpu-freq: pdf/cpu-freq.pdf PASSED: mhi: pdf/mhi.pdf PASSED: wmi: pdf/wmi.pdf PASSED: timers: pdf/timers.pdf PASSED: accel: pdf/accel.pdf PASSED: hid: pdf/hid.pdf FAILED: userspace-api: Build failed (FAILED) PASSED: spi: pdf/spi.pdf PASSED: networking: pdf/networking.pdf PASSED: virt: pdf/virt.pdf PASSED: nvme: pdf/nvme.pdf FAILED: translations: Build failed (FAILED) PASSED: input: pdf/input.pdf PASSED: tee: pdf/tee.pdf PASSED: doc-guide: pdf/doc-guide.pdf PASSED: cdrom: pdf/cdrom.pdf FAILED: gpu: Build failed (FAILED) FAILED: i2c: Build failed (FAILED) FAILED: RCU: Build failed (FAILED) PASSED: watchdog: pdf/watchdog.pdf PASSED: usb: pdf/usb.pdf PASSED: rust: pdf/rust.pdf PASSED: crypto: pdf/crypto.pdf PASSED: kbuild: pdf/kbuild.pdf PASSED: livepatch: pdf/livepatch.pdf PASSED: mm: pdf/mm.pdf PASSED: locking: pdf/locking.pdf PASSED: infiniband: pdf/infiniband.pdf PASSED: driver-api: pdf/driver-api.pdf PASSED: bpf: pdf/bpf.pdf PASSED: devicetree: pdf/devicetree.pdf PASSED: block: pdf/block.pdf PASSED: target: pdf/target.pdf FAILED: arch: Build failed (FAILED) PASSED: pcmcia: pdf/pcmcia.pdf PASSED: scsi: pdf/scsi.pdf PASSED: netlabel: pdf/netlabel.pdf PASSED: sound: pdf/sound.pdf PASSED: security: pdf/security.pdf PASSED: accounting: pdf/accounting.pdf PASSED: admin-guide: pdf/admin-guide.pdf FAILED: core-api: Build failed (FAILED) PASSED: fb: pdf/fb.pdf PASSED: peci: pdf/peci.pdf PASSED: trace: pdf/trace.pdf PASSED: misc-devices: pdf/misc-devices.pdf PASSED: kernel-hacking: pdf/kernel-hacking.pdf PASSED: hwmon: pdf/hwmon.pdf Signed-off-by: Mauro Carvalho Chehab Reviewed-by: Akira Yokosawa --- scripts/sphinx-pre-install | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/sphinx-pre-install b/scripts/sphinx-pre-install index 758a84ae6347..c46d7b76f93c 100755 --- a/scripts/sphinx-pre-install +++ b/scripts/sphinx-pre-install @@ -1069,10 +1069,10 @@ class SphinxDependencyChecker(MissingCheckers): Provide package installation hints for Gentoo. """ texlive_deps =3D [ + "dev-texlive/texlive-fontsrecommended", "dev-texlive/texlive-latexextra", "dev-texlive/texlive-xetex", "media-fonts/dejavu", - "media-fonts/lm", ] =20 progs =3D { --=20 2.50.1