Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-22 Thread Markus Heiser
Am 22.07.2016 um 11:46 schrieb Mauro Carvalho Chehab : > Em Thu, 21 Jul 2016 17:17:26 +0200 > Markus Heiser escreveu: > >> Am 19.07.2016 um 19:18 schrieb Mauro Carvalho Chehab >> : >> A bit OT, but I see that you often use tabs / I recommend to use spaces for indentation: >>>

Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-22 Thread Mauro Carvalho Chehab
Em Thu, 21 Jul 2016 17:17:26 +0200 Markus Heiser escreveu: > Am 19.07.2016 um 19:18 schrieb Mauro Carvalho Chehab > : > > >> A bit OT, but I see that you often use tabs / I recommend to use > >> spaces for indentation: > >> > >> http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.ht

Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-21 Thread Jonathan Corbet
On Thu, 21 Jul 2016 16:41:53 +0200 Markus Heiser wrote: > Am 21.07.2016 um 01:28 schrieb Jonathan Corbet : > > > I would hope that most people wouldn't have to worry about it, and would > > be able to just use what their distribution provides - that's the reason > > for the 1.2 compatibility requ

Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-21 Thread Markus Heiser
Am 19.07.2016 um 19:18 schrieb Mauro Carvalho Chehab : >> A bit OT, but I see that you often use tabs / I recommend to use >> spaces for indentation: >> >> http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#whitespace > > The Kernel policies are to use tabs instead of spaces,

Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-21 Thread Markus Heiser
Am 21.07.2016 um 01:28 schrieb Jonathan Corbet : > On Wed, 20 Jul 2016 08:07:54 +0200 > Markus Heiser wrote: > >> Jon, what do you think ... could we serve this 1.2 doc >> on https://www.kernel.org/doc/ as reference? > > Seems like a good idea. I don't really know who controls that directory

Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-20 Thread Jonathan Corbet
On Wed, 20 Jul 2016 08:07:54 +0200 Markus Heiser wrote: > Jon, what do you think ... could we serve this 1.2 doc > on https://www.kernel.org/doc/ as reference? Seems like a good idea. I don't really know who controls that directory, though; I can ping Konstantin and see what can be done there.

Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-20 Thread Mauro Carvalho Chehab
Em Wed, 20 Jul 2016 08:07:54 +0200 Markus Heiser escreveu: > Am 20.07.2016 um 02:00 schrieb Mauro Carvalho Chehab > : > > > Em Tue, 19 Jul 2016 16:49:16 -0600 > > Jonathan Corbet escreveu: > > > >> On Tue, 19 Jul 2016 11:53:19 -0300 > >> Mauro Carvalho Chehab wrote: > >> > >>> So, I gue

Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-19 Thread Markus Heiser
Am 20.07.2016 um 02:00 schrieb Mauro Carvalho Chehab : > Em Tue, 19 Jul 2016 16:49:16 -0600 > Jonathan Corbet escreveu: > >> On Tue, 19 Jul 2016 11:53:19 -0300 >> Mauro Carvalho Chehab wrote: >> >>> So, I guess we should set the minimal requirement to 1.2.x. >> >> *sigh*. >> >> I hate to

Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-19 Thread Mauro Carvalho Chehab
Em Tue, 19 Jul 2016 16:49:16 -0600 Jonathan Corbet escreveu: > On Tue, 19 Jul 2016 11:53:19 -0300 > Mauro Carvalho Chehab wrote: > > > So, I guess we should set the minimal requirement to 1.2.x. > > *sigh*. > > I hate to do that; things are happening quickly enough with Sphinx that > it wou

Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-19 Thread Jonathan Corbet
On Tue, 19 Jul 2016 11:53:19 -0300 Mauro Carvalho Chehab wrote: > So, I guess we should set the minimal requirement to 1.2.x. *sigh*. I hate to do that; things are happening quickly enough with Sphinx that it would be nice to be able to count on a newer version. That said, one of my goals in t

Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-19 Thread Mauro Carvalho Chehab
Em Tue, 19 Jul 2016 18:42:50 +0200 Markus Heiser escreveu: > > What we miss is the documentation for Sphinx 1.2 and 1.3 versions. The > > site only has documentation for the very latest version, making harder > > to ensure that we're using only the tags supported by a certain version. > > We c

Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-19 Thread Markus Heiser
Am 19.07.2016 um 16:53 schrieb Mauro Carvalho Chehab : > Em Tue, 19 Jul 2016 14:31:18 +0200 > Markus Heiser escreveu: > > >>> I really hate stupid toolchains that require everybody to upgrade to >>> the very latest version of it every time. >> >> Hi Mauro, >> >> It might be annoying how sp

Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-19 Thread Mauro Carvalho Chehab
Em Tue, 19 Jul 2016 11:53:19 -0300 Mauro Carvalho Chehab escreveu: > Yet, this doesn't solve the specific issue for the TOC index > name. How this could be done in a way that would be backward > compatible to 1.2.x? Answering myself, the following patch should trick Sphinx to allow the media boo

Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-19 Thread Mauro Carvalho Chehab
Em Tue, 19 Jul 2016 14:31:18 +0200 Markus Heiser escreveu: > > I really hate stupid toolchains that require everybody to upgrade to > > the very latest version of it every time. > > Hi Mauro, > > It might be annoying how sphinx handles errors, but normally a build > process should report err

Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-19 Thread Markus Heiser
Am 19.07.2016 um 13:12 schrieb Mauro Carvalho Chehab : > Em Tue, 19 Jul 2016 11:19:11 +0200 > Hans Verkuil escreveu: > >>> All those documents are built automatically, once by day, at linuxtv.org: >>> >>> uAPI: >>> https://linuxtv.org/downloads/v4l-dvb-apis-new/media/media_uapi.html >>

Re: [PATCH 00/18] Complete moving media documentation to ReST format

2016-07-19 Thread Mauro Carvalho Chehab
Em Tue, 19 Jul 2016 11:19:11 +0200 Hans Verkuil escreveu: > > All those documents are built automatically, once by day, at linuxtv.org: > > > > uAPI: > > https://linuxtv.org/downloads/v4l-dvb-apis-new/media/media_uapi.html > > Erm, there is nothing there, only the top-level menu. Gah! Th