From patchwork Thu Sep 3 14:51:49 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kieran Bingham X-Patchwork-Id: 28185 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 0117CC334A for ; Thu, 3 Sep 2026 14:53:17 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id 6DBFE68493; Thu, 3 Sep 2026 16:53:16 +0200 (CEST) Authentication-Results: lancelot.ideasonboard.com; dkim=pass (1024-bit key; unprotected) header.d=ideasonboard.com header.i=@ideasonboard.com header.b="L/IhO8W0"; 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 11D8A68493 for ; Thu, 3 Sep 2026 16:53:15 +0200 (CEST) Received: from ping.linuxembedded.co.uk (cpc89244-aztw30-2-0-cust6594.18-1.cable.virginm.net [86.31.185.195]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id E71EB20EA; Thu, 3 Sep 2026 16:51:42 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1788447103; bh=DUPQY1HgCTnnRazj7gp7Hj6uh+byvrqXj3YOhFx6crk=; h=From:Subject:Date:To:Cc:From; b=L/IhO8W0W+Ae/3iTROb3HmhW1WX/YrjOKYudoFrovRgY2U95g/EG80lQi2bBlrVc1 mLmaDJr9BtmjelJw/cu9dv5qVwyB391/bCiZ0806L3mtzZQskcfxNCe96DpGvpFdrN 1nIk9eAuZx5Mcu0pX2CDVATip6FMtXVMFvanPVTA= From: Kieran Bingham Subject: [PATCH 0/3] ABI: Document and support ABI and API Trailers Date: Thu, 03 Sep 2026 15:51:49 +0100 Message-Id: <20260903-kbingham-abi-trailers-v1-0-72ae051c912a@ideasonboard.com> MIME-Version: 1.0 X-B4-Tracking: v=1; b=H4sIAIWJmWoC/x3MwQpAQBCA4VfRnE2tFeFV5DDLYMLSrKTk3W2O3 +H/HwiswgGa5AHlS4LsPiJLE+hn8hOjDNFgjS1NbXJcnPhppg3JCZ5KsrIGZFtkzpAt86qC2B7 Ko9z/t+3e9wP/33WFZwAAAA== X-Change-ID: 20260903-kbingham-abi-trailers-e251b0a26388 To: libcamera-devel@lists.libcamera.org Cc: Kieran Bingham X-Mailer: b4 0.14.3 X-Developer-Signature: v=1; a=ed25519-sha256; t=1788447194; l=1197; i=kieran.bingham@ideasonboard.com; s=20260207; h=from:subject:message-id; bh=DUPQY1HgCTnnRazj7gp7Hj6uh+byvrqXj3YOhFx6crk=; b=8XgWYilYt5JH64QzJTR4tcy3BgvblwdQFZ1fcbDYETEWVmSDKTHNi4Ep+2IhpxEKRiOZGyUKl PRDbl85PAcKCdemEziAeJqKk3x+ECWwky4DrBhbKTDYX3Z+BEeBIIFS X-Developer-Key: i=kieran.bingham@ideasonboard.com; a=ed25519; pk=FVXKN7YuwHc6UtbRUeTMAmranfsQomA+vnilfglWdaY= 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" Extend the documentation to report on two new trailers... ABI: API: These trailers are accepted in the commit message in the trailer section, but they are not validated and support free text. This allows the contributor to specify the text appropriate to describe the breakage rather than restrict to something which would become less meaningful. The checkstyle tool is extended to support this, and a final patch which is not for merge offers a potential example of it's usage by taking text reported by the abi-compliance-checker tool. Signed-off-by: Kieran Bingham --- Kieran Bingham (3): utils: checkstyle: Allow free form ABI/API trailers Documentation: contributing: Add ABI/API trailer guide DNI: TESTONLY: libcamera: camera: Add an ABI break in SensorConfig Documentation/contributing.rst | 21 +++++++++++++++++++++ include/libcamera/camera.h | 2 ++ utils/checkstyle.py | 9 +++++++-- 3 files changed, 30 insertions(+), 2 deletions(-) --- base-commit: 63f9b4e5d9a9ba2ee2ebe1bfcdc0af453863c988 change-id: 20260903-kbingham-abi-trailers-e251b0a26388 Best regards,