{"id":26711,"url":"https://patchwork.libcamera.org/api/patches/26711/?format=json","web_url":"https://patchwork.libcamera.org/patch/26711/","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":"<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=json","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=json","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":"","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 ;\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 ;\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 ","To":"libcamera-devel@lists.libcamera.org","Cc":"Stefan Klug ","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":"","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---\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"]}