From patchwork Tue May 3 16:30:36 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Quentin Schulz X-Patchwork-Id: 15763 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 ECA44C0F2A for ; Tue, 3 May 2022 16:30:52 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id 5D8D46564A; Tue, 3 May 2022 18:30:52 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org; s=mail; t=1651595452; bh=yxT/rwKPnoOX7zqgQ49cmyZxJg6aeT1CJHkM6WIOh4Q=; h=To:Date:Subject:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:Cc:From; b=XduIUpMTTPAQJfi7cceWesm27YUITnTqSQmEo5LlpihPIU5xG+ZpIic3uvFQ7SSyK vxo/tr453IRGw9QUYZ+FFefbo+6Uy/qlZv2lwvEviDl8rhTuab1YSpOn0Tn6oTjuy3 SQTIcpQJcKN8qk4NgSZuGrIE8jn30NhrjP7oTrnc8zuf0Hq4iJqRkjcVS9p/H/hP/T V8mownJjIBGsj1pK2+VMQXGyLzQweyzmzPIXDWycc12aT6hDPBUkwKVoJ4bzR8oyl9 Xn2P8J1uK9MnKAJxN0KUaHduD10Sl09VEgVVzoNQqirm5luq+4uCRtk7/YVdNzVTLf VePOhs5TjdRwA== Received: from relay2-d.mail.gandi.net (relay2-d.mail.gandi.net [217.70.183.194]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 6D5B365645 for ; Tue, 3 May 2022 18:30:50 +0200 (CEST) Received: (Authenticated sender: foss@0leil.net) by mail.gandi.net (Postfix) with ESMTPSA id BFD6540006; Tue, 3 May 2022 16:30:49 +0000 (UTC) To: Date: Tue, 3 May 2022 18:30:36 +0200 Message-Id: <20220503163038.1174462-1-foss+libcamera@0leil.net> X-Mailer: git-send-email 2.35.1 MIME-Version: 1.0 Subject: [libcamera-devel] =?utf-8?q?=5BPATCH_1/3=5D_Documentation=3A_repl?= =?utf-8?b?YWNlIOKAmSBieSAn?= 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: , X-Patchwork-Original-From: Quentin Schulz via libcamera-devel From: Quentin Schulz Reply-To: Quentin Schulz Cc: libcamera-devel@lists.libcamera.org Errors-To: libcamera-devel-bounces@lists.libcamera.org Sender: "libcamera-devel" From: Quentin Schulz Replace U+2019 unicode character (’; right single quotation mark) by U+27 unicode character ('; apostrophe) as it is what most people are used to in sentences. While Sphinx seems to be rendering both the same way, it makes it easier for searching in rST files directly. Cc: Quentin Schulz Signed-off-by: Quentin Schulz Reviewed-by: Jacopo Mondi Reviewed-by: Laurent Pinchart --- Documentation/guides/application-developer.rst | 10 +++++----- Documentation/guides/introduction.rst | 2 +- Documentation/guides/pipeline-handler.rst | 4 ++-- 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/Documentation/guides/application-developer.rst b/Documentation/guides/application-developer.rst index cafb24b1..07cc7273 100644 --- a/Documentation/guides/application-developer.rst +++ b/Documentation/guides/application-developer.rst @@ -47,7 +47,7 @@ runs for the life of the application. When the Camera Manager starts, it enumerates all the cameras detected in the system. Behind the scenes, libcamera abstracts and manages the complex pipelines that kernel drivers expose through the `Linux Media Controller`_ and `Video for Linux`_ (V4L2) APIs, meaning that -an application doesn’t need to handle device or driver specific details. +an application doesn't need to handle device or driver specific details. .. _CameraManager: http://libcamera.org/api-html/classlibcamera_1_1CameraManager.html .. _Linux Media Controller: https://www.kernel.org/doc/html/latest/media/uapi/mediactl/media-controller-intro.html @@ -236,8 +236,8 @@ applied to the system. camera->configure(config.get()); -If an application doesn’t first validate the configuration before calling -``Camera::configure()``, there’s a chance that calling the function can fail, if +If an application doesn't first validate the configuration before calling +``Camera::configure()``, there's a chance that calling the function can fail, if the given configuration would have to be adjusted. Allocate FrameBuffers @@ -259,7 +259,7 @@ of suitable buffers, for instance, when no other device is involved, or on Linux platforms that lack a centralized allocator. The ``FrameBufferAllocator`` class provides a buffer allocator an application can use in these situations. -An application doesn’t have to use the default ``FrameBufferAllocator`` that +An application doesn't have to use the default ``FrameBufferAllocator`` that libcamera provides. It can instead allocate memory manually and pass the buffers in ``Request``\s (read more about ``Request`` in `the frame capture section <#frame-capture>`_ of this guide). The example in this guide covers using the @@ -392,7 +392,7 @@ Create the ``requestComplete`` function by matching the slot signature: Request completion events can be emitted for requests which have been canceled, for example, by unexpected application shutdown. To avoid an application -processing invalid image data, it’s worth checking that the request has +processing invalid image data, it's worth checking that the request has completed successfully. The list of request completion statuses is available in the `Request::Status`_ class enum documentation. diff --git a/Documentation/guides/introduction.rst b/Documentation/guides/introduction.rst index a4671a07..d080679f 100644 --- a/Documentation/guides/introduction.rst +++ b/Documentation/guides/introduction.rst @@ -150,7 +150,7 @@ Architecture ------------ While offering a unified API towards upper layers, and presenting itself as a -single library, libcamera isn’t monolithic. It exposes multiple components +single library, libcamera isn't monolithic. It exposes multiple components through its public API and is built around a set of separate helpers internally. Hardware abstractions are handled through the use of device-specific components where required and dynamically loadable plugins are used to separate image diff --git a/Documentation/guides/pipeline-handler.rst b/Documentation/guides/pipeline-handler.rst index c0fb7147..a7208f57 100644 --- a/Documentation/guides/pipeline-handler.rst +++ b/Documentation/guides/pipeline-handler.rst @@ -1036,8 +1036,8 @@ values. Handling of device controls is again performed using the libcamera .. _Controls Framework: http://libcamera.org/api-html/controls_8h.html This section is particularly specific to Vivid as it sets the initial values of -controls to match `Vivid Controls`_ defined by the kernel driver. You won’t need -any of the code below for your pipeline handler, but it’s included as an example +controls to match `Vivid Controls`_ defined by the kernel driver. You won't need +any of the code below for your pipeline handler, but it's included as an example of how to implement functionality your pipeline handler might need. .. _Vivid Controls: https://www.kernel.org/doc/html/latest/admin-guide/media/vivid.html#controls