From patchwork Mon Nov 24 16:56:29 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kieran Bingham X-Patchwork-Id: 25163 Return-Path: X-Original-To: parsemail@patchwork.libcamera.org Delivered-To: parsemail@patchwork.libcamera.org Received: from lancelot.ideasonboard.com (lancelot.ideasonboard.com [92.243.16.209]) by patchwork.libcamera.org (Postfix) with ESMTPS id 13955C32EF for ; Mon, 24 Nov 2025 16:56:41 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id BB68960AA4; Mon, 24 Nov 2025 17:56:40 +0100 (CET) Authentication-Results: lancelot.ideasonboard.com; dkim=pass (1024-bit key; unprotected) header.d=ideasonboard.com header.i=@ideasonboard.com header.b="jRrjb4Ti"; dkim-atps=neutral Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id C34C760A8B for ; Mon, 24 Nov 2025 17:56:37 +0100 (CET) Received: from Monstersaurus.hippo-penny.ts.net (cpc89244-aztw30-2-0-cust6594.18-1.cable.virginm.net [86.31.185.195]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 8FDD0741; Mon, 24 Nov 2025 17:54:29 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1764003269; bh=IQTXXbKNrt56jSmBJCTwbFffg2Kh5FY8OuG8wK7v5FI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=jRrjb4TiuCaTtcierMMitc/EbeoTW0EHLlsUjVG7k0Oec2VfxGEZxq82dIU87kWBX NOat7JMJ+E6C7bsUzpR5lSL8vhB46a4hK1BVbitKpQ80hLsw5tlIOO3I6v89ri9pbJ g7Wvg60yqMicViT1PIN2k7Pf2nEKrFEYUg1GCfvI= From: Kieran Bingham To: libcamera devel Cc: Kieran Bingham Subject: [PATCH 1/3] Documentation: contributing: Provide a reference to Matrix Date: Mon, 24 Nov 2025 16:56:29 +0000 Message-ID: <20251124165631.3040364-2-kieran.bingham@ideasonboard.com> X-Mailer: git-send-email 2.50.1 In-Reply-To: <20251124165631.3040364-1-kieran.bingham@ideasonboard.com> References: <20251124165631.3040364-1-kieran.bingham@ideasonboard.com> MIME-Version: 1.0 X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libcamera-devel-bounces@lists.libcamera.org Sender: "libcamera-devel" The libcamera IRC channel is bridged to Matrix which provides a convenient way to stay connected to the room. Provide a link to join via matrix. Signed-off-by: Kieran Bingham Reviewed-by: Umang Jain --- Documentation/contributing.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Documentation/contributing.rst b/Documentation/contributing.rst index 18b1914a9ed5..eaca20238829 100644 --- a/Documentation/contributing.rst +++ b/Documentation/contributing.rst @@ -30,6 +30,11 @@ to the public. Point your IRC client to #libcamera to say hello, or use the .. _WebChat: https://webchat.oftc.net/?channels=libcamera +The IRC channel is also bridged and accessible via `Matrix`_ in the #libcamera +room: + +.. _Matrix: https://matrix.to/#/#libcamera:matrix.org + Source Code ----------- From patchwork Mon Nov 24 16:56:30 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kieran Bingham X-Patchwork-Id: 25164 Return-Path: X-Original-To: parsemail@patchwork.libcamera.org Delivered-To: parsemail@patchwork.libcamera.org Received: from lancelot.ideasonboard.com (lancelot.ideasonboard.com [92.243.16.209]) by patchwork.libcamera.org (Postfix) with ESMTPS id 9FAF0C32EF for ; Mon, 24 Nov 2025 16:56:42 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id AAA0C60AA3; Mon, 24 Nov 2025 17:56:41 +0100 (CET) Authentication-Results: lancelot.ideasonboard.com; dkim=pass (1024-bit key; unprotected) header.d=ideasonboard.com header.i=@ideasonboard.com header.b="uP51XjVe"; dkim-atps=neutral Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 0D0EE609D8 for ; Mon, 24 Nov 2025 17:56:38 +0100 (CET) Received: from Monstersaurus.hippo-penny.ts.net (cpc89244-aztw30-2-0-cust6594.18-1.cable.virginm.net [86.31.185.195]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id CC68B89A; Mon, 24 Nov 2025 17:54:29 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1764003269; bh=066WvQq/qojl29LNq3lEpu01HABH6mzrPF2vAeWbH3k=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=uP51XjVe+laYeUmgU+rOdINLGk9Dzu9tYK9meLqn3OtQt6bP8n02pppIxYbRE/PZS /hYK52ExcAEGpBqljDu3kaHfewVqknOI3BCvGg5QRgZSH6KLVKXPRri99DPV/Froq2 XXNdHxq/zzmFDW/VWiVd1muOcY5Tap3bqJEr3y8s= From: Kieran Bingham To: libcamera devel Cc: Kieran Bingham Subject: [PATCH 2/3] Documentation: contributing: Update issue tracker Date: Mon, 24 Nov 2025 16:56:30 +0000 Message-ID: <20251124165631.3040364-3-kieran.bingham@ideasonboard.com> X-Mailer: git-send-email 2.50.1 In-Reply-To: <20251124165631.3040364-1-kieran.bingham@ideasonboard.com> References: <20251124165631.3040364-1-kieran.bingham@ideasonboard.com> MIME-Version: 1.0 X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libcamera-devel-bounces@lists.libcamera.org Sender: "libcamera-devel" The issue tracker no longer resides at bugs.libcamera.org. While this URL is still available and redirects to the new tracker, update the documentation to point to the canonical address. Signed-off-by: Kieran Bingham Reviewed-by: Umang Jain --- Documentation/contributing.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Documentation/contributing.rst b/Documentation/contributing.rst index eaca20238829..fbe34a0184e6 100644 --- a/Documentation/contributing.rst +++ b/Documentation/contributing.rst @@ -54,10 +54,10 @@ A mirror is also hosted on `LinuxTV`_. Issue Tracker ------------- -Our `issue tracker`_ tracks all bugs, issues and feature requests. All issues -are publicly visible, and you can register for an account to create new issues. +Our `issue tracker`_ also hosted at Freedesktop tracks all bugs, issues and +feature requests. -.. _issue tracker: https://bugs.libcamera.org/ +.. _issue tracker: https://gitlab.freedesktop.org/camera/libcamera/-/issues Documentation ------------- From patchwork Mon Nov 24 16:56:31 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kieran Bingham X-Patchwork-Id: 25165 Return-Path: X-Original-To: parsemail@patchwork.libcamera.org Delivered-To: parsemail@patchwork.libcamera.org Received: from lancelot.ideasonboard.com (lancelot.ideasonboard.com [92.243.16.209]) by patchwork.libcamera.org (Postfix) with ESMTPS id A3F6AC32F1 for ; Mon, 24 Nov 2025 16:56:43 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id D019B60A7B; Mon, 24 Nov 2025 17:56:42 +0100 (CET) Authentication-Results: lancelot.ideasonboard.com; dkim=pass (1024-bit key; unprotected) header.d=ideasonboard.com header.i=@ideasonboard.com header.b="sP3QWYtL"; dkim-atps=neutral Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 4EC6B60AA1 for ; Mon, 24 Nov 2025 17:56:38 +0100 (CET) Received: from Monstersaurus.hippo-penny.ts.net (cpc89244-aztw30-2-0-cust6594.18-1.cable.virginm.net [86.31.185.195]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 1833D14B0; Mon, 24 Nov 2025 17:54:30 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1764003270; bh=JjnHX0CrTYdBMqNPTOeoWuz3hvQWM/9J0VHSTKHn1IU=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=sP3QWYtLGTat7NktBxZXqKlrSirXn2ND8wFxr2/o5pz/ilXs88MAW18ieW76njjgq b+5H+B4tdN4p+bjxF0VG4aAbkSrtQZOSmTR5E2mbnG0degH9CHnZImgLVQ0B0OExQk HG/e2Xay2pH25qvwfhZOBrfKswCzxWelCny0Jluc= From: Kieran Bingham To: libcamera devel Cc: Kieran Bingham Subject: [PATCH 3/3] Documentation: contributing: Update Source references Date: Mon, 24 Nov 2025 16:56:31 +0000 Message-ID: <20251124165631.3040364-4-kieran.bingham@ideasonboard.com> X-Mailer: git-send-email 2.50.1 In-Reply-To: <20251124165631.3040364-1-kieran.bingham@ideasonboard.com> References: <20251124165631.3040364-1-kieran.bingham@ideasonboard.com> MIME-Version: 1.0 X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libcamera-devel-bounces@lists.libcamera.org Sender: "libcamera-devel" The libcamera project is no longer in 'early' stages of development, and we do make releases. Update the Source Code section to reflect this reality and report on the current expectations of release numbering schemes. Furthermore update the development mirror as hosted on Freedesktop and deprecate the LinuxTV mirror, as Freedesktop also hosts our release tar balls and CI infrastructure. Signed-off-by: Kieran Bingham Reviewed-by: Umang Jain --- Documentation/contributing.rst | 29 ++++++++++++++++++++++++++--- 1 file changed, 26 insertions(+), 3 deletions(-) diff --git a/Documentation/contributing.rst b/Documentation/contributing.rst index fbe34a0184e6..495bfb3196b3 100644 --- a/Documentation/contributing.rst +++ b/Documentation/contributing.rst @@ -38,7 +38,26 @@ room: Source Code ----------- -libcamera is in early stages of development, and no releases are available yet. +libcamera is in active development, including investigations into what a 'good' +API is for the implementation. We can't guarantee we have all features +implemented, or designed correctly yet, and we have plans to make considerable +changes to the API and ABI in our roadmap. + +Even so, we provide periodic 'releases' to support distributions and packaging +teams. To support this we are currently making releases of the 0.y.z version +scheme, loosely following semver. + +In the foreseeable future, the following applies: + + 0.y.z : Active development, but with ABI breakage detection. The 0.y + version will bump on an ABI/API breakage. Ongoing development will + increment the .z version component. Therefore, pre 1.0 'y' is a + close equivalent to a major release. + + 1.y.z : Stable API and ABI guarantees on the Major version number. + Following semantic versioning as documented at https://semver.org/ + + The source code is available from the project's `git tree`_. .. code-block:: shell @@ -47,9 +66,13 @@ The source code is available from the project's `git tree`_. .. _git tree: https://git.libcamera.org/libcamera/libcamera.git/ -A mirror is also hosted on `LinuxTV`_. +A development mirror is also hosted on `Freedesktop`_. -.. _LinuxTV: https://git.linuxtv.org/libcamera.git/ +.. _Freedesktop: https://gitlab.freedesktop.org/camera/libcamera + +Freedesktop also provides our CI and `testing pipeline`_. + +.. _testing pipeline: https://gitlab.freedesktop.org/camera/libcamera/-/pipelines Issue Tracker -------------