[{"id":2401,"web_url":"https://patchwork.libcamera.org/comment/2401/","msgid":"<20190814112935.GF5009@pendragon.ideasonboard.com>","date":"2019-08-14T11:29:35","subject":"Re: [libcamera-devel] [PATCH 2/3] readme: Move index page content\n\tto README","submitter":{"id":2,"url":"https://patchwork.libcamera.org/api/people/2/","name":"Laurent Pinchart","email":"laurent.pinchart@ideasonboard.com"},"content":"Hi Kieran,\n\nThank you for the patch.\n\nOn Wed, Aug 14, 2019 at 10:58:16AM +0100, Kieran Bingham wrote:\n> Move the introduction content from the index.rst to the README.rst so\n> that it can also be found quickly from the top level.\n> \n> Include the README.rst directly into the index.rst to continue serving\n> it as the front page material.\n> \n> Signed-off-by: Kieran Bingham \n> ---\n> Documentation/index.rst | 19 ++-----------------\n> Documentation/meson.build | 1 +\n> README.rst | 17 +++++++++++++++++\n> 3 files changed, 20 insertions(+), 17 deletions(-)\n> \n> diff --git a/Documentation/index.rst b/Documentation/index.rst\n> index e481f081f9a1..ec2222108e8a 100644\n> --- a/Documentation/index.rst\n> +++ b/Documentation/index.rst\n> @@ -1,20 +1,5 @@\n> -libcamera\n> -=========\n> -\n> -Cameras are complex devices that need heavy hardware image processing\n> -operations. Control of the processing is based on advanced algorithms that must\n> -run on a programmable processor. This has traditionally been implemented in a\n> -dedicated MCU in the camera, but in embedded devices algorithms have been moved\n> -to the main CPU to save cost. Blurring the boundary between camera devices and\n> -Linux often left the user with no other option than a vendor-specific\n> -closed-source solution.\n> -\n> -To address this problem the Linux media community has very recently started\n> -collaboration with the industry to develop a camera stack that will be\n> -open-source-friendly while still protecting vendor core IP. libcamera was born\n> -out of that collaboration and will offer modern camera support to Linux-based\n> -systems, including traditional Linux distributions, ChromeOS and Android.\n> -\n> +.. Front page matter is defined in the project README file.\n> +.. include:: ../README.rst\n> \n> .. toctree::\n> :maxdepth: 2\n> diff --git a/Documentation/meson.build b/Documentation/meson.build\n> index b1720b05f5ee..a560d02abfa5 100644\n> --- a/Documentation/meson.build\n> +++ b/Documentation/meson.build\n> @@ -41,6 +41,7 @@ endif\n> \n> if sphinx.found()\n> docs_sources = [\n> + '../README.rst',\n> 'coding-style.rst',\n> 'conf.py',\n> 'contributing.rst',\n> diff --git a/README.rst b/README.rst\n> index 9a8261ac8502..0f64e076a9c0 100644\n> --- a/README.rst\n> +++ b/README.rst\n> @@ -4,6 +4,23 @@\n> \n> **A complex camera support library for Linux, Android, and ChromeOS**\n\nThis makes the title smaller than the Getting Started and Dependencies\nsection below. Should we make it the same size ?\n\nApart from that,\n\nReviewed-by: Laurent Pinchart \n\n> +Cameras are complex devices that need heavy hardware image processing\n> +operations. Control of the processing is based on advanced algorithms that must\n> +run on a programmable processor. This has traditionally been implemented in a\n> +dedicated MCU in the camera, but in embedded devices algorithms have been moved\n> +to the main CPU to save cost. Blurring the boundary between camera devices and\n> +Linux often left the user with no other option than a vendor-specific\n> +closed-source solution.\n> +\n> +To address this problem the Linux media community has very recently started\n> +collaboration with the industry to develop a camera stack that will be\n> +open-source-friendly while still protecting vendor core IP. libcamera was born\n> +out of that collaboration and will offer modern camera support to Linux-based\n> +systems, including traditional Linux distributions, ChromeOS and Android.\n> +\n> +Getting Started\n> +---------------\n> +\n> To build and install:\n> \n> ::","headers":{"Return-Path":"","Received":["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 03C7460E2E\n\tfor ;\n\tWed, 14 Aug 2019 13:29:39 +0200 (CEST)","from pendragon.ideasonboard.com\n\t(dfj612yhrgyx302h3jwwy-3.rev.dnainternet.fi\n\t[IPv6:2001:14ba:21f5:5b00:ce28:277f:58d7:3ca4])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id 8D5862B2;\n\tWed, 14 Aug 2019 13:29:38 +0200 (CEST)"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1565782178;\n\tbh=X/aSeHPnTqVTP1SF4j2LhZHerVydOdOqqAsMyzCuhGM=;\n\th=Date:From:To:Cc:Subject:References:In-Reply-To:From;\n\tb=t7HGGyvm/o7kbmRFyQ74vS2bwDI2y+J6r/tCvIzerWaWGsKuP2WUR43cqIqYRiOfo\n\tA3xXGnU7dV1qc7A0hgWZxUVWlvg+DOXgIX9a67eBaNd4863qSLQZBnZGIvFgtCa9Z2\n\t/eAtcGQuN9L57+eWxx6pBnBEtqUGVBkdza64XfZ8=","Date":"Wed, 14 Aug 2019 14:29:35 +0300","From":"Laurent Pinchart ","To":"Kieran Bingham ","Cc":"LibCamera Devel ","Message-ID":"<20190814112935.GF5009@pendragon.ideasonboard.com>","References":"<20190814095817.13625-1-kieran.bingham@ideasonboard.com>\n\t<20190814095817.13625-3-kieran.bingham@ideasonboard.com>","MIME-Version":"1.0","Content-Type":"text/plain; charset=utf-8","Content-Disposition":"inline","In-Reply-To":"<20190814095817.13625-3-kieran.bingham@ideasonboard.com>","User-Agent":"Mutt/1.10.1 (2018-07-13)","Subject":"Re: [libcamera-devel] [PATCH 2/3] readme: Move index page content\n\tto README","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.23","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","X-List-Received-Date":"Wed, 14 Aug 2019 11:29:39 -0000"}},{"id":2402,"web_url":"https://patchwork.libcamera.org/comment/2402/","msgid":"<50f0ece5-a469-915c-04ed-2b6179d82a4c@ideasonboard.com>","date":"2019-08-14T11:46:15","subject":"Re: [libcamera-devel] [PATCH 2/3] readme: Move index page content\n\tto README","submitter":{"id":4,"url":"https://patchwork.libcamera.org/api/people/4/","name":"Kieran Bingham","email":"kieran.bingham@ideasonboard.com"},"content":"Hi Laurent,\n\nOn 14/08/2019 12:29, Laurent Pinchart wrote:\n> Hi Kieran,\n> \n> Thank you for the patch.\n> \n> On Wed, Aug 14, 2019 at 10:58:16AM +0100, Kieran Bingham wrote:\n>> Move the introduction content from the index.rst to the README.rst so\n>> that it can also be found quickly from the top level.\n>>\n>> Include the README.rst directly into the index.rst to continue serving\n>> it as the front page material.\n>>\n>> Signed-off-by: Kieran Bingham \n>> ---\n>> Documentation/index.rst | 19 ++-----------------\n>> Documentation/meson.build | 1 +\n>> README.rst | 17 +++++++++++++++++\n>> 3 files changed, 20 insertions(+), 17 deletions(-)\n>>\n>> diff --git a/Documentation/index.rst b/Documentation/index.rst\n>> index e481f081f9a1..ec2222108e8a 100644\n>> --- a/Documentation/index.rst\n>> +++ b/Documentation/index.rst\n>> @@ -1,20 +1,5 @@\n>> -libcamera\n>> -=========\n>> -\n>> -Cameras are complex devices that need heavy hardware image processing\n>> -operations. Control of the processing is based on advanced algorithms that must\n>> -run on a programmable processor. This has traditionally been implemented in a\n>> -dedicated MCU in the camera, but in embedded devices algorithms have been moved\n>> -to the main CPU to save cost. Blurring the boundary between camera devices and\n>> -Linux often left the user with no other option than a vendor-specific\n>> -closed-source solution.\n>> -\n>> -To address this problem the Linux media community has very recently started\n>> -collaboration with the industry to develop a camera stack that will be\n>> -open-source-friendly while still protecting vendor core IP. libcamera was born\n>> -out of that collaboration and will offer modern camera support to Linux-based\n>> -systems, including traditional Linux distributions, ChromeOS and Android.\n>> -\n>> +.. Front page matter is defined in the project README file.\n>> +.. include:: ../README.rst\n>> \n>> .. toctree::\n>> :maxdepth: 2\n>> diff --git a/Documentation/meson.build b/Documentation/meson.build\n>> index b1720b05f5ee..a560d02abfa5 100644\n>> --- a/Documentation/meson.build\n>> +++ b/Documentation/meson.build\n>> @@ -41,6 +41,7 @@ endif\n>> \n>> if sphinx.found()\n>> docs_sources = [\n>> + '../README.rst',\n>> 'coding-style.rst',\n>> 'conf.py',\n>> 'contributing.rst',\n>> diff --git a/README.rst b/README.rst\n>> index 9a8261ac8502..0f64e076a9c0 100644\n>> --- a/README.rst\n>> +++ b/README.rst\n>> @@ -4,6 +4,23 @@\n>> \n>> **A complex camera support library for Linux, Android, and ChromeOS**\n> \n> This makes the title smaller than the Getting Started and Dependencies\n> section below. Should we make it the same size ?\n\nI wanted to mark this as a subtitle, but setting it so affects the\ntoctree box, and produces:\n\n* libcamera:\n ** A complex camera support library for Linux, Android, and ChromeOS\n *** Getting started.\n\nand I don't think that subtitle should be in the hierarchy of the ToC.\n\nThe enlarged text also ended up wrapped, and didn't look as\naesthetically pleasing ... so I felt this was the best rendering.\n\nI see it more of the tagline or brief than a title so I'm not too\nworried about it being smaller than the section headers.\n\nWould you prefer it was promoted to a subtitle?\n\n\n> Apart from that,\n> \n> Reviewed-by: Laurent Pinchart \n> \n>> +Cameras are complex devices that need heavy hardware image processing\n>> +operations. Control of the processing is based on advanced algorithms that must\n>> +run on a programmable processor. This has traditionally been implemented in a\n>> +dedicated MCU in the camera, but in embedded devices algorithms have been moved\n>> +to the main CPU to save cost. Blurring the boundary between camera devices and\n>> +Linux often left the user with no other option than a vendor-specific\n>> +closed-source solution.\n>> +\n>> +To address this problem the Linux media community has very recently started\n>> +collaboration with the industry to develop a camera stack that will be\n>> +open-source-friendly while still protecting vendor core IP. libcamera was born\n>> +out of that collaboration and will offer modern camera support to Linux-based\n>> +systems, including traditional Linux distributions, ChromeOS and Android.\n>> +\n>> +Getting Started\n>> +---------------\n>> +\n>> To build and install:\n>> \n>> ::","headers":{"Return-Path":"","Received":["from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 9A31F60E2E\n\tfor ;\n\tWed, 14 Aug 2019 13:46:18 +0200 (CEST)","from [192.168.0.20]\n\t(cpc89242-aztw30-2-0-cust488.18-1.cable.virginm.net [86.31.129.233])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id C63F633C;\n\tWed, 14 Aug 2019 13:46:17 +0200 (CEST)"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1565783178;\n\tbh=WT40zu8QY/NISzBjULY34eKJw1lwvxI/84OS581DdYw=;\n\th=Reply-To:Subject:To:Cc:References:From:Date:In-Reply-To:From;\n\tb=T3uwQH8Bq0jusNdcxuafmtYgrkr7bUV6EzPwv197CA3Dp/1Xm7vxT/0nRJLm58GFq\n\tjpnEF8Qvf1BvH1qQeU30Y6SuQMvlTMBjO1iijGvQSjaQ1e/ISrEm2tJoZcNLkJvUBO\n\tBKoVKiahSAVgMDlSuCyqBAt4JEtpEZ/6U18X0wI0=","Reply-To":"kieran.bingham@ideasonboard.com","To":"Laurent Pinchart ","Cc":"LibCamera Devel ","References":"<20190814095817.13625-1-kieran.bingham@ideasonboard.com>\n\t<20190814095817.13625-3-kieran.bingham@ideasonboard.com>\n\t<20190814112935.GF5009@pendragon.ideasonboard.com>","From":"Kieran Bingham ","Openpgp":"preference=signencrypt","Autocrypt":"addr=kieran.bingham@ideasonboard.com; keydata=\n\t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\n\tsbsRB8KNNvVXBOVNwko86rQqF9drZuw=","Organization":"Ideas on Board","Message-ID":"<50f0ece5-a469-915c-04ed-2b6179d82a4c@ideasonboard.com>","Date":"Wed, 14 Aug 2019 12:46:15 +0100","User-Agent":"Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101\n\tThunderbird/60.8.0","MIME-Version":"1.0","In-Reply-To":"<20190814112935.GF5009@pendragon.ideasonboard.com>","Content-Type":"text/plain; charset=utf-8","Content-Language":"en-GB","Content-Transfer-Encoding":"8bit","Subject":"Re: [libcamera-devel] [PATCH 2/3] readme: Move index page content\n\tto README","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.23","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","X-List-Received-Date":"Wed, 14 Aug 2019 11:46:18 -0000"}},{"id":2403,"web_url":"https://patchwork.libcamera.org/comment/2403/","msgid":"<20190814114849.GI5009@pendragon.ideasonboard.com>","date":"2019-08-14T11:48:49","subject":"Re: [libcamera-devel] [PATCH 2/3] readme: Move index page content\n\tto README","submitter":{"id":2,"url":"https://patchwork.libcamera.org/api/people/2/","name":"Laurent Pinchart","email":"laurent.pinchart@ideasonboard.com"},"content":"Hi Kieran,\n\nOn Wed, Aug 14, 2019 at 12:46:15PM +0100, Kieran Bingham wrote:\n> On 14/08/2019 12:29, Laurent Pinchart wrote:\n> > On Wed, Aug 14, 2019 at 10:58:16AM +0100, Kieran Bingham wrote:\n> >> Move the introduction content from the index.rst to the README.rst so\n> >> that it can also be found quickly from the top level.\n> >>\n> >> Include the README.rst directly into the index.rst to continue serving\n> >> it as the front page material.\n> >>\n> >> Signed-off-by: Kieran Bingham \n> >> ---\n> >> Documentation/index.rst | 19 ++-----------------\n> >> Documentation/meson.build | 1 +\n> >> README.rst | 17 +++++++++++++++++\n> >> 3 files changed, 20 insertions(+), 17 deletions(-)\n> >>\n> >> diff --git a/Documentation/index.rst b/Documentation/index.rst\n> >> index e481f081f9a1..ec2222108e8a 100644\n> >> --- a/Documentation/index.rst\n> >> +++ b/Documentation/index.rst\n> >> @@ -1,20 +1,5 @@\n> >> -libcamera\n> >> -=========\n> >> -\n> >> -Cameras are complex devices that need heavy hardware image processing\n> >> -operations. Control of the processing is based on advanced algorithms that must\n> >> -run on a programmable processor. This has traditionally been implemented in a\n> >> -dedicated MCU in the camera, but in embedded devices algorithms have been moved\n> >> -to the main CPU to save cost. Blurring the boundary between camera devices and\n> >> -Linux often left the user with no other option than a vendor-specific\n> >> -closed-source solution.\n> >> -\n> >> -To address this problem the Linux media community has very recently started\n> >> -collaboration with the industry to develop a camera stack that will be\n> >> -open-source-friendly while still protecting vendor core IP. libcamera was born\n> >> -out of that collaboration and will offer modern camera support to Linux-based\n> >> -systems, including traditional Linux distributions, ChromeOS and Android.\n> >> -\n> >> +.. Front page matter is defined in the project README file.\n> >> +.. include:: ../README.rst\n> >> \n> >> .. toctree::\n> >> :maxdepth: 2\n> >> diff --git a/Documentation/meson.build b/Documentation/meson.build\n> >> index b1720b05f5ee..a560d02abfa5 100644\n> >> --- a/Documentation/meson.build\n> >> +++ b/Documentation/meson.build\n> >> @@ -41,6 +41,7 @@ endif\n> >> \n> >> if sphinx.found()\n> >> docs_sources = [\n> >> + '../README.rst',\n> >> 'coding-style.rst',\n> >> 'conf.py',\n> >> 'contributing.rst',\n> >> diff --git a/README.rst b/README.rst\n> >> index 9a8261ac8502..0f64e076a9c0 100644\n> >> --- a/README.rst\n> >> +++ b/README.rst\n> >> @@ -4,6 +4,23 @@\n> >> \n> >> **A complex camera support library for Linux, Android, and ChromeOS**\n> > \n> > This makes the title smaller than the Getting Started and Dependencies\n> > section below. Should we make it the same size ?\n> \n> I wanted to mark this as a subtitle, but setting it so affects the\n> toctree box, and produces:\n> \n> * libcamera:\n> ** A complex camera support library for Linux, Android, and ChromeOS\n> *** Getting started.\n> \n> and I don't think that subtitle should be in the hierarchy of the ToC.\n> \n> The enlarged text also ended up wrapped, and didn't look as\n> aesthetically pleasing ... so I felt this was the best rendering.\n> \n> I see it more of the tagline or brief than a title so I'm not too\n> worried about it being smaller than the section headers.\n> \n> Would you prefer it was promoted to a subtitle?\n\nI'll let you pick the option that you think is best.\n\n> > Apart from that,\n> > \n> > Reviewed-by: Laurent Pinchart \n> > \n> >> +Cameras are complex devices that need heavy hardware image processing\n> >> +operations. Control of the processing is based on advanced algorithms that must\n> >> +run on a programmable processor. This has traditionally been implemented in a\n> >> +dedicated MCU in the camera, but in embedded devices algorithms have been moved\n> >> +to the main CPU to save cost. Blurring the boundary between camera devices and\n> >> +Linux often left the user with no other option than a vendor-specific\n> >> +closed-source solution.\n> >> +\n> >> +To address this problem the Linux media community has very recently started\n> >> +collaboration with the industry to develop a camera stack that will be\n> >> +open-source-friendly while still protecting vendor core IP. libcamera was born\n> >> +out of that collaboration and will offer modern camera support to Linux-based\n> >> +systems, including traditional Linux distributions, ChromeOS and Android.\n> >> +\n> >> +Getting Started\n> >> +---------------\n> >> +\n> >> To build and install:\n> >> \n> >> ::","headers":{"Return-Path":"","Received":["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 1EEF560E2E\n\tfor ;\n\tWed, 14 Aug 2019 13:48:53 +0200 (CEST)","from pendragon.ideasonboard.com\n\t(dfj612yhrgyx302h3jwwy-3.rev.dnainternet.fi\n\t[IPv6:2001:14ba:21f5:5b00:ce28:277f:58d7:3ca4])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id 801122B2;\n\tWed, 14 Aug 2019 13:48:52 +0200 (CEST)"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1565783332;\n\tbh=bOVz/JPiPKbcWtDU+4uCkIJ8W+u0QD/l57ZhaA2Aimc=;\n\th=Date:From:To:Cc:Subject:References:In-Reply-To:From;\n\tb=IZHO5u4qQ+Z67NcFUv+HZu8EU/79MTP/auVCvVt+4tHLSu184C9wXtaPgNSv9lo0g\n\ttVLWUVjtFcVtqYaVDyw3AcBu17583umDkT1EP+RBX6sxheKde/1q3PBwRDcbQPHTpj\n\tPmikOABrmTbnxwapzNDATySNSOwrekn4I7r71UM0=","Date":"Wed, 14 Aug 2019 14:48:49 +0300","From":"Laurent Pinchart ","To":"Kieran Bingham ","Cc":"LibCamera Devel ","Message-ID":"<20190814114849.GI5009@pendragon.ideasonboard.com>","References":"<20190814095817.13625-1-kieran.bingham@ideasonboard.com>\n\t<20190814095817.13625-3-kieran.bingham@ideasonboard.com>\n\t<20190814112935.GF5009@pendragon.ideasonboard.com>\n\t<50f0ece5-a469-915c-04ed-2b6179d82a4c@ideasonboard.com>","MIME-Version":"1.0","Content-Type":"text/plain; charset=utf-8","Content-Disposition":"inline","In-Reply-To":"<50f0ece5-a469-915c-04ed-2b6179d82a4c@ideasonboard.com>","User-Agent":"Mutt/1.10.1 (2018-07-13)","Subject":"Re: [libcamera-devel] [PATCH 2/3] readme: Move index page content\n\tto README","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.23","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","X-List-Received-Date":"Wed, 14 Aug 2019 11:48:53 -0000"}},{"id":2425,"web_url":"https://patchwork.libcamera.org/comment/2425/","msgid":"<20190817135640.GC16603@wyvern>","date":"2019-08-17T13:56:40","subject":"Re: [libcamera-devel] [PATCH 2/3] readme: Move index page content\n\tto README","submitter":{"id":5,"url":"https://patchwork.libcamera.org/api/people/5/","name":"Niklas Söderlund","email":"niklas.soderlund@ragnatech.se"},"content":"Hi Kieran,\n\nThanks for your work.\n\nOn 2019-08-14 10:58:16 +0100, Kieran Bingham wrote:\n> Move the introduction content from the index.rst to the README.rst so\n> that it can also be found quickly from the top level.\n> \n> Include the README.rst directly into the index.rst to continue serving\n> it as the front page material.\n> \n> Signed-off-by: Kieran Bingham \n\nReviewed-by: Niklas Söderlund \n\n> ---\n> Documentation/index.rst | 19 ++-----------------\n> Documentation/meson.build | 1 +\n> README.rst | 17 +++++++++++++++++\n> 3 files changed, 20 insertions(+), 17 deletions(-)\n> \n> diff --git a/Documentation/index.rst b/Documentation/index.rst\n> index e481f081f9a1..ec2222108e8a 100644\n> --- a/Documentation/index.rst\n> +++ b/Documentation/index.rst\n> @@ -1,20 +1,5 @@\n> -libcamera\n> -=========\n> -\n> -Cameras are complex devices that need heavy hardware image processing\n> -operations. Control of the processing is based on advanced algorithms that must\n> -run on a programmable processor. This has traditionally been implemented in a\n> -dedicated MCU in the camera, but in embedded devices algorithms have been moved\n> -to the main CPU to save cost. Blurring the boundary between camera devices and\n> -Linux often left the user with no other option than a vendor-specific\n> -closed-source solution.\n> -\n> -To address this problem the Linux media community has very recently started\n> -collaboration with the industry to develop a camera stack that will be\n> -open-source-friendly while still protecting vendor core IP. libcamera was born\n> -out of that collaboration and will offer modern camera support to Linux-based\n> -systems, including traditional Linux distributions, ChromeOS and Android.\n> -\n> +.. Front page matter is defined in the project README file.\n> +.. include:: ../README.rst\n> \n> .. toctree::\n> :maxdepth: 2\n> diff --git a/Documentation/meson.build b/Documentation/meson.build\n> index b1720b05f5ee..a560d02abfa5 100644\n> --- a/Documentation/meson.build\n> +++ b/Documentation/meson.build\n> @@ -41,6 +41,7 @@ endif\n> \n> if sphinx.found()\n> docs_sources = [\n> + '../README.rst',\n> 'coding-style.rst',\n> 'conf.py',\n> 'contributing.rst',\n> diff --git a/README.rst b/README.rst\n> index 9a8261ac8502..0f64e076a9c0 100644\n> --- a/README.rst\n> +++ b/README.rst\n> @@ -4,6 +4,23 @@\n> \n> **A complex camera support library for Linux, Android, and ChromeOS**\n> \n> +Cameras are complex devices that need heavy hardware image processing\n> +operations. Control of the processing is based on advanced algorithms that must\n> +run on a programmable processor. This has traditionally been implemented in a\n> +dedicated MCU in the camera, but in embedded devices algorithms have been moved\n> +to the main CPU to save cost. Blurring the boundary between camera devices and\n> +Linux often left the user with no other option than a vendor-specific\n> +closed-source solution.\n> +\n> +To address this problem the Linux media community has very recently started\n> +collaboration with the industry to develop a camera stack that will be\n> +open-source-friendly while still protecting vendor core IP. libcamera was born\n> +out of that collaboration and will offer modern camera support to Linux-based\n> +systems, including traditional Linux distributions, ChromeOS and Android.\n> +\n> +Getting Started\n> +---------------\n> +\n> To build and install:\n> \n> ::\n> -- \n> 2.20.1\n> \n> _______________________________________________\n> libcamera-devel mailing list\n> libcamera-devel@lists.libcamera.org\n> https://lists.libcamera.org/listinfo/libcamera-devel","headers":{"Return-Path":"","Received":["from mail-lj1-x230.google.com (mail-lj1-x230.google.com\n\t[IPv6:2a00:1450:4864:20::230])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 93A54600F9\n\tfor ;\n\tSat, 17 Aug 2019 15:56:43 +0200 (CEST)","by mail-lj1-x230.google.com with SMTP id z17so7764706ljz.0\n\tfor ;\n\tSat, 17 Aug 2019 06:56:43 -0700 (PDT)","from localhost ([185.224.57.161]) by smtp.gmail.com with ESMTPSA id\n\tn17sm1406771lfi.37.2019.08.17.06.56.41\n\t(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n\tSat, 17 Aug 2019 06:56:42 -0700 (PDT)"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=ragnatech-se.20150623.gappssmtp.com; s=20150623;\n\th=date:from:to:cc:subject:message-id:references:mime-version\n\t:content-disposition:content-transfer-encoding:in-reply-to\n\t:user-agent; bh=zYif0TQd8GAeQhai8GpVGmWImRDB1MrRsI06IIQulTk=;\n\tb=b36KtNK0VWh9ofAKVTF8yVPgt2oW+YHvahB/TfrcIwF+vYu0zCJH18rifgAMku5wsf\n\t6dmggmjJnQeXMCdsGHzzXwtkn6/QGrVQgc11M1Mz+cV6lNQsNIlJ4/IRCKjITloYbFy0\n\tv/XvEKyZYlx5vccQ1sDvcdoYju9stJG9+75vzPpGE3zNyIISQNundxCYLYLLUBwfRLFc\n\tz/DJDjN0LTpuOOmVEXrA0k/Q4Z2STAZsxPNbAZeKSBlduBPE7pW7Pc3E951WslMn4rRI\n\tI0F2GK78775XtQLfAHnOh3ZlWCeBHgzz8v3K4BokjjYqvLXwHbiBMsrnbQSUjaPJbxpU\n\tPwfA==","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=1e100.net; s=20161025;\n\th=x-gm-message-state:date:from:to:cc:subject:message-id:references\n\t:mime-version:content-disposition:content-transfer-encoding\n\t:in-reply-to:user-agent;\n\tbh=zYif0TQd8GAeQhai8GpVGmWImRDB1MrRsI06IIQulTk=;\n\tb=MTDMXoTtVSlFC8XnmgJNRSAOLiTp7X9VkG5x4FB4me63mK5qaLH3HNQEyTze3za7AS\n\tub3bCOzPvwZsZeUSeAVaPSjxa0WLogu3YJeF12HhsNYRXLIariks2mpyBe1Me7yhAR51\n\twK0Gf9a+ftvoKUNwVd/2vYFSWLizrNLqkzQcDgXRZFiJzO42xLnWmJzf/az5gPd8a2gS\n\txg7RUDny8wsqGpeRPjzqnYqtbXiFtXgGFHRk1jb4UEPGDNqO/SN4ke64+7268jEh3cNA\n\tI9awh+SOhHcU1h6+bPkEJ6RRMDkEYgz7NoVFJX8ttZF1Y8RcqRIfKlzdyF52ELb7zKFh\n\trV5A==","X-Gm-Message-State":"APjAAAWxqG4dY5G2wrNdiTU1Amrq8KIUBJ0od8mNSfSmtnesceIj6ixD\n\txF5QITHLqk/YzocK1G5uE+7i/snO63M=","X-Google-Smtp-Source":"APXvYqyO1cEfVwW38PJarOsMWXgerJpi0rE+zzq45gkv6pzHaeMymH5/PuGakDvU2pRtcRoe5+JQgQ==","X-Received":"by 2002:a2e:9708:: with SMTP id r8mr4277476lji.217.1566050202817;\n\tSat, 17 Aug 2019 06:56:42 -0700 (PDT)","Date":"Sat, 17 Aug 2019 15:56:40 +0200","From":"Niklas =?iso-8859-1?q?S=F6derlund?= ","To":"Kieran Bingham ","Cc":"LibCamera Devel ","Message-ID":"<20190817135640.GC16603@wyvern>","References":"<20190814095817.13625-1-kieran.bingham@ideasonboard.com>\n\t<20190814095817.13625-3-kieran.bingham@ideasonboard.com>","MIME-Version":"1.0","Content-Type":"text/plain; charset=iso-8859-1","Content-Disposition":"inline","Content-Transfer-Encoding":"8bit","In-Reply-To":"<20190814095817.13625-3-kieran.bingham@ideasonboard.com>","User-Agent":"Mutt/1.12.1 (2019-06-15)","Subject":"Re: [libcamera-devel] [PATCH 2/3] readme: Move index page content\n\tto README","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.23","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","X-List-Received-Date":"Sat, 17 Aug 2019 13:56:44 -0000"}}]