{"id":26641,"url":"https://patchwork.libcamera.org/api/patches/26641/?format=json","web_url":"https://patchwork.libcamera.org/patch/26641/","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":"<20260506155442.1566744-2-stefan.klug@ideasonboard.com>","date":"2026-05-06T15:54:11","name":"[v1,1/2] Split documentation build into separate build step","commit_ref":null,"pull_url":null,"state":"superseded","archived":false,"hash":"452c817a5f029373711f11fda4d8fe0303d4f79c","submitter":{"id":184,"url":"https://patchwork.libcamera.org/api/people/184/?format=json","name":"Stefan Klug","email":"stefan.klug@ideasonboard.com"},"delegate":null,"mbox":"https://patchwork.libcamera.org/patch/26641/mbox/","series":[{"id":5910,"url":"https://patchwork.libcamera.org/api/series/5910/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=5910","date":"2026-05-06T15:54:10","name":"Deploy documentation to docs.libcamera.org","version":1,"mbox":"https://patchwork.libcamera.org/series/5910/mbox/"}],"comments":"https://patchwork.libcamera.org/api/patches/26641/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/26641/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 4EF02C32F6\n\tfor ;\n\tWed, 6 May 2026 15:55:33 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id D349B63021;\n\tWed, 6 May 2026 17:55:32 +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 D7F6262FE8\n\tfor ;\n\tWed, 6 May 2026 17:55:31 +0200 (CEST)","from ideasonboard.com (unknown\n\t[IPv6:2a00:6020:448c:6c00:f191:8aa5:3091:a04d])\n\tby perceval.ideasonboard.com (Postfix) with UTF8SMTPSA id 6AC90C21;\n\tWed, 6 May 2026 17:55:28 +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=\"anyQplHs\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1778082928;\n\tbh=juu51sQ7yb7m/tfnqcplXBc/jiwXhY8IGpK6X7gBvfU=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=anyQplHsqnVZV7O/QMVAxNnw6yaU1zBNo7VtPUvBOg1oROSr6WUPjhXWZMbianXUF\n\tKFddbLrcBh6A9+RuiCOeRWmeiOX71BEyylY+yLvvhpiMAh0YXLFGEZAH1BkFWwhHqE\n\teLDjw3bpOOd1uj/cFkWjYrMgGP6K/mxI4W1mNLVU=","From":"Stefan Klug ","To":"libcamera-devel@lists.libcamera.org","Cc":"Stefan Klug ","Subject":"[PATCH v1 1/2] Split documentation build into separate build step","Date":"Wed, 6 May 2026 17:54:11 +0200","Message-ID":"<20260506155442.1566744-2-stefan.klug@ideasonboard.com>","X-Mailer":"git-send-email 2.51.0","In-Reply-To":"<20260506155442.1566744-1-stefan.klug@ideasonboard.com>","References":"<20260506155442.1566744-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":"","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":"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 \n---\n .gitlab-ci/build-libcamera-docs.sh | 28 ++++++++++++++++++++++++++++\n gitlab-ci.yml | 29 +++++++++++++++++++++++++----\n 2 files changed, 53 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..a2ee7ba839d8\n--- /dev/null\n+++ b/.gitlab-ci/build-libcamera-docs.sh\n@@ -0,0 +1,28 @@\n+#!/bin/bash\n+\n+# SPDX-License-Identifier: GPL-2.0-or-later\n+# SPDX-FileCopyrightText: © 2023 Laurent Pinchart \n+#\n+# Build libcamera\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\"\n+\n+\tmeson compile -C build -j$BUILD_CONCURRENT_JOBS documentation\n+\t(\n+\t\tcd build\n+\t\trm -rf docs\n+\t\tmv Documentation/html/ docs\n+\t\trm -rf docs/{internal,public}-api\n+\t\tmv Documentation/{internal,public}-api docs/\n+\t)\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..468f5769eb87 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,31 @@ 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/docs\n+ variables:\n+ BUILD_TYPE: release\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":["v1","1/2"]}