From patchwork Wed Aug 14 09:58:16 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Kieran Bingham X-Patchwork-Id: 1809 Return-Path: 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 F235E61919 for ; Wed, 14 Aug 2019 11:58:22 +0200 (CEST) Received: from localhost.localdomain (cpc89242-aztw30-2-0-cust488.18-1.cable.virginm.net [86.31.129.233]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 3DF8A592; Wed, 14 Aug 2019 11:58:22 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1565776702; bh=OMwm+a3kiTzp0H2G+OAWiQPCg7it8m+zVFmqIe1+p4Q=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=XmJ6w8PgpIS8UT6eY1B/ZHy20Ws/iG9kpYthEqdXbUyczOAcblz7zdpxB34Q5VHmL FNE0zmTm+MXJsYqL5RRsQNhPmQGLtwzwfoEj5MVf8oFMCokx8GsDEG8N/EJOSguGad gtAoOkOPEgTqE/fkgvHbFnKJrPUHBpW2KHQCb0PM= From: Kieran Bingham To: LibCamera Devel Date: Wed, 14 Aug 2019 10:58:16 +0100 Message-Id: <20190814095817.13625-3-kieran.bingham@ideasonboard.com> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20190814095817.13625-1-kieran.bingham@ideasonboard.com> References: <20190814095817.13625-1-kieran.bingham@ideasonboard.com> MIME-Version: 1.0 Subject: [libcamera-devel] [PATCH 2/3] readme: Move index page content to README X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 14 Aug 2019 09:58:23 -0000 Move the introduction content from the index.rst to the README.rst so that it can also be found quickly from the top level. Include the README.rst directly into the index.rst to continue serving it as the front page material. Signed-off-by: Kieran Bingham Reviewed-by: Laurent Pinchart Reviewed-by: Niklas Söderlund --- Documentation/index.rst | 19 ++----------------- Documentation/meson.build | 1 + README.rst | 17 +++++++++++++++++ 3 files changed, 20 insertions(+), 17 deletions(-) diff --git a/Documentation/index.rst b/Documentation/index.rst index e481f081f9a1..ec2222108e8a 100644 --- a/Documentation/index.rst +++ b/Documentation/index.rst @@ -1,20 +1,5 @@ -libcamera -========= - -Cameras are complex devices that need heavy hardware image processing -operations. Control of the processing is based on advanced algorithms that must -run on a programmable processor. This has traditionally been implemented in a -dedicated MCU in the camera, but in embedded devices algorithms have been moved -to the main CPU to save cost. Blurring the boundary between camera devices and -Linux often left the user with no other option than a vendor-specific -closed-source solution. - -To address this problem the Linux media community has very recently started -collaboration with the industry to develop a camera stack that will be -open-source-friendly while still protecting vendor core IP. libcamera was born -out of that collaboration and will offer modern camera support to Linux-based -systems, including traditional Linux distributions, ChromeOS and Android. - +.. Front page matter is defined in the project README file. +.. include:: ../README.rst .. toctree:: :maxdepth: 2 diff --git a/Documentation/meson.build b/Documentation/meson.build index b1720b05f5ee..a560d02abfa5 100644 --- a/Documentation/meson.build +++ b/Documentation/meson.build @@ -41,6 +41,7 @@ endif if sphinx.found() docs_sources = [ + '../README.rst', 'coding-style.rst', 'conf.py', 'contributing.rst', diff --git a/README.rst b/README.rst index 9a8261ac8502..0f64e076a9c0 100644 --- a/README.rst +++ b/README.rst @@ -4,6 +4,23 @@ **A complex camera support library for Linux, Android, and ChromeOS** +Cameras are complex devices that need heavy hardware image processing +operations. Control of the processing is based on advanced algorithms that must +run on a programmable processor. This has traditionally been implemented in a +dedicated MCU in the camera, but in embedded devices algorithms have been moved +to the main CPU to save cost. Blurring the boundary between camera devices and +Linux often left the user with no other option than a vendor-specific +closed-source solution. + +To address this problem the Linux media community has very recently started +collaboration with the industry to develop a camera stack that will be +open-source-friendly while still protecting vendor core IP. libcamera was born +out of that collaboration and will offer modern camera support to Linux-based +systems, including traditional Linux distributions, ChromeOS and Android. + +Getting Started +--------------- + To build and install: ::