{"id":24386,"url":"https://patchwork.libcamera.org/api/patches/24386/?format=json","web_url":"https://patchwork.libcamera.org/patch/24386/","project":{"id":1,"url":"https://patchwork.libcamera.org/api/projects/1/?format=json","name":"libcamera","link_name":"libcamera","list_id":"libcamera_core","list_email":"libcamera-devel@lists.libcamera.org","web_url":"","scm_url":"","webscm_url":""},"msgid":"<20250917201742.16406-9-laurent.pinchart@ideasonboard.com>","date":"2025-09-17T20:17:39","name":"[v3,08/10] Documentation: Drop unnecessary documentation-contents.rst","commit_ref":null,"pull_url":null,"state":"accepted","archived":false,"hash":"5d301ac52641105c41a5f89508c20f0ea0814d5f","submitter":{"id":2,"url":"https://patchwork.libcamera.org/api/people/2/?format=json","name":"Laurent Pinchart","email":"laurent.pinchart@ideasonboard.com"},"delegate":null,"mbox":"https://patchwork.libcamera.org/patch/24386/mbox/","series":[{"id":5448,"url":"https://patchwork.libcamera.org/api/series/5448/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=5448","date":"2025-09-17T20:17:31","name":"Documentation theming update","version":3,"mbox":"https://patchwork.libcamera.org/series/5448/mbox/"}],"comments":"https://patchwork.libcamera.org/api/patches/24386/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/24386/checks/","tags":{},"headers":{"Return-Path":"","X-Original-To":"parsemail@patchwork.libcamera.org","Delivered-To":"parsemail@patchwork.libcamera.org","Received":["from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id 6B76AC32C2\n\tfor ;\n\tWed, 17 Sep 2025 20:18:36 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 34D856937B;\n\tWed, 17 Sep 2025 22:18:35 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 50CD069381\n\tfor ;\n\tWed, 17 Sep 2025 22:18:25 +0200 (CEST)","from pendragon.ideasonboard.com (81-175-209-231.bb.dnainternet.fi\n\t[81.175.209.231])\n\tby perceval.ideasonboard.com (Postfix) with UTF8SMTPSA id 227BB6A8;\n\tWed, 17 Sep 2025 22:17:06 +0200 (CEST)"],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (1024-bit key;\n\tunprotected) header.d=ideasonboard.com header.i=@ideasonboard.com\n\theader.b=\"MBRLfz3o\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1758140226;\n\tbh=sCeu9Rr5+OSWUlOcj41JOIw8spmDJBWVuL45OhxHsLQ=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=MBRLfz3oY/zifyl76Y2mIWkNwIAzwoIwVJ431j9DDMAHLx7c8GnTagp8QkRjCX3/z\n\ttCwnZoTz6DqqFx3QG5BX0VVsWxbFpkyXfjhCFAwGYTiJnglwIP2qP0LNvKrlqAsmGQ\n\tn6Rm7UmONT54odNjDUMI+Mk7Syib5XbAiAG9aV0Y=","From":"Laurent Pinchart ","To":"libcamera-devel@lists.libcamera.org","Cc":"Stefan Klug ","Subject":"[PATCH v3 08/10] Documentation: Drop unnecessary\n\tdocumentation-contents.rst","Date":"Wed, 17 Sep 2025 23:17:39 +0300","Message-ID":"<20250917201742.16406-9-laurent.pinchart@ideasonboard.com>","X-Mailer":"git-send-email 2.49.1","In-Reply-To":"<20250917201742.16406-1-laurent.pinchart@ideasonboard.com>","References":"<20250917201742.16406-1-laurent.pinchart@ideasonboard.com>","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "},"content":"From: Stefan Klug \n\nThe libcamera.org documentation publishing process does not rely on a\nparticular structure of the documentation anymore. This makes\ndocumentation-contents.rst unneeded. Drop it.\n\nSigned-off-by: Stefan Klug \nSigned-off-by: Laurent Pinchart \n---\nChanges since v2:\n\n- Update commit message\n\nChanges since v1:\n\n- Remove html_css_files completely\n---\n Documentation/camera-sensor-model.rst | 2 --\n Documentation/code-of-conduct.rst | 2 --\n Documentation/coding-style.rst | 2 --\n Documentation/conf.py.in | 7 +---\n Documentation/documentation-contents.rst | 35 -------------------\n Documentation/environment_variables.rst | 2 --\n Documentation/feature_requirements.rst | 2 --\n .../guides/application-developer.rst | 2 --\n Documentation/guides/ipa.rst | 2 --\n Documentation/guides/pipeline-handler.rst | 2 --\n Documentation/guides/tracing.rst | 2 --\n Documentation/introduction.rst | 2 --\n Documentation/lens_driver_requirements.rst | 2 --\n Documentation/libcamera_architecture.rst | 2 --\n Documentation/meson.build | 1 -\n Documentation/python-bindings.rst | 2 --\n Documentation/sensor_driver_requirements.rst | 2 --\n Documentation/software-isp-benchmarking.rst | 2 --\n Documentation/theme/static/custom.css | 5 ---\n 19 files changed, 1 insertion(+), 77 deletions(-)\n delete mode 100644 Documentation/documentation-contents.rst\n delete mode 100644 Documentation/theme/static/custom.css","diff":"diff --git a/Documentation/camera-sensor-model.rst b/Documentation/camera-sensor-model.rst\nindex 87a25bf4a7fc..b66c880a5e00 100644\n--- a/Documentation/camera-sensor-model.rst\n+++ b/Documentation/camera-sensor-model.rst\n@@ -1,7 +1,5 @@\n .. SPDX-License-Identifier: CC-BY-SA-4.0\n \n-.. include:: documentation-contents.rst\n-\n .. _camera-sensor-model:\n \n .. todo: Move to Doxygen-generated documentation\ndiff --git a/Documentation/code-of-conduct.rst b/Documentation/code-of-conduct.rst\nindex 0edd1e9955e0..38b7d7ad679f 100644\n--- a/Documentation/code-of-conduct.rst\n+++ b/Documentation/code-of-conduct.rst\n@@ -1,7 +1,5 @@\n .. SPDX-License-Identifier: CC-BY-4.0\n \n-.. include:: documentation-contents.rst\n-\n .. _code-of-conduct:\n \n Contributor Covenant Code of Conduct\ndiff --git a/Documentation/coding-style.rst b/Documentation/coding-style.rst\nindex 6ac3a4a0d517..3352b75c76c8 100644\n--- a/Documentation/coding-style.rst\n+++ b/Documentation/coding-style.rst\n@@ -1,7 +1,5 @@\n .. SPDX-License-Identifier: CC-BY-SA-4.0\n \n-.. include:: documentation-contents.rst\n-\n .. _coding-style-guidelines:\n \n Coding Style Guidelines\ndiff --git a/Documentation/conf.py.in b/Documentation/conf.py.in\nindex 2c75a75799e6..349feda2a610 100644\n--- a/Documentation/conf.py.in\n+++ b/Documentation/conf.py.in\n@@ -108,7 +108,7 @@ html_context = {\n # Add any paths that contain custom static files (such as style sheets) here,\n # relative to this directory. They are copied after the builtin static files,\n # so a file named \"default.css\" will overwrite the builtin \"default.css\".\n-html_static_path = ['@CURRENT_SRCDIR@/theme/static']\n+html_static_path = []\n \n # Custom sidebar templates, must be a dictionary that maps document names\n # to template names.\n@@ -119,8 +119,3 @@ html_static_path = ['@CURRENT_SRCDIR@/theme/static']\n # 'searchbox.html']``.\n #\n # html_sidebars = {}\n-\n-html_css_files = [\n- 'custom.css',\n-]\n-\ndiff --git a/Documentation/documentation-contents.rst b/Documentation/documentation-contents.rst\ndeleted file mode 100644\nindex 5c1118493745..000000000000\n--- a/Documentation/documentation-contents.rst\n+++ /dev/null\n@@ -1,35 +0,0 @@\n-.. SPDX-License-Identifier: CC-BY-SA-4.0\n-\n-.. container:: documentation-nav\n-\n- * **Documentation for Users**\n- * :doc:`Introduction `\n- * :doc:`/feature_requirements`\n- * :doc:`/guides/application-developer`\n- * :doc:`/python-bindings`\n- * :doc:`/environment_variables`\n- * :doc:`/api-html/index`\n- * :doc:`/code-of-conduct`\n- * |\n- * **Documentation for Developers**\n- * :doc:`/libcamera_architecture`\n- * :doc:`/guides/pipeline-handler`\n- * :doc:`/guides/ipa`\n- * :doc:`/camera-sensor-model`\n- * :doc:`/guides/tracing`\n- * :doc:`/software-isp-benchmarking`\n- * :doc:`/coding-style`\n- * :doc:`/internal-api-html/index`\n- * |\n- * **Documentation for System Integrators**\n- * :doc:`/lens_driver_requirements`\n- * :doc:`/sensor_driver_requirements`\n-\n-..\n- The following directive adds the \"documentation\" class to all of the pages\n- generated by sphinx. This is not relevant in libcamera nor addressed in the\n- theme's CSS, since all of the pages here are documentation. It **is** used\n- to properly format the documentation pages on libcamera.org and so should not\n- be removed.\n-\n-.. rst-class:: documentation\ndiff --git a/Documentation/environment_variables.rst b/Documentation/environment_variables.rst\nindex 0cb4e27cd670..099769eab677 100644\n--- a/Documentation/environment_variables.rst\n+++ b/Documentation/environment_variables.rst\n@@ -1,7 +1,5 @@\n .. SPDX-License-Identifier: CC-BY-SA-4.0\n \n-.. include:: documentation-contents.rst\n-\n Environment variables\n =====================\n \ndiff --git a/Documentation/feature_requirements.rst b/Documentation/feature_requirements.rst\nindex e6b74a62906a..1bceb3028cd0 100644\n--- a/Documentation/feature_requirements.rst\n+++ b/Documentation/feature_requirements.rst\n@@ -1,7 +1,5 @@\n .. SPDX-License-Identifier: CC-BY-SA-4.0\n \n-.. include:: documentation-contents.rst\n-\n Feature Requirements\n ====================\n \ndiff --git a/Documentation/guides/application-developer.rst b/Documentation/guides/application-developer.rst\nindex bccb54acc6d4..06c07d1e9449 100644\n--- a/Documentation/guides/application-developer.rst\n+++ b/Documentation/guides/application-developer.rst\n@@ -1,7 +1,5 @@\n .. SPDX-License-Identifier: CC-BY-SA-4.0\n \n-.. include:: ../documentation-contents.rst\n-\n Using libcamera in a C++ application\n ====================================\n \ndiff --git a/Documentation/guides/ipa.rst b/Documentation/guides/ipa.rst\nindex cd640563a5f9..25deadefaf7c 100644\n--- a/Documentation/guides/ipa.rst\n+++ b/Documentation/guides/ipa.rst\n@@ -1,7 +1,5 @@\n .. SPDX-License-Identifier: CC-BY-SA-4.0\n \n-.. include:: ../documentation-contents.rst\n-\n IPA Writer's Guide\n ==================\n \ndiff --git a/Documentation/guides/pipeline-handler.rst b/Documentation/guides/pipeline-handler.rst\nindex 2b866d98059c..85d9cc870021 100644\n--- a/Documentation/guides/pipeline-handler.rst\n+++ b/Documentation/guides/pipeline-handler.rst\n@@ -1,7 +1,5 @@\n .. SPDX-License-Identifier: CC-BY-SA-4.0\n \n-.. include:: ../documentation-contents.rst\n-\n Pipeline Handler Writers Guide\n ==============================\n \ndiff --git a/Documentation/guides/tracing.rst b/Documentation/guides/tracing.rst\nindex 537dce500338..ae960d85c075 100644\n--- a/Documentation/guides/tracing.rst\n+++ b/Documentation/guides/tracing.rst\n@@ -1,7 +1,5 @@\n .. SPDX-License-Identifier: CC-BY-SA-4.0\n \n-.. include:: ../documentation-contents.rst\n-\n Tracing Guide\n =============\n \ndiff --git a/Documentation/introduction.rst b/Documentation/introduction.rst\nindex d76cebd05ee1..07b3a27ed007 100644\n--- a/Documentation/introduction.rst\n+++ b/Documentation/introduction.rst\n@@ -1,7 +1,5 @@\n .. SPDX-License-Identifier: CC-BY-SA-4.0\n \n-.. include:: documentation-contents.rst\n-\n ************\n Introduction\n ************\ndiff --git a/Documentation/lens_driver_requirements.rst b/Documentation/lens_driver_requirements.rst\nindex 85fef76f2580..b96e502d5da6 100644\n--- a/Documentation/lens_driver_requirements.rst\n+++ b/Documentation/lens_driver_requirements.rst\n@@ -1,7 +1,5 @@\n .. SPDX-License-Identifier: CC-BY-SA-4.0\n \n-.. include:: documentation-contents.rst\n-\n .. _lens-driver-requirements:\n \n Lens Driver Requirements\ndiff --git a/Documentation/libcamera_architecture.rst b/Documentation/libcamera_architecture.rst\nindex d2bd13e1dc39..ee67102a30a6 100644\n--- a/Documentation/libcamera_architecture.rst\n+++ b/Documentation/libcamera_architecture.rst\n@@ -1,7 +1,5 @@\n .. SPDX-License-Identifier: CC-BY-SA-4.0\n \n-.. include:: documentation-contents.rst\n-\n libcamera Architecture\n ======================\n \ndiff --git a/Documentation/meson.build b/Documentation/meson.build\nindex 022770968fcf..54c32e249e45 100644\n--- a/Documentation/meson.build\n+++ b/Documentation/meson.build\n@@ -157,7 +157,6 @@ if sphinx.found()\n sphinx_conf,\n 'contributing.rst',\n 'design/ae.rst',\n- 'documentation-contents.rst',\n 'environment_variables.rst',\n 'feature_requirements.rst',\n 'guides/application-developer.rst',\ndiff --git a/Documentation/python-bindings.rst b/Documentation/python-bindings.rst\nindex 947122384c88..ed9f686b311a 100644\n--- a/Documentation/python-bindings.rst\n+++ b/Documentation/python-bindings.rst\n@@ -1,7 +1,5 @@\n .. SPDX-License-Identifier: CC-BY-SA-4.0\n \n-.. include:: documentation-contents.rst\n-\n .. _python-bindings:\n \n Python Bindings for libcamera\ndiff --git a/Documentation/sensor_driver_requirements.rst b/Documentation/sensor_driver_requirements.rst\nindex fb4269d039a2..0e516b34a215 100644\n--- a/Documentation/sensor_driver_requirements.rst\n+++ b/Documentation/sensor_driver_requirements.rst\n@@ -1,7 +1,5 @@\n .. SPDX-License-Identifier: CC-BY-SA-4.0\n \n-.. include:: documentation-contents.rst\n-\n .. _sensor-driver-requirements:\n \n Sensor Driver Requirements\ndiff --git a/Documentation/software-isp-benchmarking.rst b/Documentation/software-isp-benchmarking.rst\nindex 9c2a409b140f..b303313210e8 100644\n--- a/Documentation/software-isp-benchmarking.rst\n+++ b/Documentation/software-isp-benchmarking.rst\n@@ -1,7 +1,5 @@\n .. SPDX-License-Identifier: CC-BY-SA-4.0\n \n-.. include:: documentation-contents.rst\n-\n .. _software-isp-benchmarking:\n \n Software ISP benchmarking\ndiff --git a/Documentation/theme/static/custom.css b/Documentation/theme/static/custom.css\ndeleted file mode 100644\nindex 0be62294490a..000000000000\n--- a/Documentation/theme/static/custom.css\n+++ /dev/null\n@@ -1,5 +0,0 @@\n-/* SPDX-License-Identifier: CC-BY-SA-4.0 */\n-/* Hide the documentation nav. It is only used on the website. */\n-.documentation-nav {\n-\tdisplay: none;\n-}\n","prefixes":["v3","08/10"]}