From nobody Sat Oct 4 01:39:05 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 B2DEB2EB5C8; Thu, 21 Aug 2025 08:17:04 +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=1755764224; cv=none; b=jY8ss2TDDFLGTuUpHPTknCYKLTX/1o3vHlE6IMDqCX6M3L6lzeVsKphL6AueUpBAF9No04GbVBU5iqtPn3vrj9PfUf9BEzyBTSRYtOIePtRyR+LogEap8UdxMxAj3MZba3l419A5xdYDmIY+y+VuRmpR0px234QUig1n9opAqu4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755764224; c=relaxed/simple; bh=7SndwlVAORMkK7k0a/gvSMQNE5mjIwPthu9bKP5Mrso=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=OWrBpTuJLNi6BwcbWP5Ko5JAUfiw2qgqoVamnCW0hpZ5e+4ah7NA7du9Z2jiZ0L/PmxNosZPQQwqU+qAHMMpGfUU4WN/A14wVSSjnVQfplva4ZSoxmK0+7S6JWqbXrqKLw7FprtsKr2eAhr90xzt3CPERQdxHlRhGSY38WVG2pw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=EzqVNAzw; 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="EzqVNAzw" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 52D82C113CF; Thu, 21 Aug 2025 08:17:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755764224; bh=7SndwlVAORMkK7k0a/gvSMQNE5mjIwPthu9bKP5Mrso=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=EzqVNAzwy+aRE154ZUX8u8PjCB5ANN18wqn882Mpa6XV1eBH6oGh6BB84VjXpdrT8 6gYGbF+n4voI0e0h9eEyG7SY9k+ARMYjHSyNUc8HkKdfy8/UcKJl6mYU3m/uSVQ0i4 0SX691xRuM0rW4EhzkDQweywtn5SN3gsMqhYrtbMiKTonz/t5zyTrRPhbxBj2ounVm BVsVLSVVbh6fZdByK4YqN7MWX6Hd3WDDcKuCeyCtqAE7Q1TMDtKLvBNL2cwTaNX8Na sZIU6h/AN/fI/OK/g9Jmb+8bS2SUpL9L9ur4aooWLxVQGIFWNG2/UZrnlJ+eRqGP1S NLQz2S1K9EM5A== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1up0Tm-0000000BLg5-2Pub; Thu, 21 Aug 2025 10:17:02 +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 v2 01/14] docs: Makefile: Fix LaTeX paper size settings Date: Thu, 21 Aug 2025 10:16:37 +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" 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 --- 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 01:39:05 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 9819F2EA755; Thu, 21 Aug 2025 08:17:04 +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=1755764224; cv=none; b=BdCXz2QMt6r+ze8SQOxWse2ywATIcJCS9FDxSWGBfPOekqUGYJTB3iKfBi55sNNwzC8S2hFYWo1iB+yrTeLYVJzuUxNypIE2wImTsM/zacpkAFxBK4t5VrAbw8cyeemxjtKTt36gbj3g9pbaiwVJ1gpZiYheOt0ZeS+k7pc8Ico= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755764224; c=relaxed/simple; bh=x7MW3bRve0BOOp4971V2uJ3c3u7EbdqpTM9d9SjBZLs=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=IckyZqkBLeulE0vU8yO6ohcHTKqMs+etBqHmRFoXDUOOYWXUb9Cj9u3zjothDwX8sb3MKxR56+K2ZbWukw0cDGeTm/ynilaQPpoF+qJrnFqvMNE7ez1SV3mHn7wqNXJAfDhnWl8Bj3kbTYZVijoHhPgGB1jFPThQ4JWJ6HBr0Wk= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=Aq29AYcK; 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="Aq29AYcK" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6EA2DC4AF09; Thu, 21 Aug 2025 08:17:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755764224; bh=x7MW3bRve0BOOp4971V2uJ3c3u7EbdqpTM9d9SjBZLs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Aq29AYcK3/fmmD1mm67PX9D3SOq1g6qwRFR1B2cM4yrDtQy4M+eYCLzs5zn8Cwmww ZTzWFccbaHQ4gK/nzOcA1RY0DmF/mO8affn7NFkL7sOQ1M/E48UjJXg5K2CBriXrwR TazNrQCvI1Y0mhzVoGym9p5ecMAC+7oo0Hz8SK1FWBq4adyh7SwFnLpKkBJqP3SWWB lNwPZGxvhGCjgDrrP74CiVKwlLJVZGQ0SPPryUmJnIzatkaaAYUNriu55WUrFPWwEO GJeH8amUIBrFgZM9aQ7OwS9mCxdv1EDPaHSH1ho4ueyX0Vmz26g2EU/arzE5llBxEU 2OewrTHgmeczg== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1up0Tm-0000000BLg9-2WXv; Thu, 21 Aug 2025 10:17:02 +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 v2 02/14] docs: conf.py: better handle latex documents Date: Thu, 21 Aug 2025 10:16:38 +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 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 --- 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 01:39:05 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 B2F3E2EB850; Thu, 21 Aug 2025 08:17:04 +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=1755764224; cv=none; b=ud5eXs6kFpHszOsZycbDxqP9algNRgtw2p1pe4UsZVjTjZGVelSAykkqM/RlALuUt1hICf2+IOtGkuF63nm9XPdYKy1O8V6Tdd0908QaAFjHpy7RwjJFqeWXf5C9Bcmi+LLhr5Y8Yl9MZ+vzY0t8zeuZG2n1P7+L+aJ2Cn2z+HY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755764224; c=relaxed/simple; bh=zMOHwhAKrRV4C5jWXOxsmB8Ttf0MQwEXFsiqcts/lkQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=YCibjF7lFcBG8v/HrKcG5BV3yn4zBSkbasfe0HAMky44XNa0TaF5DI5xZVrJJRvC+YIU3agYf2nNGdMGBmAAdYTP+EgahT5M+UjLBW8nxBI2kg8om/Kj2H9J2XLCFsKJh2K845jmObwU7w2qrQk0NnlWy6SXnryaO3uLBFa1lxk= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=W75ChgpJ; 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="W75ChgpJ" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6CE92C116B1; Thu, 21 Aug 2025 08:17:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755764224; bh=zMOHwhAKrRV4C5jWXOxsmB8Ttf0MQwEXFsiqcts/lkQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=W75ChgpJj0xZM7futsdm6rUJEnYZHpoxcAXMEytGpMxm5iza7FndC182xp7zrfA4W XP/2UKxPvkKrB3RfRAzyazD9XzOR5XK/72afgRRVG018n+MQnFFWNFUi2/jZO5+nFQ OXFUpp5T1tmzyT5pj7oJLEpEblVxbLMMl7MoyfRRNW0Nqu6YSyCL3SCtkpuCmasP9a dOEXMxPZ+hmufSaZd5+WN3mSiYC9TqiPyrFBUcsSRYcaLtWpAYGthICIXVHlAL5snx RwJZWJzSQ+2E5oLKgw2JuN/HwTMXgLtLjBzMb8Tx0H4EPNQ145LPNGcYTBXtIH57ML xfWo1c8dbtEbA== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1up0Tm-0000000BLgD-2dJF; Thu, 21 Aug 2025 10:17:02 +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 v2 03/14] docs: conf.py: fix doc name with SPHINXDIRS Date: Thu, 21 Aug 2025 10:16:39 +0200 Message-ID: <183f630643eacf414cfa8d892f03dd1b1055c21e.1755763127.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 --- 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 01:39:05 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 B2ECC2EB84E; Thu, 21 Aug 2025 08:17:04 +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=1755764224; cv=none; b=V5E16plZKsl4zjIs7MEgnx+psP0puvO6Y4hsnJIAbcDpI1m1ZffpnHYzBPy19R2mIaixfrYpY8FVX/oYcc3mlSAn8VDzyCIGolbClSZwn+fF8L59J4vUpDhwBUYDPyAeOmdIxsAsih0Ho0wFUQ3N206g8NgdW6ZMTACMuuRWGkA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755764224; c=relaxed/simple; bh=DJ6PKIVf54EN0EVhgnkCRmWpgby/c+jMwkXMtSedHKY=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Q2/R9ZyZ3NxK9atLNVPg9DOXgO7HAKJByxgDeM00vj1dY/1OeW3kYgs0W8VI+OzhSlS4QJeFeOCTo7muxuHVXvAhCDd+Xxh5ssS4yw8Pu3naJJtNFT5aZvurv1O2v9DdVt+lGaRAFyAu8vHwpA8mIwgJVviwh9RwuZw3GVlvcqU= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=kXP4dk7v; 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="kXP4dk7v" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6BA7EC4CEF4; Thu, 21 Aug 2025 08:17:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755764224; bh=DJ6PKIVf54EN0EVhgnkCRmWpgby/c+jMwkXMtSedHKY=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=kXP4dk7vOyNbAGBj56xDMTrj/2AnzQpjmSjN2X/Wzb+e0n19WhwNGd0R+GE4wBhq6 5Gp3IWbT3vRoRTp+9rp3T38xSepxkr+RjBmsLu2lJvgn0H+pu9kQW1RXBKMUR7JQaN OZNJf9thUOkJQUmyBTsIg0Jy8cELG8N+O073ywwerHNxtlkn5b+dUHxFulEkaVVUYz OVubCFrx0OVqC61nDSJB3iBo+QIscgJqFRUxqnGqUGoG10CfZNNvkcuqfcjBmbN2gK AOX+SnqkBrBZ418eKK/3Jsc8gzWgS8UonZhASRHeu+87PDeKMIlvWRB+GQ7QwFvU8k Li2qiqAqBnmdg== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1up0Tm-0000000BLgH-2k4h; Thu, 21 Aug 2025 10:17:02 +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 v2 04/14] docs: conf.py: rename some vars at latex_documents logic Date: Thu, 21 Aug 2025 10:16:40 +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" 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 --- 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 01:39:05 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 D8EA72EB85C; Thu, 21 Aug 2025 08:17:04 +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=1755764224; cv=none; b=aRO7QkIBKcwYu7QB119kHrGo7foURG7vvLe+wuIfN65+q3zRinEFagL67u561KPhrjozjGRLvKnQmYja+y+lkcYqNKco+NDVDYib4T0JydY4ZEB5JPjNo4tbgKoSM3wkrnxsneZPIiEYiXpNAkVEXuytcEnKr8httaDwxjv3Ppw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755764224; c=relaxed/simple; bh=HCGgBM0J4x5ZSkA2bXVd4+Dveru9uIKWtG31kDwRdHA=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Hzps09SxXV6w3pECg3YEGtCWCnQ7234ONMF2Pv2OofAU5dhusoPpjfO9aU1a5O4DyyeWbHEnRd7X+e2QGFBtO9yeD3P2bKTulywL/xEh7z/Z+Fl3oEG8yqcTXNszSmewCbPpfgwZdObNxk+8kuOSeTlSe6syj2/ySMn9ohkcPW8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=ArhJONt0; 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="ArhJONt0" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 718FDC116C6; Thu, 21 Aug 2025 08:17:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755764224; bh=HCGgBM0J4x5ZSkA2bXVd4+Dveru9uIKWtG31kDwRdHA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=ArhJONt05WX96QiNYYKM7WO6oLWNsG1jAhUlGD61772x8312GWK87V9EGLflKXltv TdJR/S+zMswUXwsoCvIOXwikGyWyvIz8lx1ESK4uKrqpld4kxpkzUVveKlLQ87Uqbi WCrpYVvg/tkGbSDqysfU4DIZnh93YQGddhfv+u0ReSoyTcF7tgo6RX/qvasHFB6Jrl BQfNJYPstE2HGLPS/9YgdC2NYQOvI7LkCWGBFNJgQ1tElWaLs3okG7AWRnI5cI5Wo/ RriFfN2RLHSdE5uz+6omt/ndygF+eFhuZemL94C1a6fDZpLPfPQzc75Uh5fwB4EwmU 0BQu2gURGBKDQ== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1up0Tm-0000000BLgL-2qpD; Thu, 21 Aug 2025 10:17:02 +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 v2 05/14] docs: conf.py: use dedent and r-strings for LaTeX macros Date: Thu, 21 Aug 2025 10:16:41 +0200 Message-ID: <0d245fbd872ab3ec21bd8fe78b01340ba77ce365.1755763127.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" Instead of adding extra weird indentation at the tex file, use dedent(). While here, also use r-strings, to make easier to make its content identical to the .tex output. While here, also merge "preamble" that was added on two separate parts of the code (in the past, there were some version-specific checks). No functional changes, just cosmetic ones. Signed-off-by: Mauro Carvalho Chehab --- Documentation/conf.py | 26 ++++++++++++-------------- 1 file changed, 12 insertions(+), 14 deletions(-) diff --git a/Documentation/conf.py b/Documentation/conf.py index 6e12c7d8e07e..628af81e6879 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, @@ -462,11 +464,11 @@ latex_elements =3D { "inputenc": "", "utf8extra": "", # Set document margins - "sphinxsetup": """ + "sphinxsetup": dedent(r""" hmargin=3D0.5in, vmargin=3D1in, parsedliteralwraps=3Dtrue, verbatimhintsturnover=3Dfalse, - """, + """), # # Some of our authors are fond of deep nesting; tell latex to # cope. @@ -475,20 +477,16 @@ latex_elements =3D { # For CJK One-half spacing, need to be in front of hyperref "extrapackages": r"\usepackage{setspace}", # Additional stuff for the LaTeX preamble. - "preamble": """ + "preamble": dedent(r""" % Use some font with UTF-8 support with XeLaTeX - \\usepackage{fontspec} - \\setsansfont{DejaVu Sans} - \\setromanfont{DejaVu Serif} - \\setmonofont{DejaVu Sans Mono} - """, -} - -# Load kerneldoc specific LaTeX settings -latex_elements["preamble"] +=3D """ + \usepackage{fontspec} + \setsansfont{DejaVu Sans} + \setromanfont{DejaVu Serif} + \setmonofont{DejaVu Sans Mono} % Load kerneldoc specific LaTeX settings - \\input{kerneldoc-preamble.sty} -""" + \input{kerneldoc-preamble.sty} + """) +} =20 # This will be filled up by config-inited event latex_documents =3D [] --=20 2.50.1 From nobody Sat Oct 4 01:39:05 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 06F152EB87B; Thu, 21 Aug 2025 08:17:04 +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=1755764225; cv=none; b=q9RvwT7iswV4tSfl5spugFDmEjIoc2ge+qbI5TOGb11oHdDxt7MIOdWh/htAjyUxRIFZDxgcXqmlL6ggaNpqw3dx53L4uWjI7KoiproiPJxOkI3iWsxX5fran5hSWJE/g5Ize1TUraFdxi6CAycU44A7c0h5AHCSNrwMTesyOvE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755764225; c=relaxed/simple; bh=iovWlxU8FZeQLZGB4r7Pf0D7peHGXlMDwJzqoqefxR0=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=S9HNm6goXyUud35jxkUiA75DYeaHsw2tz5J+u76lexx4iQ1J6hQ4FjTNm/UUCv8X3EIZc2qC7LO35jDVtQJRjfRsuKd1Uyib2O6P2aXxdTW9RKs5p/2byWhY7jszy/BSZvNWqacmLm2zrhyNyH8uHNLRw8RXO7mPVzRGYy2igRY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=nmF0foju; 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="nmF0foju" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 75CE3C19422; Thu, 21 Aug 2025 08:17:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755764224; bh=iovWlxU8FZeQLZGB4r7Pf0D7peHGXlMDwJzqoqefxR0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=nmF0fojuaGjjcf8TfUhJqOY+OSnS+UT88p05wMFvWLNbH/y0EuaGgDI+CmMC3Q8oT QQ1Ro14ylWGilYM6zVarTkxdV63q0VYZnc6u7aCwjHMQzZrahVb+HRQu1kxnhjTTv5 kxl1nx5Ix4uWAe+R6ZDXcQ4SR9Q6fjYzhsxZRxq0U4M2leqvng6qVaslcozl9wIDDb muD1X/2ihdFviCK+WbGNUNKRIiMFJBfW2gPvFCAilJzLN5q6NEvmWnolWyQgdeyw35 ZcxIi3O0067sE59h2loMnno2ZYs+SggTLaL4xpgE9B34AKDtLqh0A/aCZGIMqbh2Jj DeTKzpsyFBcMQ== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1up0Tm-0000000BLgP-2xb9; Thu, 21 Aug 2025 10:17:02 +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 v2 06/14] docs: conf.py: fix some troubles for LaTeX output Date: Thu, 21 Aug 2025 10:16:42 +0200 Message-ID: <8104ce56a5ea3509fbb56a8163b779d38a6aaa9c.1755763127.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" While PDF docs work fine on RPM-based distros, it causes conflicts on Debian & friends. There are multiple root causes here: - the latex_elements still resambles the one from Sphinx 1.x times, where font configurations were stored under "preamble". It doesn't follow the current recommended way from Sphinx documentation: https://www.sphinx-doc.org/en/master/latex.html - instead of setting the main font, from where other fonts are derivated, it sets romanfont; - "fontenc" is not set. This allows the *.tex output file to contain an UTF-8 incompatible fontset: \usepackage[T1]{fontenc} Address such issues to help preventing incompatible usage of both T1 font and UTF-8 ones that comes from DejaVu font family. On some distros, this even generate a LaTeX font warning about corrupted NFSS tables like this (I got it when running it in interactive mode): 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 Signed-off-by: Mauro Carvalho Chehab --- Documentation/conf.py | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/Documentation/conf.py b/Documentation/conf.py index 628af81e6879..5888e2988b4f 100644 --- a/Documentation/conf.py +++ b/Documentation/conf.py @@ -461,6 +461,7 @@ latex_elements =3D { # Latex figure (float) alignment # 'figure_align': 'htbp', # Don't mangle with UTF-8 chars + "fontenc": "", "inputenc": "", "utf8extra": "", # Set document margins @@ -476,13 +477,14 @@ 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": dedent(r""" - % Use some font with UTF-8 support with XeLaTeX + "fontpkg": dedent(r""" \usepackage{fontspec} + \setmainfont{DejaVu Serif} \setsansfont{DejaVu Sans} - \setromanfont{DejaVu Serif} \setmonofont{DejaVu Sans Mono} + \newfontfamily\headingfont{DejaVu Serif} + """), + "preamble": dedent(r""" % Load kerneldoc specific LaTeX settings \input{kerneldoc-preamble.sty} """) --=20 2.50.1 From nobody Sat Oct 4 01:39:05 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 D8F172EB85D; Thu, 21 Aug 2025 08:17:04 +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=1755764224; cv=none; b=X6+3fpqq8cjccWKCMgxZehEsArr8fDLiNXpxjAGjlYSV0/EZJiVJGl6d6CugzesUGcuZq3rirSPEqN7ENG4IgktxmbGcTIJfPwCxBVeBx79ANVXTBZmR0Q91sLXX2DJ7eTokkaYc1ZyXxM8hcTTAPSzQeuQ+7od+dnvHTKRauos= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755764224; c=relaxed/simple; bh=TuZzM907xB+KTOv4gNdoJ0KIyd5sboPQJN60CO9pPLo=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=ILmAUjDez8XVfC5ODUtPLcDGBjvu3Nq5RTdQM+wMjjQCGd2cfAgQS594I0Hts38XIAV7kOPIBp9UCeAGO5RrtG8si6Lg6QR0Tj42McXaQtlnhjhpkMFHMNuocYAWToc3i13SfzPoivi8/3CjNyOR28u7dT54It6tiGIJBSCuI5o= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=KAc78K0n; 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="KAc78K0n" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 73992C19421; Thu, 21 Aug 2025 08:17:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755764224; bh=TuZzM907xB+KTOv4gNdoJ0KIyd5sboPQJN60CO9pPLo=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=KAc78K0n906bqvlnrznWY63kjBqp5ET2aODKVPx+m94hCUANr5sZ5HOHk4aHLI/ug QUeI96V5wpT+vYRSuSsTYA93xSO8D64TlkFFHYjfaMWTz2OHHmlT63aLBZy2pB9rMI VSI6aDy9ldaLz796clBKyd9JjDbmHwurmDnWKJ0BNvRQs9WFz5uqhNidBIVPa3mcwa ojUMchYqigcKMbdOGjauuFoClYFvwfz17zUmUNh7a/Exd1Merde9xDxRDtqeHtxyHo LR7TNUop1yha9QUK66F/7AyrRPjevLXOW59EOtnPt2PIgg3CxpSw+QUqlsBw9ermjL wsTJ0x8jbSsWA== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1up0Tm-0000000BLgT-34TO; Thu, 21 Aug 2025 10:17:02 +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 v2 07/14] docs: conf.py: extra cleanups and fixes Date: Thu, 21 Aug 2025 10:16:43 +0200 Message-ID: <08d16c2ad817910eb5606842f776d3f77d83282f.1755763127.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-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Makes it more adehent with modern Sphinx LaTeX build setup as defined at: https://www.sphinx-doc.org/en/master/latex.html There, it suggests: 1) to add: 'printindex' =E2=80=9Cprintindex=E2=80=9D call, the last thing in the file. Override= if you want to generate the index differently, append some content after the index, or change t= he font. As LaTeX uses two-column mode for the index it is often advisable to se= t this key to r'\footnotesize\raggedright\printindex'. This indeed solved a corner case on a distro where the index was not proper= ly generated. 2) to add at the main example: \PassOptionsToPackage{svgnames}{xcolor} 3) I got a corner case on one of the distros was using xindy to produce indexes. This ended causing the build logic to incorretly try to use T1 fontenc, which is not UTF-8 compatible. This patch adds: \PassOptionsToPackage{xindy}{language=3Denglish,codepage=3Dutf8,noa= utomatic} to cover such case. It should be noticed that, as the config doesn't have \usepackage{xindy}, this will be used only if latexmk ends using xindy. Signed-off-by: Mauro Carvalho Chehab --- Documentation/conf.py | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Documentation/conf.py b/Documentation/conf.py index 5888e2988b4f..1c4695727208 100644 --- a/Documentation/conf.py +++ b/Documentation/conf.py @@ -456,8 +456,15 @@ 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 --=20 2.50.1 From nobody Sat Oct 4 01:39:05 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 05F172EB87A; Thu, 21 Aug 2025 08:17:04 +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=1755764225; cv=none; b=c0nquIv2ufpgujtO2jo5D0/S17Tur9iUP0o1rVRFXApyCB2v8HMRBM4AX/b0JgEKASmELZDvBTu3Q34F4MGN+CqCuRW7ht/cBIirnlDiKY/hwsevobwWPq+xMLOaLk7XYtXlNJEvUtZuJxW3PJ1vX/lOh8EfYer2L3QNzmDFEws= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755764225; c=relaxed/simple; bh=U/g86Ig1pMFruBqlvyzjZIHjO9UsMDLq3GNFDgoQFww=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=FjuKvPhN7LMJKrv4+ibRZpeCET6OJv14nummYVCpQjRXLMwDyCt0Erv8Y+VNPdryM2imVzB4KGfqIT6E87FN5SQv5FPnfo8SpPOZ9Yn+qyvbJ2cBCQShLzLV1fuItRpbkO1NDAZZn3o8/KZ39fzMBCHN8ak6W/bWTjWW5SxgNzw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=hbcPYVYk; 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="hbcPYVYk" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 8FEFFC19425; Thu, 21 Aug 2025 08:17:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755764224; bh=U/g86Ig1pMFruBqlvyzjZIHjO9UsMDLq3GNFDgoQFww=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=hbcPYVYk/bgbxrIyOb7d4rAk1nc+g7NuhoqJ9mZH6AktqL52ZWq04L/TltiU6QefM v/2Gq6yzCNknp77Fgli9s0mAU75edAZ5zRr07CUbMUJDU0iT0GSQ+yvpIa7Kx/aOqW +FgEXnTeju3e4/CRVuFL4aT7GZwBU0ZFmGDluaCGvFIwIkGu39NiH7F2wy7zTitNmr Ynl+hN2c5TB7nvQJOixdAEg2if3xuEQwwp/R+FWKQKdkQ93tkeKWsfZ2A1g2FONIxE biwqHy8zXJySrlP5K2n88+bUSxaoWlez/QkKMNrpL8OMR+qhXDVZh/WCkuAxS9jpGc 0UIqj7SEQyDjA== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1up0Tm-0000000BLgX-3C09; Thu, 21 Aug 2025 10:17:02 +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 v2 08/14] scripts: sphinx-pre-install: fix PDF build issues on Ubuntu Date: Thu, 21 Aug 2025 10:16:44 +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 ------------- 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 01:39:05 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 E1A062EB86E; Thu, 21 Aug 2025 08:17:04 +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=1755764225; cv=none; b=pqOaHBeegLfmYCElapd76baDQj0+wJQPRGiKniivDTeC+MlbLuWkt6Vhyc1UQyJHTWmnc5JhQJOgc8lL/E2JtgJuNlpiXf37SwJZP2wiM36oc6q2MdCSgZC9nRuAyv3UKrgiE3ajGg0MNhwWOo+n60ZrMP9OCCvG0uV5hWsGGDo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755764225; c=relaxed/simple; bh=41pClSqrGKyS+WUV3sXkeu12bzUgmg2ZeJUiAXxatDs=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=HP+ke8eP++6WVCrxUnNHN1GAnjlqTDkzceJoJUcSgsExiyEGggNsqQp4SGDb0Jy+Odtglp4eSNzOUg5prUEKe9ONAdWZWhM3Yo0JKA1Hfsbu1cCEhdIk0p/mJ8mqhurDKS2cifl7AUwL78yJN6Io5XZG0QQ4QwMViF/LI/CETS4= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=X9uYdykX; 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="X9uYdykX" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 8FF5CC2BCAF; Thu, 21 Aug 2025 08:17:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755764224; bh=41pClSqrGKyS+WUV3sXkeu12bzUgmg2ZeJUiAXxatDs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=X9uYdykXE4ZNmq+JEm4UGrBru8LFuioX91kGSFlrvs+jGV/8juwTF8LcbKE8S1WoE CoKTTM3iz3xXkpXdReEN8DdXtIUiLm5N0LMvAY/nTsDWj8v0oF/hjLokDngX2VWxlC Li/f128sp0QK7fFQKylSguAu/onzNp4Etb807h+JERM6X0X1nLQ1HSfenn7y+YwPyl tPQugbAdbpRekAwvioaaCToi/RXcIVZ4/4milA/Wwlo6x4KSXc11eXiD6rdlN+27yi 72ynhiSknAgJ1fSXM/yMpVCpSxy+wNzV4Ibb+bVSpNdbPAjC0QnRFvVRH+wqO2bvgU I2p5Sa+MJ9FYw== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1up0Tm-0000000BLgb-3JI4; Thu, 21 Aug 2025 10:17:02 +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 v2 09/14] scripts: sphinx-pre-install: add missing gentoo pdf dependencies Date: Thu, 21 Aug 2025 10:16:45 +0200 Message-ID: <0ac8d6b7484aaf930917c8edde53742d425e7e8f.1755763127.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: -------------------------------- 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 01:39:05 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 07A282EB87E; Thu, 21 Aug 2025 08:17:04 +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=1755764225; cv=none; b=S3+vAcnQG8Jg4P4bo5dOWAoVaoL6BPVyb/XBup5O3cKHjV288OP0BoKHkfEAbRX8PiX0UmBMxj+I3eytqiMCZCvVRX1HjwOFsCvlyShDMT6LIHMDLplGccPe9Egfnxs8RqIvXYlz9zjmQiAKQWlbh5qNKEjmUR9vyEduH/HdW90= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755764225; c=relaxed/simple; bh=fC/Zs5gmjYzgmfpcSoCA1d9edA3MkAXrkitO6YzqW1c=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=rqxJU/Vf7d/1Jm9GR6swt1u7MGIC0N19WKXBqKYrhpsI7FONv5Z1iuP6wiQkIAdX+Qffp8gAUvbOhyxx9824C7iToVPnny3Ona1x8LHTlIAQnkMKv1yiqqWQrX9rR3UlQ0VPlYsfma8aWMv7x+86rBpgSQVz1svKqhcdej3Luu8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=Kxn2eg5h; 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="Kxn2eg5h" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 90E5DC2BC9E; Thu, 21 Aug 2025 08:17:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755764224; bh=fC/Zs5gmjYzgmfpcSoCA1d9edA3MkAXrkitO6YzqW1c=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Kxn2eg5hfLDgU6IiKOwWrsnCHuBYltIx/uzLZwPGX5VRzt19eYUC7hNts7A36RUH5 nWYxU+jqmoSbi7/5NTlufbdZcajVVDZ5E7Wb0j4osWiMrnVZBdNfM68bXjNmsx2L95 8gV4bapR8CNusMIDFANIvI0NTk3tfLhRn/I6Ipq0a0k0szGTZfrDrsCHYrKAQD2XoJ 6fvxG6hd6jJ+nsMY7rIO7lDmoyrL2AFacvHJzdOMk8O04LIQOAp0avTVV9rO2F/aFW awRiLR5Z8ycUYrUOz3hO9+O4lpYXZMe39KSI3t2AjLGQEfMN7rlD6/FimLBAJlhLvH +UsH22sIE5hRw== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1up0Tm-0000000BLgf-3Q5a; Thu, 21 Aug 2025 10:17:02 +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 v2 10/14] scripts: sphinx-pre-install: fix PDF dependencies for openSuse Date: Thu, 21 Aug 2025 10:16:46 +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: ------------------- 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 01:39:05 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 E17E62EB86C; Thu, 21 Aug 2025 08:17:04 +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=1755764225; cv=none; b=PgbJZNwKeFCcTD5qmyLw3LsOk3r8WaGTj26L7Qfv61P/8eGLL2IBIHRLCCx5nZSmFNv6P+cHtjYlihRgE2q2OGpH4YyQvRBfgo2rzrOQjyZxvWtpexJUJqzrkttWu2yPJOy3EtG1ErMX4AWOvfp26549xCfVibO4m+grFafePu8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755764225; c=relaxed/simple; bh=DbSg1eVMzWOl8sp3iwWjKfFikdD3ZrhJkW3NI3ZW7Hk=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=p23bWhs7TaHRJcWuIA4Bb8b+Z0AV2LJ24tlpqQN0RoztsrLWcn4DBpgK1sGtMoITvdxUiQ9hgBrMqI2zP09BWmm/BVFAFcsoMvSts2HhYH7envAlepJmlKjVlBSC4a+S4YIVd4PRZJO9bjTfejbppzp3+TgJI3Ivu2HYdtOFaMM= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=qbFBenZZ; 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="qbFBenZZ" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 91A34C4AF0B; Thu, 21 Aug 2025 08:17:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755764224; bh=DbSg1eVMzWOl8sp3iwWjKfFikdD3ZrhJkW3NI3ZW7Hk=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=qbFBenZZGSqb6+92iV9k8tbt5QVzepDHP6dfiWwWmRrQWWMHIbP51Exzp+t1LRrsQ NuT8Xa/htYETEn5gLTAWLSTbhnnjyi2du+7pU5Xl8VAF2sacylRtKfnMn+o5Lpds8m wFVQT3H7LGKP/3pjypwYhh87T54nMH3SRr4zX2FnCKivWIARZ+5mYw+qShd1z73/RI H1JQbkz4WcWDu4m1+OM+kDDWhiAPkaFomzb/GcNhamYCxWv4OZZjhbyP5rS2iyKvPZ wVh6B7mWjB4R1pWY90Aal+jSPy5EGP+LYn1xKfXOHSqwAWg9S+sKjU3IKEhmW8aKNq 2FrqNTW5aHulw== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1up0Tm-0000000BLgj-3X8Z; Thu, 21 Aug 2025 10:17:02 +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 v2 11/14] scripts: sphinx-pre-install: fix dependencies for OpenMandriva Date: Thu, 21 Aug 2025 10:16:47 +0200 Message-ID: <669e759ba366328e5c8d5b14a591ba45a1f58176.1755763127.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 --- 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 01:39:05 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 E18FF2EB86D; Thu, 21 Aug 2025 08:17:04 +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=1755764225; cv=none; b=Mr7uTKEYOrvzCS5OHhXT+cyDeZo8aOzq2HxoqYGb1Cb8k1bi5k3nUfSU+QkrQEmVWyQRVj/ea7q60WfmsLiHQlek7SICrO3VIrZdC0wCcY0iJG9+fc4i/E6NqMbDqR0NYDG6VfpM8cKgxknx8QiF6eCKrpKli9By1Wrze7oLxug= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755764225; c=relaxed/simple; bh=+/6Ro+Dnlq3YRqR0pERxWJ2pVEtF9E0U8Tw5zszBXiA=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=rmiNaVb4t8aJpwqE0kAVNl4kwB8L3suZId5iK2x0sXAHLaadMdUVg+6LoWt4ySH3ztYilwRb7JF+vinUehMkvwYZ97wj52kPRqFJzGEdgZb38kMhThGHUqfTPg2qC+2g8nif4S+Aihg6FessTOBqzzocUteQcjM7AIm188XbcOE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=bES3ep9F; 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="bES3ep9F" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 9624EC2BCB0; Thu, 21 Aug 2025 08:17:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755764224; bh=+/6Ro+Dnlq3YRqR0pERxWJ2pVEtF9E0U8Tw5zszBXiA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=bES3ep9FYW91fF8p09vin8yjcaW8j7l/TMDDOwbBWw1s0mHeLJJtfVcP5Aequutfz bIgtVKPPBJlofG6piPB3dlN6F/ozQ0k7g/n+Bk+fXHPyV6MQrx0yGnWJu55kIk1Zsw CAFrlzdWeFWjXD4yVace8qT7Eit4ua0ZDmEl9rNTfzMIyudIpy/1GAQ8GxmfgcvohS kcMQMUQ40eAcOrTB5/box3+oyiJAlDswgpp5c70hG0Qa9r3dx8/hdoNrSRieYy9Jpj fwST0vnJyD6YEUG1iaVezTUOZoMHC8cqhHDa1JjzmZXciBicmzY7WgnuUNC3PG/v2T XucUL8or9N7Mw== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1up0Tm-0000000BLgn-3eQQ; Thu, 21 Aug 2025 10:17:02 +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 v2 12/14] scripts: sphinx-pre-install: fix pdf dependencies for Mageia 9 Date: Thu, 21 Aug 2025 10:16:48 +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: --------- 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 01:39:05 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 43C352EBDC9; Thu, 21 Aug 2025 08:17:04 +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=1755764225; cv=none; b=BFMn8j6j4QoTOUhS0a1iCtZhDmIbXuDrpTepUvn9am22lh+/G6wxsBh1l6T5+Cdyocxpxk03uEWMpY7fHxcTUErCOGYYnKmN7E0mvDtbjclD/PzjpYhykDNtWcy4N08V5as1nl96i+jF0iFtSRX4bpkbZJntGevaGRwZyu5Zb8k= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755764225; c=relaxed/simple; bh=FF6CTJItuLQX4L+saUiPgdc0K549DCILUpiRkhl6c30=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=OjMO4dDNqNrMTHyLchOeALEVePMwsFx+YseCbHcm2aqO/QZsAVxyvMzF5Fo1MX8DJBkctNQlr8qojiVFZxxsSJmxhEwEXy+IBvrMep9ICWnysqwqMjnDVHY0yYcQW4L+NFvmV0NOr4p0CZxpO6lHoj8lGE2gpcaUakqBgZLQTZ8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=UO+N5AYi; 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="UO+N5AYi" Received: by smtp.kernel.org (Postfix) with ESMTPSA id A097CC2BCB2; Thu, 21 Aug 2025 08:17:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755764224; bh=FF6CTJItuLQX4L+saUiPgdc0K549DCILUpiRkhl6c30=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=UO+N5AYimlPSluyn9jignm2yFluYaxYo4hv+xK5XBUjRqTbFv2mm+O/vrWeqRrzDd jang/PKy/YXZKXzq0dpCCLXb3YGrW+tZLoDDLd2b+9VVPKQGiz2uN/hvJRBxfodbRq Bbqp0/X9lPIC90wUh90ssGmarYxC2xYu11hoO97SWXR79bCEkYcJVc8eACmEiAZT9w GwcApCoP1oOKmALsC2Q39PAoh5SsSVrqevYvnt9fuFDsz1L+fLxYCxsxldpY4MxQZR s2UyLmrFOXlCpPdf/gwvkoLBNBeU/Fa0iWGBRFiA/yeAq2K+qYvPHh/l8eKmnM/XcF PUNmBYVep4mWg== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1up0Tm-0000000BLgr-3luW; Thu, 21 Aug 2025 10:17:02 +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 v2 13/14] scripts: sphinx-pre-install: fix PDF dependencies for gentoo Date: Thu, 21 Aug 2025 10:16:49 +0200 Message-ID: <1ccbac9fd1f4e598dda82e775b64768ec3696248.1755763127.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" 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 --- 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 From nobody Sat Oct 4 01:39:05 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 43EC22EBDCA; Thu, 21 Aug 2025 08:17:04 +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=1755764225; cv=none; b=YaaEkaWirZGOfmgEG8jo+wRfpYBVGocrR37hI/ONtf4IZxxXNvWYdfCw1cC2hJeor9wRS0xaxOmnhIxc1cr4s1vmbw+PGiCVxJMGlta+p3QiTj1t14EcSiO5PcxvFqD0pnDHCOGjwzRdSsR2bYMNSX8RvPEFacGnpc4AcK7lA90= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755764225; c=relaxed/simple; bh=+0AJ0cWG/9OFYSPOjOfNLiW9rTewkgZT7lE9vDRgSBw=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=brdtHdIudeSpW3YRrepuAAieiGCY5jrWm0gXVtxhUyPmBK9NRgUHfd+dT1IF3/SQqdJ1ERJufyn0Durs8AN35Gggx8uabiBfDCXNC6j362sgpXEyC0EyZ2llC8Ta26vpI+TjcG3XB/H14PsmbipoVXWsonr9dynoe4klMkOZTOg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=akVg+l4E; 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="akVg+l4E" Received: by smtp.kernel.org (Postfix) with ESMTPSA id CBFF4C2BCB7; Thu, 21 Aug 2025 08:17:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1755764224; bh=+0AJ0cWG/9OFYSPOjOfNLiW9rTewkgZT7lE9vDRgSBw=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=akVg+l4EyuUOLB2ezLIsGpaqJ5VlEMWNQzFfgwHPHeil2dkl7MGYirWCyyGuI11gu 0FvRNeMFQnqXAXfzQisDOWqVD03RcZfrmyJCFXQmdBmR5CgDFs+TBVc7CA+yu52ytA KwSLbPK5O/IuqDJweBECi/FeB3lXGqmPbkCa7YnLoRQfk9BzYdwiU14YBVYRd5FMK/ luUILGiTGX3uoQlJhZS0LptCp5WTGCWxdtzDtlv1wu4QFLcIgMU+FTIH6pvPxFqlZZ 2TPSyH98mt5d0Y54NmXen1q2pEfodGGCiyAj/4523+UHoGgk6dHDs/MM2bD6EDcv7a uvfrvwxcFLfdg== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1up0Tm-0000000BLgv-3sqz; Thu, 21 Aug 2025 10:17:02 +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 v2 14/14] scripts/sphinx-pre-install: fix Archlinux PDF dependencies Date: Thu, 21 Aug 2025 10:16:50 +0200 Message-ID: <574d902f7691861e18339217f42409850ee58791.1755763127.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 some missing packages causing PDF build to fail on Archlinux and add latexmk (from texlive-binextra package). Yet, at least today, PDF builds are failing on a very late stage, when trying to run xdvipdfmx: $ xdvipdfmx -E -o "peci.pdf" "peci.xdv" xdvipdfmx:fatal: Unrecognized paper format: # Simply write the paper name.= See man 1 paper and "paper --no-size --all" for possible values Despite its message, even using a very simple document like: \def\sphinxdocclass{report} \documentclass[a4paper,11pt,english]{sphinxmanual} \begin{document} Test \end{document} or even: \def\sphinxdocclass{report} \documentclass{sphinxmanual} \begin{document} Test \end{document} Is causing xdvipdfmx to complain about geometry. As Archlinux is a rolling release distro, maybe I got it on a bad day. So, let's fix it in the hope that soon enough someone would fix the issues there. Such broken scenario happens with those packages installed: texlive-basic 2025.2-1 texlive-bin 2025.2-1 texlive-binextra 2025.2-1 texlive-fontsrecommended 2025.2-1 texlive-langchinese 2025.2-1 texlive-langcjk 2025.2-1 texlive-latex 2025.2-1 texlive-latexextra 2025.2-1 texlive-latexrecommended 2025.2-1 texlive-pictures 2025.2-1 texlive-xetex 2025.2-1 python-docutils 1:0.21.2-3 python-sphinx 8.2.3-1 python-sphinx-alabaster-theme 1.0.0-4 python-sphinxcontrib-applehelp 2.0.0-3 python-sphinxcontrib-devhelp 2.0.0-4 python-sphinxcontrib-htmlhelp 2.1.0-3 python-sphinxcontrib-jsmath 1.0.1-19 python-sphinxcontrib-qthelp 2.0.0-3 python-sphinxcontrib-serializinghtml 2.0.0-3 Signed-off-by: Mauro Carvalho Chehab --- scripts/sphinx-pre-install | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/scripts/sphinx-pre-install b/scripts/sphinx-pre-install index c46d7b76f93c..954ed3dc0645 100755 --- a/scripts/sphinx-pre-install +++ b/scripts/sphinx-pre-install @@ -1048,7 +1048,12 @@ class SphinxDependencyChecker(MissingCheckers): } =20 archlinux_tex_pkgs =3D [ + "texlive-basic", + "texlive-binextra", "texlive-core", + "texlive-fontsrecommended", + "texlive-langchinese", + "texlive-langcjk", "texlive-latexextra", "ttf-dejavu", ] --=20 2.50.1