Patch Detail
Show a patch.
GET /api/patches/26752/?format=api
{ "id": 26752, "url": "https://patchwork.libcamera.org/api/patches/26752/?format=api", "web_url": "https://patchwork.libcamera.org/patch/26752/", "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": "<20260513212613.362445-2-laurent.pinchart@ideasonboard.com>", "date": "2026-05-13T21:26:11", "name": "[libcamera-ci,v3,1/2] Split documentation build into separate build step", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": false, "hash": "33405c29ce95792e5a7e7d6e6fb16c146cf433c2", "submitter": { "id": 2, "url": "https://patchwork.libcamera.org/api/people/2/?format=api", "name": "Laurent Pinchart", "email": "laurent.pinchart@ideasonboard.com" }, "delegate": null, "mbox": "https://patchwork.libcamera.org/patch/26752/mbox/", "series": [ { "id": 5944, "url": "https://patchwork.libcamera.org/api/series/5944/?format=api", "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=5944", "date": "2026-05-13T21:26:10", "name": "Deploy documentation to docs.libcamera.org", "version": 3, "mbox": "https://patchwork.libcamera.org/series/5944/mbox/" } ], "comments": "https://patchwork.libcamera.org/api/patches/26752/comments/", "check": "pending", "checks": "https://patchwork.libcamera.org/api/patches/26752/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 21BD8C32F7\n\tfor <parsemail@patchwork.libcamera.org>;\n\tWed, 13 May 2026 21:26:19 +0000 (UTC)", "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id B4ECC6302C;\n\tWed, 13 May 2026 23:26:17 +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 F405962010\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tWed, 13 May 2026 23:26:15 +0200 (CEST)", "from killaraus.ideasonboard.com\n\t(2001-14ba-70f3-e800--a06.rev.dnainternet.fi\n\t[IPv6:2001:14ba:70f3:e800::a06])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id 2F3546A2;\n\tWed, 13 May 2026 23:26:07 +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=\"fyc6pqBN\"; dkim-atps=neutral", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1778707567;\n\tbh=w05tNqThj/PFnem7ewoG/STHKiPlUchNedzw7ny+O7Y=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=fyc6pqBNF/oAS0DD0qopDZAsw+LrMUDRlCTLDAgk9ktw/4iNDDDmTiU1N4LC1HPCD\n\tkF3cJYksrsUcCFbfvMRlAJ0KKf39W1t6Uqg5FjVZfkqKROXPwKDkdTDbB+8p3glfR7\n\t4XHHyCiu01Ies9wvzAwWwvmDH7spIWIlIcxeFg0U=", "From": "Laurent Pinchart <laurent.pinchart@ideasonboard.com>", "To": "libcamera-devel@lists.libcamera.org", "Cc": "Stefan Klug <stefan.klug@ideasonboard.com>", "Subject": "[libcamera-ci] [PATCH v3 1/2] Split documentation build into\n\tseparate build step", "Date": "Thu, 14 May 2026 00:26:11 +0300", "Message-ID": "<20260513212613.362445-2-laurent.pinchart@ideasonboard.com>", "X-Mailer": "git-send-email 2.53.0", "In-Reply-To": "<20260513212613.362445-1-laurent.pinchart@ideasonboard.com>", "References": "<20260513212613.362445-1-laurent.pinchart@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": "From: Stefan Klug <stefan.klug@ideasonboard.com>\n\nCreate 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>\n---\nChanges since v2:\n\n- Don't run libcamera_install_pkgs\n- Only build the documentation target\n- Install to 'install' instead of '$(pwd)/install' as in other jobs\n- Move public and internal API docs to the correct location\n- Install with --no-rebuild\n- Add meson-logs/ and build.ninja to artifacts (requested by Barnabás)\n- Use release build\n- Use minimal meson options\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": [ "libcamera-ci", "v3", "1/2" ] }