Patch Detail
Show a patch.
GET /api/patches/26755/?format=api
{ "id": 26755, "url": "https://patchwork.libcamera.org/api/patches/26755/?format=api", "web_url": "https://patchwork.libcamera.org/patch/26755/", "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": "<20260514101429.552173-2-stefan.klug@ideasonboard.com>", "date": "2026-05-14T10:14:16", "name": "[v4,1/2] Split documentation build into separate build step", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": false, "hash": "33405c29ce95792e5a7e7d6e6fb16c146cf433c2", "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/26755/mbox/", "series": [ { "id": 5945, "url": "https://patchwork.libcamera.org/api/series/5945/?format=api", "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=5945", "date": "2026-05-14T10:14:15", "name": "Deploy documentation to docs.libcamera.org", "version": 4, "mbox": "https://patchwork.libcamera.org/series/5945/mbox/" } ], "comments": "https://patchwork.libcamera.org/api/patches/26755/comments/", "check": "pending", "checks": "https://patchwork.libcamera.org/api/patches/26755/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 4958EBDCBD\n\tfor <parsemail@patchwork.libcamera.org>;\n\tThu, 14 May 2026 10:14:38 +0000 (UTC)", "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 15CE763022;\n\tThu, 14 May 2026 12:14:38 +0200 (CEST)", "from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 3D2976301A\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tThu, 14 May 2026 12:14:36 +0200 (CEST)", "from ideasonboard.com (unknown\n\t[IPv6:2a00:6020:448c:6c00:1c97:ae49:136:40fb])\n\tby perceval.ideasonboard.com (Postfix) with UTF8SMTPSA id 2A24756D;\n\tThu, 14 May 2026 12:14:27 +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=\"Pz83XMmD\"; dkim-atps=neutral", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1778753667;\n\tbh=rCwiw43744sH3BaG5hg8nNfwv/awqil9qO3ao7eT9Hs=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=Pz83XMmDYRADZYhruDja+e8fmvWL8k6iMz2hfPmY918g3V6bJvGP1oou0hhjjy00N\n\t4PGOAaZBzaJvLyWf3YpZtlLtiTAbohWgGmlI0W/PQrjT27OgegWFdyTbAqysZPma/b\n\twopdtuwK4qx/nL8vhl9JcPuQaRAu8pEkMWnYcqtk=", "From": "Stefan Klug <stefan.klug@ideasonboard.com>", "To": "libcamera-devel@lists.libcamera.org", "Cc": "Stefan Klug <stefan.klug@ideasonboard.com>, Laurent Pinchart\n\t<laurent.pinchart@ideasonboard.com>, =?utf-8?b?QmFybmFiw6FzIFDFkWN6?=\n\t=?utf-8?q?e?= <barnabas.pocze@ideasonboard.com>", "Subject": "[PATCH v4 1/2] Split documentation build into separate build step", "Date": "Thu, 14 May 2026 12:14:16 +0200", "Message-ID": "<20260514101429.552173-2-stefan.klug@ideasonboard.com>", "X-Mailer": "git-send-email 2.51.0", "In-Reply-To": "<20260514101429.552173-1-stefan.klug@ideasonboard.com>", "References": "<20260514101429.552173-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>\nSigned-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>\nReviewed-by: Stefan Klug <stefan.klug@ideasonboard.com>\nReviewed-by: Barnabás Pőcze <barnabas.pocze@ideasonboard.com>\n---\n .gitlab-ci/build-libcamera-docs.sh | 42 ++++++++++++++++++++++++++++++\n gitlab-ci.yml | 33 ++++++++++++++++++++---\n 2 files changed, 71 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..26aec0813007\n--- /dev/null\n+++ b/.gitlab-ci/build-libcamera-docs.sh\n@@ -0,0 +1,42 @@\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+\tmeson compile -C build -j$BUILD_CONCURRENT_JOBS documentation\n+\n+\techo \"Installing docs\"\n+\trm -rf build/install\n+\n+\tmeson install -C build \\\n+\t\t--destdir install \\\n+\t\t--no-rebuild \\\n+\t\t--tags doc,doc-internal\n+\n+\tlocal doc_dir=(build/install/usr/local/share/doc/libcamera-*)\n+\n+\trm -rf docs\n+\tmv \"${doc_dir}/html\" docs\n+\n+\t# Move the internal and public API directories to the correct location\n+\t# in case the libcamera documentation post-install script has not run.\n+\tfor api in internal-api public-api ; do\n+\t\tif [[ -d \"${doc_dir}/${api}\" ]] ; then\n+\t\t\trm -rf \"docs/${api}\"\n+\t\t\tmv \"${doc_dir}/${api}\" docs/\n+\t\tfi\n+\tdone\n+}\n+\n+run libcamera_setup\n+run libcamera_build_docs collapsed\ndiff --git a/gitlab-ci.yml b/gitlab-ci.yml\nindex 2b376c5da1ee..278e69079c15 100644\n--- a/gitlab-ci.yml\n+++ b/gitlab-ci.yml\n@@ -209,10 +209,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 BUILD_TYPE: release\n CC: gcc-14\n@@ -301,6 +297,35 @@ 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+ - build/meson-logs/\n+ - build/build.ninja\n+ - docs\n+ variables:\n+ BUILD_TYPE: release\n+ MESON_OPTIONS: >-\n+ --auto-features disabled\n+ -D pipelines=[]\n+ -D test=false\n+ -D documentation=enabled\n+ -D doc_werror=true\n+\n # ------------------------------------------------------------------------------\n # Lint stage - Run checkstyle.py and check merge suitability\n # ------------------------------------------------------------------------------\n", "prefixes": [ "v4", "1/2" ] }