Cover Letter Detail
Show a cover letter.
GET /api/1.1/covers/24378/?format=api
{ "id": 24378, "url": "https://patchwork.libcamera.org/api/1.1/covers/24378/?format=api", "web_url": "https://patchwork.libcamera.org/cover/24378/", "project": { "id": 1, "url": "https://patchwork.libcamera.org/api/1.1/projects/1/?format=api", "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-1-laurent.pinchart@ideasonboard.com>", "date": "2025-09-17T20:17:31", "name": "[v3,00/10] Documentation theming update", "submitter": { "id": 2, "url": "https://patchwork.libcamera.org/api/1.1/people/2/?format=api", "name": "Laurent Pinchart", "email": "laurent.pinchart@ideasonboard.com" }, "mbox": "https://patchwork.libcamera.org/cover/24378/mbox/", "series": [ { "id": 5448, "url": "https://patchwork.libcamera.org/api/1.1/series/5448/?format=api", "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/covers/24378/comments/", "headers": { "Return-Path": "<libcamera-devel-bounces@lists.libcamera.org>", "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 455FCC328C\n\tfor <parsemail@patchwork.libcamera.org>;\n\tWed, 17 Sep 2025 20:18:15 +0000 (UTC)", "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 068AC6936F;\n\tWed, 17 Sep 2025 22:18:14 +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 CD05A69367\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tWed, 17 Sep 2025 22:18:11 +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 52CFB6A8\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tWed, 17 Sep 2025 22:16:52 +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=\"JIme8NFN\"; dkim-atps=neutral", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1758140212;\n\tbh=ov45+OIya6Bl1gxxPUM7GNADr6LRfsOrNCRTQQTC81k=;\n\th=From:To:Subject:Date:From;\n\tb=JIme8NFNh8Gx33jlQnM89otDyDhhXV8HSTkDDj+SBoOlEqZXG9GVbOQYYjM4ExH2O\n\trUnhXBzXs/BYfBnG3mFoT0vcqSCwM3X7RiNrz39/zFPKEkfS8wASfL0nZNymx0jNXr\n\tEzPpEL0u7qI7voeQCIfn440+Nn5l9AQoSS+YnuNM=", "From": "Laurent Pinchart <laurent.pinchart@ideasonboard.com>", "To": "libcamera-devel@lists.libcamera.org", "Subject": "[PATCH v3 00/10] Documentation theming update", "Date": "Wed, 17 Sep 2025 23:17:31 +0300", "Message-ID": "<20250917201742.16406-1-laurent.pinchart@ideasonboard.com>", "X-Mailer": "git-send-email 2.49.1", "MIME-Version": "1.0", "Content-Type": "text/plain; charset=UTF-8", "Content-Transfer-Encoding": "8bit", "X-BeenThere": "libcamera-devel@lists.libcamera.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "<libcamera-devel.lists.libcamera.org>", "List-Unsubscribe": "<https://lists.libcamera.org/options/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=unsubscribe>", "List-Archive": "<https://lists.libcamera.org/pipermail/libcamera-devel/>", "List-Post": "<mailto:libcamera-devel@lists.libcamera.org>", "List-Help": "<mailto:libcamera-devel-request@lists.libcamera.org?subject=help>", "List-Subscribe": "<https://lists.libcamera.org/listinfo/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=subscribe>", "Errors-To": "libcamera-devel-bounces@lists.libcamera.org", "Sender": "\"libcamera-devel\" <libcamera-devel-bounces@lists.libcamera.org>" }, "content": "Hello,\n\nThis series is a respin of Stefan's v1 with additional improvements (at\nleast in my opinion). In particular, it addresses the \"biggest issue\"\nmentioned in the cover letter of the previous version, that is the\norganization of the documentation in the installation directory.\n\nPatch 01/10 is a repost of \"[PATCH] Documentation: Use standard ordering\nfor Doxyfile variables\", in order to rebase conflicting changes on top.\nPatches 02/10 to 04/10 come from Stefan's series, with various minor\nfixes. I've dropped patch 03/10 from v2 that added SPDX tags in\ndoxygen-awesome-css as the patch has been merged upstream, and 02/10 now\nintegrates that. Patch 05/10 is new and fixes a small documentation\nbuild system issue.\n\nThe next two patches is where this series differs significantly from v1\nand v2. Patch 06/10 reorganizes the toctree of the Sphinx documentation.\nIn v1 it was combined with changes to the build system to try and fix\nbroken links. In this version, the broken links are addressed separately\nin 07/10, in a very different way compared to previous version. See\npatch 07/10 for details.\n\nPatches 08/10 and 09/10 come v1, with fixes to address review comments.\nFinally, 10/10 is a new patch that renames the internal-api-html and\napi-html directories.\n\nAll the patches pass CI, validating the latest CI changes to add the\nsphinx book theme to containers.\n\nThis was quite a ride. I don't recall the last time I went through so\nmany rabbit holes, finding a new place to dig with every dead end.\nYou'll find a list of the solutions I tried in 07/10. In the end I'm not\nfully happy with the result, as links are still broken in the build\ndirectory, but the series is a net improvement compared to the current\nsituation. Going further will likely require experimenting with the\ndoxysphinx extension, which I'll leave for another time (and for someone\nelse).\n\n\nLaurent Pinchart (4):\n Documentation: Use standard ordering for Doxyfile variables\n Documentation: Add api-html/ and internal-api-html/ to docs sources\n Documentation: Improve Sphinx and Doxygen integration\n Documentation: Rename api to public-api and drop -html suffix\n\nStefan Klug (6):\n Documentation: Add doxygen-awesome-css\n Documentation: Enable doxygen-awesome-css\n Documentation: Use the sphinx book theme\n Documentation: Reorganize toctree\n Documentation: Drop unnecessary documentation-contents.rst\n Documentation: mainpage: Make it easier to distinguish public and\n internal API\n\n .reuse/dep5 | 5 +-\n Documentation/Doxyfile-common.in | 9 +-\n Documentation/Doxyfile-internal.in | 9 +-\n Documentation/Doxyfile-public.in | 9 +-\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 | 20 +-\n Documentation/documentation-contents.rst | 35 -\n .../doxygen-awesome-sidebar-only.css | 97 +\n .../doxygen-awesome-css/doxygen-awesome.css | 2664 +++++++++++++++++\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/index.rst | 45 +-\n Documentation/install-doxygen.sh | 18 +\n .../index.rst | 0\n Documentation/introduction.rst | 8 -\n Documentation/lens_driver_requirements.rst | 2 -\n Documentation/libcamera_architecture.rst | 2 -\n Documentation/mainpage.dox | 10 +-\n Documentation/meson.build | 12 +-\n .../{api-html => public-api}/index.rst | 0\n Documentation/python-bindings.rst | 2 -\n Documentation/sensor_driver_requirements.rst | 2 -\n Documentation/software-isp-benchmarking.rst | 2 -\n Documentation/theme/footer.html | 14 -\n Documentation/theme/layout.html | 109 -\n Documentation/theme/search.html | 63 -\n Documentation/theme/static/css/theme.css | 295 --\n .../theme/static/libcamera-logo-text.svg | 223 ++\n Documentation/theme/static/search.png | Bin 482 -> 0 bytes\n Documentation/theme/theme.conf | 7 -\n README.rst | 4 +-\n 37 files changed, 3076 insertions(+), 608 deletions(-)\n delete mode 100644 Documentation/documentation-contents.rst\n create mode 100644 Documentation/doxygen-awesome-css/doxygen-awesome-sidebar-only.css\n create mode 100644 Documentation/doxygen-awesome-css/doxygen-awesome.css\n create mode 100755 Documentation/install-doxygen.sh\n rename Documentation/{internal-api-html => internal-api}/index.rst (100%)\n rename Documentation/{api-html => public-api}/index.rst (100%)\n delete mode 100644 Documentation/theme/footer.html\n delete mode 100644 Documentation/theme/layout.html\n delete mode 100644 Documentation/theme/search.html\n delete mode 100644 Documentation/theme/static/css/theme.css\n create mode 100644 Documentation/theme/static/libcamera-logo-text.svg\n delete mode 100644 Documentation/theme/static/search.png\n delete mode 100644 Documentation/theme/theme.conf\n\n\nbase-commit: 0e096da4b486afce23559ec861305edd895128cf\n--\nRegards,\n\nLaurent Pinchart" }