Patch Detail
Show a patch.
GET /api/patches/25165/?format=api
{ "id": 25165, "url": "https://patchwork.libcamera.org/api/patches/25165/?format=api", "web_url": "https://patchwork.libcamera.org/patch/25165/", "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": "<20251124165631.3040364-4-kieran.bingham@ideasonboard.com>", "date": "2025-11-24T16:56:31", "name": "[3/3] Documentation: contributing: Update Source references", "commit_ref": "18732fecf163bb44363111c70e2a01d1365cce77", "pull_url": null, "state": "accepted", "archived": false, "hash": "92bb50a9e58ead567ffccf38670120e6b2d956cf", "submitter": { "id": 4, "url": "https://patchwork.libcamera.org/api/people/4/?format=api", "name": "Kieran Bingham", "email": "kieran.bingham@ideasonboard.com" }, "delegate": null, "mbox": "https://patchwork.libcamera.org/patch/25165/mbox/", "series": [ { "id": 5610, "url": "https://patchwork.libcamera.org/api/series/5610/?format=api", "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=5610", "date": "2025-11-24T16:56:28", "name": "Documentation: Update contribution notes", "version": 1, "mbox": "https://patchwork.libcamera.org/series/5610/mbox/" } ], "comments": "https://patchwork.libcamera.org/api/patches/25165/comments/", "check": "pending", "checks": "https://patchwork.libcamera.org/api/patches/25165/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 A3F6AC32F1\n\tfor <parsemail@patchwork.libcamera.org>;\n\tMon, 24 Nov 2025 16:56:43 +0000 (UTC)", "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id D019B60A7B;\n\tMon, 24 Nov 2025 17:56:42 +0100 (CET)", "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 4EC6B60AA1\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tMon, 24 Nov 2025 17:56:38 +0100 (CET)", "from Monstersaurus.hippo-penny.ts.net\n\t(cpc89244-aztw30-2-0-cust6594.18-1.cable.virginm.net [86.31.185.195])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id 1833D14B0;\n\tMon, 24 Nov 2025 17:54:30 +0100 (CET)" ], "Authentication-Results": "lancelot.ideasonboard.com; dkim=pass (1024-bit key;\n\tunprotected) header.d=ideasonboard.com header.i=@ideasonboard.com\n\theader.b=\"sP3QWYtL\"; dkim-atps=neutral", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1764003270;\n\tbh=JjnHX0CrTYdBMqNPTOeoWuz3hvQWM/9J0VHSTKHn1IU=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=sP3QWYtLGTat7NktBxZXqKlrSirXn2ND8wFxr2/o5pz/ilXs88MAW18ieW76njjgq\n\tb+5H+B4tdN4p+bjxF0VG4aAbkSrtQZOSmTR5E2mbnG0degH9CHnZImgLVQ0B0OExQk\n\tHG/e2Xay2pH25qvwfhZOBrfKswCzxWelCny0Jluc=", "From": "Kieran Bingham <kieran.bingham@ideasonboard.com>", "To": "libcamera devel <libcamera-devel@lists.libcamera.org>", "Cc": "Kieran Bingham <kieran.bingham@ideasonboard.com>", "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", "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": "The libcamera project is no longer in 'early' stages of development, and\nwe do make releases.\n\nUpdate the Source Code section to reflect this reality and report on the\ncurrent expectations of release numbering schemes.\n\nFurthermore update the development mirror as hosted on Freedesktop and\ndeprecate the LinuxTV mirror, as Freedesktop also hosts our release tar\nballs and CI infrastructure.\n\nSigned-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>\n---\n Documentation/contributing.rst | 29 ++++++++++++++++++++++++++---\n 1 file changed, 26 insertions(+), 3 deletions(-)", "diff": "diff --git a/Documentation/contributing.rst b/Documentation/contributing.rst\nindex fbe34a0184e6..495bfb3196b3 100644\n--- a/Documentation/contributing.rst\n+++ b/Documentation/contributing.rst\n@@ -38,7 +38,26 @@ room:\n Source Code\n -----------\n \n-libcamera is in early stages of development, and no releases are available yet.\n+libcamera is in active development, including investigations into what a 'good'\n+API is for the implementation. We can't guarantee we have all features\n+implemented, or designed correctly yet, and we have plans to make considerable\n+changes to the API and ABI in our roadmap.\n+\n+Even so, we provide periodic 'releases' to support distributions and packaging\n+teams. To support this we are currently making releases of the 0.y.z version\n+scheme, loosely following semver.\n+\n+In the foreseeable future, the following applies:\n+\n+ 0.y.z : Active development, but with ABI breakage detection. The 0.y\n+ version will bump on an ABI/API breakage. Ongoing development will\n+ increment the .z version component. Therefore, pre 1.0 'y' is a\n+ close equivalent to a major release.\n+\n+ 1.y.z : Stable API and ABI guarantees on the Major version number.\n+ Following semantic versioning as documented at https://semver.org/\n+\n+\n The source code is available from the project's `git tree`_.\n \n .. code-block:: shell\n@@ -47,9 +66,13 @@ The source code is available from the project's `git tree`_.\n \n .. _git tree: https://git.libcamera.org/libcamera/libcamera.git/\n \n-A mirror is also hosted on `LinuxTV`_.\n+A development mirror is also hosted on `Freedesktop`_.\n \n-.. _LinuxTV: https://git.linuxtv.org/libcamera.git/\n+.. _Freedesktop: https://gitlab.freedesktop.org/camera/libcamera\n+\n+Freedesktop also provides our CI and `testing pipeline`_.\n+\n+.. _testing pipeline: https://gitlab.freedesktop.org/camera/libcamera/-/pipelines\n \n Issue Tracker\n -------------\n", "prefixes": [ "3/3" ] }