[{"id":37445,"web_url":"https://patchwork.libcamera.org/comment/37445/","msgid":"<34jrsplyvnnt5lm5ror2remegl7wzc5oppkdzfxigdfxczg45p@uhty22b55awq>","date":"2025-12-23T11:08:37","subject":"Re: [PATCH 2/2] Documentation: Link to glossary terms from the\n\tintroduction page","submitter":{"id":143,"url":"https://patchwork.libcamera.org/api/people/143/","name":"Jacopo Mondi","email":"jacopo.mondi@ideasonboard.com"},"content":"Hi Walter\n\nOn Fri, Dec 19, 2025 at 09:06:31PM +0200, Walter Werner Schneider wrote:\n\nJust a note, we require a commit message for every commit. Something\nsimple like:\n\nNow that a glossary is available, refer to the terms there defined in\nthe introduction documentation.\n\nwould do.\n\n> Signed-off-by: Walter Werner Schneider \n> ---\n> Documentation/introduction.rst | 10 +++++-----\n> 1 file changed, 5 insertions(+), 5 deletions(-)\n>\n> diff --git a/Documentation/introduction.rst b/Documentation/introduction.rst\n> index 07b3a27ed007b7ed700774107f2d7e6059c6fb21..190b4229da86d66bbf61e73477f2610dc661553b 100644\n> --- a/Documentation/introduction.rst\n> +++ b/Documentation/introduction.rst\n> @@ -29,8 +29,8 @@ interface to interact and control media devices.\n> .. _Video for Linux 2: https://www.linuxtv.org/downloads/v4l-dvb-apis-new/userspace-api/v4l/v4l2.html\n> .. _Media Controller: https://www.linuxtv.org/downloads/v4l-dvb-apis-new/userspace-api/mediactl/media-controller.html\n>\n> -Included in this subsystem are drivers for camera sensors, CSI2 (Camera\n> -Serial Interface) receivers, and ISPs (Image Signal Processors).\n> +Included in this subsystem are camera sensors, :term:`CSI-2` receivers, and\n> +:term:`ISP` drivers.\n>\n> The usage of these drivers to provide a functioning camera stack is a\n> responsibility that lies in userspace, and is commonly implemented separately\n> @@ -67,7 +67,7 @@ The library handles the rest for you. These documentary pages give more\n> information on the internal workings of libcamera (and the kernel camera stack\n> that lies behind it) as well as guidance on using libcamera in an application or\n> extending the library with support for your hardware (through the pipeline\n> -handler and IPA module writer's guides).\n> +handler and :term:`IPA` module writer's guides).\n>\n> How should I use it?\n> ====================\n> @@ -153,8 +153,8 @@ The camera stack comprises four software layers. From bottom to top:\n> * The libcamera adaptation is an umbrella term designating the\n> components that interface to libcamera in other frameworks.\n> Notable examples are a V4L2 compatibility layer, a gstreamer\n> - libcamera element, and an Android camera HAL implementation based\n> - on libcamera.\n> + libcamera element, and an Android camera :term:`HAL` implementation\n> + based on libcamera.\n>\n> Those components can live in the libcamera project source code\n> in separate repositories, or move to their respective project's\n>\n> --\n> 2.51.1\n>","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 C33E7BD160\n\tfor ;\n\tTue, 23 Dec 2025 11:08:42 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 13CB061FA6;\n\tTue, 23 Dec 2025 12:08: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 99BC961F61\n\tfor ;\n\tTue, 23 Dec 2025 12:08:40 +0100 (CET)","from ideasonboard.com (net-93-65-100-155.cust.vodafonedsl.it\n\t[93.65.100.155])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id BC563557;\n\tTue, 23 Dec 2025 12:08:29 +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=\"Dfpis+Zh\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1766488109;\n\tbh=IjaWftRpF4d+Q87yIaM0Pt7PMF/9KeSSk/h9G6fWeYw=;\n\th=Date:From:To:Cc:Subject:References:In-Reply-To:From;\n\tb=Dfpis+Zh3Npcx91H3lmK8cr62JQH1mnWGNO2+LfNncsKJJBF3H33TKTTIAMwyhg+P\n\t1SJ+S9bQnpSAiKC3oqZL1IaWFP2lMwfYv/Yaf8WPT9BJC6+V/NB3wym03SpuVRbVRd\n\tzwkobPFy4nOyneA33+sox55OHy20yqaMJaBRpzN8=","Date":"Tue, 23 Dec 2025 12:08:37 +0100","From":"Jacopo Mondi ","To":"Walter Werner Schneider ","Cc":"libcamera-devel@lists.libcamera.org","Subject":"Re: [PATCH 2/2] Documentation: Link to glossary terms from the\n\tintroduction page","Message-ID":"<34jrsplyvnnt5lm5ror2remegl7wzc5oppkdzfxigdfxczg45p@uhty22b55awq>","References":"<20251219-glossary-page-v1-0-971ba0ab4b2f@schnwalter.eu>\n\t<20251219-glossary-page-v1-2-971ba0ab4b2f@schnwalter.eu>","MIME-Version":"1.0","Content-Type":"text/plain; charset=utf-8","Content-Disposition":"inline","In-Reply-To":"<20251219-glossary-page-v1-2-971ba0ab4b2f@schnwalter.eu>","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\" "}}]