Patch Detail
Show a patch.
GET /api/patches/26711/?format=api
{ "id": 26711, "url": "https://patchwork.libcamera.org/api/patches/26711/?format=api", "web_url": "https://patchwork.libcamera.org/patch/26711/", "project": { "id": 1, "url": "https://patchwork.libcamera.org/api/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": "<20260511134817.2841886-2-stefan.klug@ideasonboard.com>", "date": "2026-05-11T13:48:04", "name": "[v2,1/2] Split documentation build into separate build step", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": false, "hash": "9ac507c3cac1417cae8c1d19d374ecd965cb7855", "submitter": { "id": 184, "url": "https://patchwork.libcamera.org/api/people/184/?format=api", "name": "Stefan Klug", "email": "stefan.klug@ideasonboard.com" }, "delegate": null, "mbox": "https://patchwork.libcamera.org/patch/26711/mbox/", "series": [ { "id": 5932, "url": "https://patchwork.libcamera.org/api/series/5932/?format=api", "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=5932", "date": "2026-05-11T13:48:03", "name": "Deploy documentation to docs.libcamera.org", "version": 2, "mbox": "https://patchwork.libcamera.org/series/5932/mbox/" } ], "comments": "https://patchwork.libcamera.org/api/patches/26711/comments/", "check": "pending", "checks": "https://patchwork.libcamera.org/api/patches/26711/checks/", "tags": {}, "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 A2D60BDCBD\n\tfor <parsemail@patchwork.libcamera.org>;\n\tMon, 11 May 2026 13:48:27 +0000 (UTC)", "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 5200F63020;\n\tMon, 11 May 2026 15:48:27 +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 9FE2E6301A\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tMon, 11 May 2026 15:48:24 +0200 (CEST)", "from ideasonboard.com (unknown\n\t[IPv6:2a00:6020:448c:6c00:b16a:5ed9:4ada:a95a])\n\tby perceval.ideasonboard.com (Postfix) with UTF8SMTPSA id 9CC89593;\n\tMon, 11 May 2026 15:48:17 +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=\"W2vYayqP\"; dkim-atps=neutral", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1778507297;\n\tbh=vFZ4g8nAup+uYoLfgw2byBc4w66PmQ++ogR9Tl914hs=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=W2vYayqP2cFqiusBUyj5tW7DXJCH5fnrGK7JOXNxf+6KWH0OklcJM4WCdV4x+KXo6\n\tY9FsyQXdPCexE+mkW/ZhriyHglp2Tme2lZzopmKOXxwPjFYhLC0qALEQhLFSkkzhCZ\n\t/XQEgo5Dy/T25UBr5HqqH5nh2ALxR3Cg6HrKHfs4=", "From": "Stefan Klug <stefan.klug@ideasonboard.com>", "To": "libcamera-devel@lists.libcamera.org", "Cc": "Stefan Klug <stefan.klug@ideasonboard.com>", "Subject": "[PATCH v2 1/2] Split documentation build into separate build step", "Date": "Mon, 11 May 2026 15:48:04 +0200", "Message-ID": "<20260511134817.2841886-2-stefan.klug@ideasonboard.com>", "X-Mailer": "git-send-email 2.51.0", "In-Reply-To": "<20260511134817.2841886-1-stefan.klug@ideasonboard.com>", "References": "<20260511134817.2841886-1-stefan.klug@ideasonboard.com>", "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": "Create a separate build step that builds the docs and merges the html\ndocs and the api docs into a single docs directory.\n\nDrop the documentation build from the build-full step as it is no longer\nneeded there.\n\nSigned-off-by: Stefan Klug <stefan.klug@ideasonboard.com>\n\n---\n\nChanges in v2:\n- Fixed copyright\n- Fixed comments and build message\n- Build debug for now, as the upstream release build is broken\n- Collect docs from a temporary install dir\n---\n .gitlab-ci/build-libcamera-docs.sh | 35 ++++++++++++++++++++++++++++++\n gitlab-ci.yml | 30 +++++++++++++++++++++----\n 2 files changed, 61 insertions(+), 4 deletions(-)\n create mode 100755 .gitlab-ci/build-libcamera-docs.sh", "diff": "diff --git a/.gitlab-ci/build-libcamera-docs.sh b/.gitlab-ci/build-libcamera-docs.sh\nnew file mode 100755\nindex 000000000000..cccb5bad9cb5\n--- /dev/null\n+++ b/.gitlab-ci/build-libcamera-docs.sh\n@@ -0,0 +1,35 @@\n+#!/bin/bash\n+\n+# SPDX-License-Identifier: GPL-2.0-or-later\n+# SPDX-FileCopyrightText: © 2026 Ideas on Board\n+#\n+# Build libcamera docs and collect them in ./docs\n+\n+set -e\n+\n+source \"$(dirname \"$0\")/lib.sh\"\n+source \"$(dirname \"$0\")/build-libcamera-common.sh\"\n+\n+libcamera_build_docs() {\n+\techo \"Building libcamera docs\"\n+\n+\t# Fixme: This should only build the documentation, but as we can't use\n+\t# the doc tag for installation we need to build everything.\n+\tmeson compile -C build -j$BUILD_CONCURRENT_JOBS\n+\n+\techo \"Installing docs\"\n+\trm -rf install\n+\tmkdir install\n+\n+\t# Fixme: This should use --tags doc,doc-internal, but the installation\n+\t# mechanics are broken and need to be fixed in libcamera. Install the\n+\t# whole project for now.\n+\tmeson install -C build --destdir $(pwd)/install\n+\n+\trm -rf docs\n+\tmv install/usr/local/share/doc/libcamera-*/html docs\n+}\n+\n+run libcamera_install_pkgs\n+run libcamera_setup\n+run libcamera_build_docs collapsed\ndiff --git a/gitlab-ci.yml b/gitlab-ci.yml\nindex f887e3b6c221..7c5e59de30a1 100644\n--- a/gitlab-ci.yml\n+++ b/gitlab-ci.yml\n@@ -229,10 +229,6 @@ build-full:debian:13:\n - ARCH: amd64\n CC: gcc-14\n CXX: g++-14\n- MESON_OPTIONS: >-\n- ${MESON_ALL_OPTIONS}\n- -D documentation=enabled\n- -D doc_werror=true\n - ARCH: amd64\n CC: clang\n CXX: clang++\n@@ -302,6 +298,32 @@ build-package:debug:\n - ARCH: amd64\n - ARCH: arm64\n \n+# Build documentation.\n+build-docs:\n+ extends:\n+ - .fdo.distribution-image@debian\n+ - .libcamera-ci.debian:13\n+ - .libcamera-ci.scripts\n+ stage: build\n+ needs:\n+ - job: container-debian:13\n+ artifacts: false\n+ script:\n+ - $CI_PROJECT_DIR/.gitlab-ci/build-libcamera-docs.sh\n+ artifacts:\n+ name: libcamera-docs-${CI_COMMIT_SHA}\n+ when: always\n+ expire_in: 1 week\n+ paths:\n+ - docs\n+ variables:\n+ # Fixme: Switch to release build as soon as the build issues are fixed.\n+ BUILD_TYPE: debug\n+ MESON_OPTIONS: >-\n+ ${MESON_ALL_OPTIONS}\n+ -D documentation=enabled\n+ -D doc_werror=true\n+\n # ------------------------------------------------------------------------------\n # Lint stage - Run checkstyle.py and check merge suitability\n # ------------------------------------------------------------------------------\n", "prefixes": [ "v2", "1/2" ] }