Re: [RFC PATCH 0/3] doc-rst: customize HTML (RTD) theme

2016-07-09 Thread Jonathan Corbet
On Tue, 5 Jul 2016 14:55:09 -0300 Mauro Carvalho Chehab wrote: > I hope you don't mind. I'm merging those three patches on my tree > (for now, they're on an experimental tree that I can easily rebase, if > needed). If OK for you, my plan is to merge it on a separate branch, > together with the ot

Re: [PATCH v2] doc-rst: add an option to ignore DocBooks when generating docs

2016-07-09 Thread Jonathan Corbet
On Sat, 9 Jul 2016 13:12:45 -0300 Mauro Carvalho Chehab wrote: > Sometimes, we want to do a partial build, instead of building > everything. However, right now, if one wants to build just > Sphinx books, it will build also the DocBooks. > > Add an option to allow to ignore all DocBooks when bui

Re: [ANN] Media documentation converted to ReST markup language

2016-07-09 Thread Laurent Pinchart
Hi Mauro, On Friday 08 Jul 2016 10:34:20 Mauro Carvalho Chehab wrote: > As commented on the patch series I just submitted, we finished the > conversion of the Media uAPI book from DocBook to ReST. > > For now, I'm placing the new documentation, after parsed by Sphinx, at this > place: > htt

Re: [PATCH] capabilities: add capability cgroup controller

2016-07-09 Thread Topi Miettinen
On 07/08/16 09:13, Petr Mladek wrote: > On Thu 2016-07-07 20:27:13, Topi Miettinen wrote: >> On 07/07/16 09:16, Petr Mladek wrote: >>> On Sun 2016-07-03 15:08:07, Topi Miettinen wrote: The attached patch would make any uses of capabilities generate audit messages. It works for simple test

[PATCH v2] doc-rst: add an option to ignore DocBooks when generating docs

2016-07-09 Thread Mauro Carvalho Chehab
Sometimes, we want to do a partial build, instead of building everything. However, right now, if one wants to build just Sphinx books, it will build also the DocBooks. Add an option to allow to ignore all DocBooks when building documentation. Signed-off-by: Mauro Carvalho Chehab --- Documentati

[PATCH] doc-rst: add an option to ignore DocBooks when generating docs

2016-07-09 Thread Mauro Carvalho Chehab
Sometimes, we want to do a partial build, instead of building everything. However, right now, if one wants to build just Sphinx books, it will build also the DocBooks. Add an option to allow to ignore all DocBooks when building documentation. Signed-off-by: Mauro Carvalho Chehab --- Documentati

Re: [ANN] Media documentation converted to ReST markup language

2016-07-09 Thread Mauro Carvalho Chehab
Em Fri, 8 Jul 2016 15:45:52 +0200 Hans Verkuil escreveu: > On 07/08/2016 03:34 PM, Mauro Carvalho Chehab wrote: > > As commented on the patch series I just submitted, we finished the > > conversion > > of the Media uAPI book from DocBook to ReST. > > > > For now, I'm placing the new documentati

[PATCH] [media] doc-rst: make CEC look more like other parts of the book

2016-07-09 Thread Mauro Carvalho Chehab
Better organize the contents of the CEC part, moving the introduction to chapter 1, placing all ioctls at chapter 2 and numerating all chapters and items. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/uapi/cec/cec-api.rst | 60 +++--- Documentation/media/

[PATCH] [media] doc-rst: add CEC header file to the documentation

2016-07-09 Thread Mauro Carvalho Chehab
Adding the header file is interesting for several reasons: 1) It makes MC documentation consistend with other parts; 2) The header file can be used as a quick index to all API elements; 3) The cross-reference check helps to identify symbols that aren't documented. Signed-off-by: Mauro Carva

[PATCH 1/3] [media] doc-rst: Add new types to media-types.rst

2016-07-09 Thread Mauro Carvalho Chehab
Changesets: eaa0b96bbb65 ("[media] media: Add video statistics computation functions") and 1179aab13db3 ("[media] media: Add video processing entity functions") added some new elements to the "media entity types" table at the DocBook. We need to do the same at the reST version, in

[PATCH 3/3] [media] doc-rst: add media.h header to media contrller

2016-07-09 Thread Mauro Carvalho Chehab
Adding the header file is interesting for several reasons: 1) It makes MC documentation consistend with other parts; 2) The header file can be used as a quick index to all API elements; 3) The cross-reference check helps to identify symbols that aren't documented. Signed-off-by: Mauro Carva

[PATCH 2/3] doc-rst: parse-headers: remove trailing spaces

2016-07-09 Thread Mauro Carvalho Chehab
The function that replace references add a "\ " at the end of references, to avoid the ReST markup parser to not identify them as references. That works fine except for the end of lines, as a sequence of { '\', ' ', '\n' } characters makes Sphinx to ignore the end of line. So, strip those escape/sp