Re: [PATCH V2] leds: trigger: Introduce an USB port trigger

2016-07-17 Thread Rafał Miłecki
On 18 July 2016 at 07:53, Peter Chen wrote: > On Mon, Jul 18, 2016 at 07:57:34AM +0200, Rafał Miłecki wrote: >> On 18 July 2016 at 07:40, Peter Chen wrote: >> > On Mon, Jul 18, 2016 at 06:44:49AM +0200, Rafał Miłecki wrote: >> >> On 18 July 2016 at 04:31, Peter Chen wrote: >> >> > On Fri, Jul 15

Re: [PATCH V2] leds: trigger: Introduce an USB port trigger

2016-07-17 Thread Peter Chen
On Mon, Jul 18, 2016 at 07:57:34AM +0200, Rafał Miłecki wrote: > On 18 July 2016 at 07:40, Peter Chen wrote: > > On Mon, Jul 18, 2016 at 06:44:49AM +0200, Rafał Miłecki wrote: > >> On 18 July 2016 at 04:31, Peter Chen wrote: > >> > On Fri, Jul 15, 2016 at 11:10:45PM +0200, Rafał Miłecki wrote: >

Re: [PATCH V2] leds: trigger: Introduce an USB port trigger

2016-07-17 Thread Rafał Miłecki
On 18 July 2016 at 07:40, Peter Chen wrote: > On Mon, Jul 18, 2016 at 06:44:49AM +0200, Rafał Miłecki wrote: >> On 18 July 2016 at 04:31, Peter Chen wrote: >> > On Fri, Jul 15, 2016 at 11:10:45PM +0200, Rafał Miłecki wrote: >> >> + >> >> +usbport trigger: >> >> +- usb-ports : List of USB ports th

Re: [PATCH V2] leds: trigger: Introduce an USB port trigger

2016-07-17 Thread Peter Chen
On Mon, Jul 18, 2016 at 06:44:49AM +0200, Rafał Miłecki wrote: > On 18 July 2016 at 04:31, Peter Chen wrote: > > On Fri, Jul 15, 2016 at 11:10:45PM +0200, Rafał Miłecki wrote: > >> + > >> +usbport trigger: > >> +- usb-ports : List of USB ports that usbport should observed for turning > >> on a >

Re: [PATCH V2] leds: trigger: Introduce an USB port trigger

2016-07-17 Thread Rafał Miłecki
On 18 July 2016 at 04:31, Peter Chen wrote: > On Fri, Jul 15, 2016 at 11:10:45PM +0200, Rafał Miłecki wrote: >> + >> +usbport trigger: >> +- usb-ports : List of USB ports that usbport should observed for turning on >> a >> + given LED. >> + > > %s/should/should be Thanks. >> diff --g

Re: [PATCH 7/8] uio: bind uio_dmem_genirq via OF

2016-07-17 Thread Anup Patel
On Fri, Jul 15, 2016 at 10:22 PM, Mark Rutland wrote: > On Fri, Jul 15, 2016 at 09:57:28PM +0530, Anup Patel wrote: >> On Fri, Jul 15, 2016 at 6:58 PM, Mark Rutland wrote: >> > On Fri, Jul 15, 2016 at 02:34:02PM +0530, Anup Patel wrote: >> >> +static char uio_of_dma_bits_prop[128] = "uio,dma-bits

Re: [PATCH V2] leds: trigger: Introduce an USB port trigger

2016-07-17 Thread Peter Chen
On Fri, Jul 15, 2016 at 11:10:45PM +0200, Rafał Miłecki wrote: > + > +usbport trigger: > +- usb-ports : List of USB ports that usbport should observed for turning on a > + given LED. > + %s/should/should be > Examples: > > system-status { > @@ -58,6 +64,11 @@ system-status { >

Re: [PATCH] kernel-doc: Fix up warning output

2016-07-17 Thread Jonathan Corbet
On Fri, 15 Jul 2016 10:19:30 +0200 Daniel Vetter wrote: > While trying to make gpu docs warning free I stumbled over one output > which wasn't following proper compiler error output standards. Fix it > up for more quickfix awesomeness. Applied to the docs tree - awesomeness achieved. Thanks, j

Re: Troubles with kernel-doc and RST files

2016-07-17 Thread Jonathan Corbet
[Back home and trying to get going on stuff for real. I'll look at the issues listed in this message one at a time.] On Sun, 17 Jul 2016 10:01:54 -0300 Mauro Carvalho Chehab wrote: > 1) We now need to include each header file with documentation twice, > one to get the enums, structs, typedefs,

[PATCH 26/36] [media] doc-rst: add documentation for saa7134

2016-07-17 Thread Mauro Carvalho Chehab
Convert it to ReST and add to the media/v4l-device book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst | 1 + Documentation/media/v4l-drivers/saa7134.rst | 43 + 2 files changed, 20 insertions(+), 24 deletions(-) diff --git a/D

[PATCH 19/36] [media] doc-rst: Add ivtv documentation

2016-07-17 Thread Mauro Carvalho Chehab
Convert ivtv documentation to rst, update the links there and add to media/v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst | 1 + Documentation/media/v4l-drivers/ivtv.rst | 209 +- 2 files changed, 121 insertions

[PATCH 17/36] [media] doc-rst: add davinci-vpbe documentation

2016-07-17 Thread Mauro Carvalho Chehab
Convert it to rst format and add it to the v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/davinci-vpbe.rst | 32 +--- Documentation/media/v4l-drivers/index.rst| 1 + 2 files changed, 18 insertions(+), 15 deletions(-) diff

[PATCH 14/36] [media] doc-rst: add documentation for cpia2 driver

2016-07-17 Thread Mauro Carvalho Chehab
Convert the documentation to rst, merge the two files and add to the index.rst. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/cpia2.rst | 202 + Documentation/media/v4l-drivers/cpia2_overview.rst | 38 Documentation/media/v4l-drivers/

[PATCH 13/36] [media] doc-rst: add Zoran zr364xx documentation

2016-07-17 Thread Mauro Carvalho Chehab
Convert the documentation to rst and add it to the book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst | 1 + Documentation/media/v4l-drivers/zr364xx.rst | 89 + 2 files changed, 65 insertions(+), 25 deletions(-) diff --git a/D

[PATCH 32/36] [media] doc-rst: add documentation for uvcvideo

2016-07-17 Thread Mauro Carvalho Chehab
Convert it to ReST and add to media/v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst| 1 + Documentation/media/v4l-drivers/uvcvideo.rst | 48 ++-- 2 files changed, 33 insertions(+), 16 deletions(-) diff --git a/Doc

[PATCH 27/36] [media] doc-rst: add sh_mobile_ceu_camera crop documentation

2016-07-17 Thread Mauro Carvalho Chehab
Convert it to ReST and add it to media/v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst | 1 + .../media/v4l-drivers/sh_mobile_ceu_camera.rst | 57 +++--- 2 files changed, 30 insertions(+), 28 deletions(-) diff --

[PATCH 30/36] [media] doc-rst: add documentation for si476x

2016-07-17 Thread Mauro Carvalho Chehab
Convert it to ReST and add to media/v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst | 2 + Documentation/media/v4l-drivers/si476x.rst | 229 - 2 files changed, 96 insertions(+), 135 deletions(-) diff --git a/Doc

[PATCH 21/36] [media] doc-rst: add omap3isp documentation

2016-07-17 Thread Mauro Carvalho Chehab
Convert omap3isp documentation to ReST and add it to the media/v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst| 1 + Documentation/media/v4l-drivers/omap3isp.rst | 135 ++- 2 files changed, 70 insertions(+), 66 de

[PATCH 34/36] [media] doc-rst: add vivid documentation

2016-07-17 Thread Mauro Carvalho Chehab
Convert it to ReST and add to media/v4l-drivers book. As the sections here (and on other docs) are numbered, let's also make this book auto-numbered. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst | 2 + Documentation/media/v4l-drivers/vivid.rst | 667 +

[PATCH 33/36] [media] doc-rst: add documentation for Zoran driver

2016-07-17 Thread Mauro Carvalho Chehab
Convert it to ReST and add to media/v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst | 1 + Documentation/media/v4l-drivers/zoran.rst | 305 ++ 2 files changed, 189 insertions(+), 117 deletions(-) diff --git a/Doc

[PATCH 07/36] [media] doc-rst: Convert videobuf documentation to ReST

2016-07-17 Thread Mauro Carvalho Chehab
The videobuf documentation is almost at rst format: we just needed to add titles and add some code-blocks there and that's it. Also, add a notice that this framework is deprecated. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/kapi/videobuf.rst | 51 ++

[PATCH 10/36] [media] doc-rst: convert fourcc to rst format

2016-07-17 Thread Mauro Carvalho Chehab
Fix fourcc for it to be correcly parsed by Sphinx. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/fourcc.rst | 20 +--- Documentation/media/v4l-drivers/index.rst | 1 + 2 files changed, 10 insertions(+), 11 deletions(-) diff --git a/Documentation/medi

[PATCH 35/36] [media] doc-rst: add documentation about IR on V4L boards

2016-07-17 Thread Mauro Carvalho Chehab
This section is outdated, but let's add it, after converting to ReST, and then fix it. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst | 1 + Documentation/media/v4l-drivers/v4l-with-ir.rst | 15 +-- 2 files changed, 10 insertions(+), 6 delet

[PATCH 31/36] [media] doc-rst: add soc-camera documentation

2016-07-17 Thread Mauro Carvalho Chehab
Convert it to ReST format and add it at media/v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst | 1 + Documentation/media/v4l-drivers/si476x.rst | 12 +--- Documentation/media/v4l-drivers/soc-camera.rst | 41 +++---

[PATCH 28/36] [media] doc-rst: add documentation for si470x

2016-07-17 Thread Mauro Carvalho Chehab
Convert it to ReST and add to media/v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst | 1 + Documentation/media/v4l-drivers/si470x.rst | 74 ++ 2 files changed, 56 insertions(+), 19 deletions(-) diff --git a/Docum

[PATCH 36/36] [media] v4l-with-ir.rst: update it to reflect the current status

2016-07-17 Thread Mauro Carvalho Chehab
This document were really old. Update it to reflect the current status of the IR drivers for TV. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/v4l-with-ir.rst | 82 - 1 file changed, 40 insertions(+), 42 deletions(-) diff --git a/Documentation/

[PATCH 03/36] [media] doc-rst: Remove deprecated API.html document

2016-07-17 Thread Mauro Carvalho Chehab
This document points to some old stuff. Just remove it. Signed-off-by: Mauro Carvalho Chehab --- Documentation/video4linux/API.html | 27 --- 1 file changed, 27 deletions(-) delete mode 100644 Documentation/video4linux/API.html diff --git a/Documentation/video4linux/API

[PATCH 15/36] [media] doc-rst: Add cx88 documentation to media book

2016-07-17 Thread Mauro Carvalho Chehab
Convert the cx88 documentation to rst and add it to the v4l-devices book Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/cx88.rst | 15 --- Documentation/media/v4l-drivers/index.rst | 1 + 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/Docu

[PATCH 24/36] [media] doc-rst: add pxa_camera documentation

2016-07-17 Thread Mauro Carvalho Chehab
Convert pxa_camera to ReST format and add it to the media/v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst | 1 + Documentation/media/v4l-drivers/pxa_camera.rst | 212 ++--- 2 files changed, 116 insertions(+), 97 dele

[PATCH 11/36] [media] doc-rst: convert cafe_ccic file to rst format

2016-07-17 Thread Mauro Carvalho Chehab
This file is almost ok, but it needs chapter/sections and a code-block. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/cafe_ccic.rst | 24 +++- Documentation/media/v4l-drivers/index.rst | 1 + 2 files changed, 16 insertions(+), 9 deletions(-) d

[PATCH 18/36] [media] doc-rst: add documentation for fimc driver

2016-07-17 Thread Mauro Carvalho Chehab
Convert the document to rst and add it to the v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/fimc.rst | 95 +++ Documentation/media/v4l-drivers/index.rst | 1 + 2 files changed, 60 insertions(+), 36 deletions(-) diff --gi

[PATCH 25/36] [media] doc-rst: add documentation for radiotrack

2016-07-17 Thread Mauro Carvalho Chehab
Convert it to ReST and add it to the media/v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst | 1 + Documentation/media/v4l-drivers/radiotrack.rst | 179 ++--- 2 files changed, 100 insertions(+), 80 deletions(-) diff

[PATCH 29/36] [media] doc-rst: add documentation for si4713

2016-07-17 Thread Mauro Carvalho Chehab
Convert it to ReST and add it to the media/v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/si4713.rst | 188 - 1 file changed, 101 insertions(+), 87 deletions(-) diff --git a/Documentation/media/v4l-drivers/si4713.rst b/Doc

[PATCH 16/36] [media] cx88.rst: Update the documentation

2016-07-17 Thread Mauro Carvalho Chehab
This doc is outdated, and contains information that it is not true anymore. Update it to reflect the changes that this driver suffered since I started working on it. While here, also update Gerd's name. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/cx88.rst | 52 +

[PATCH 22/36] [media] doc-rst: add omap4_camera documentation

2016-07-17 Thread Mauro Carvalho Chehab
Convert the omap4_camera documentation to ReST and add it to the media/v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst| 1 + Documentation/media/v4l-drivers/omap4_camera.rst | 28 2 files changed, 15 insertion

[PATCH 23/36] [media] doc-rst: add documentation for pvrusb2

2016-07-17 Thread Mauro Carvalho Chehab
Convert pvrusb2 documentation to ReST file and removed the note about an html version of the documentation, as it is not shipped inside the Kernel. Add it to media/v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst | 1 + Documentation/media

[PATCH 20/36] [media] doc-rst: add meye documentation

2016-07-17 Thread Mauro Carvalho Chehab
Convert the meye documentation to rst and add it to the media/v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst | 1 + Documentation/media/v4l-drivers/meye.rst | 103 -- 2 files changed, 57 insertions(+), 47 deleti

[PATCH 12/36] [media] doc-rst: add gspca cardlist

2016-07-17 Thread Mauro Carvalho Chehab
Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/cardlist.rst | 1 + .../media/v4l-drivers/{gspca.rst => gspca-cardlist.rst} | 16 ++-- 2 files changed, 11 insertions(+), 6 deletions(-) rename Documentation/media/v4l-drivers/{gspca.rst => gspca-c

[PATCH 06/36] [media] doc-rst: move videobuf documentation to media/kapi

2016-07-17 Thread Mauro Carvalho Chehab
This document describes a kapi framework. Move it to the right place. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/kapi/v4l2-controls.rst | 169 +++-- .../videobuf => media/kapi/videobuf.rst} | 0 2 files changed, 122 insertions(+), 47 deletion

[PATCH 04/36] [media] doc-rst: move framework docs to kAPI documentation

2016-07-17 Thread Mauro Carvalho Chehab
Those documentation are part of the kAPI one. Move to the right place. Signed-off-by: Mauro Carvalho Chehab --- .../{video4linux/v4l2-controls.txt => media/kapi/v4l2-controls.rst} | 0 .../{video4linux/v4l2-framework.txt => media/kapi/v4l2-framework.rst} | 0 Documentation/media/media_driv

[PATCH 05/36] [media] doc-rst: do a poor man's conversion of v4l2-framework

2016-07-17 Thread Mauro Carvalho Chehab
Make Sphinx happy with v4l2-framework.rst by putting all C code inside code-block. Please note that this is a poor man ReST conversion, as several of those blocks should actually be converted to use :cpp:func:, pointing to the kAPI auto-generated documentation. The problem is that we currently la

[PATCH 08/36] doc-rst: add v4l-drivers to index file

2016-07-17 Thread Mauro Carvalho Chehab
Adds documentation for V4L drivers. Signed-off-by: Mauro Carvalho Chehab --- Documentation/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/Documentation/index.rst b/Documentation/index.rst index b61d8deb84d1..31273cc2e0bc 100644 --- a/Documentation/index.rst +++ b/Documentation/ind

[PATCH] docs: Get rid of some kernel-documentation warnings

2016-07-17 Thread Jonathan Corbet
Sphinx wants to interpret all literal blocks as being in the chosen language and complains when an attempt to parse a block fails. kernel-documentation.rst has a few blocks that are not in C; make that explicit to shut down the associated warnings. Signed-off-by: Jonathan Corbet --- Documentatio

Re: [PATCH v13 00/12] support "task_isolation" mode

2016-07-17 Thread Christoph Lameter
On Thu, 14 Jul 2016, Andy Lutomirski wrote: > As an example, enough vmalloc/vfree activity will eventually cause > flush_tlb_kernel_range to be called and *boom*, there goes your shiny > production dataplane application. Once virtually mapped kernel stacks > happen, the frequency with which this

[PATCH 05/15] [media] doc-rst: convert cards to rst format

2016-07-17 Thread Mauro Carvalho Chehab
This file is using a markup-like language, but it is not quite ReST. Convert it, and add a note pointing to the Wiki page with the known supported hardware devices. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/dvb-drivers/cards.rst | 71 --- Documentat

[PATCH 14/15] [media] doc-rst: convert udev chapter to rst

2016-07-17 Thread Mauro Carvalho Chehab
This chapter is outdated. I almost removed, but, as we're lacking documentation about how to make DVB devices persistent, I opted, instead, to keep it, and add a note about that. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/dvb-drivers/index.rst | 1 + Documentation/media/dvb-dr

[PATCH 04/15] [media] doc-rst: convert bt8xx doc to rst

2016-07-17 Thread Mauro Carvalho Chehab
This document almost follows a markup language, but it is not ReST. Fix it to be handled by Sphinx. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/dvb-drivers/bt8xx.rst | 120 ++ Documentation/media/dvb-drivers/index.rst | 1 + 2 files changed, 73 inse

[PATCH 09/15] [media] doc-rst: convert DVB FAQ to ReST format

2016-07-17 Thread Mauro Carvalho Chehab
Convert the DVB FAQ to ReST format and add a note that this is outdated. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/dvb-drivers/faq.rst | 18 +- Documentation/media/dvb-drivers/index.rst | 1 + 2 files changed, 14 insertions(+), 5 deletions(-) diff --git a/D

[PATCH 11/15] [media] doc-rst: add opera-firmware.rst to DVB docs

2016-07-17 Thread Mauro Carvalho Chehab
This file is shown OK with ReST. Yet, as we changed the place where the get_dvb_firmware script is, we need to update it. While here, move the author's name to the beginning of the file. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/dvb-drivers/index.rst | 1 + Document

[PATCH 06/15] [media] doc-rst: Convert ci.txt to a rst file

2016-07-17 Thread Mauro Carvalho Chehab
The old ci.txt file had a very peculiar format, with doesn't match any markup language I know. Change it to be on ReST format, for it to be parsed by Sphinx. Also, as this is an old document, add a note about it. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/dvb-drivers/ci.rst

[PATCH 03/15] [media] doc-rst: Fix format of avermedia.rst

2016-07-17 Thread Mauro Carvalho Chehab
This file is almost at the ReST format, but some things need to be fixed for it to be parsed. Also, the documentation there is old. So, add a notice about that. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/dvb-drivers/avermedia.rst | 510 -- Documentation

[PATCH 15/15] [media] add DVB documentation to Sphinx

2016-07-17 Thread Mauro Carvalho Chehab
Now that all DVB files got converted, add it to Sphinx build. Signed-off-by: Mauro Carvalho Chehab --- Documentation/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/Documentation/index.rst b/Documentation/index.rst index a5a100d43f4f..b61d8deb84d1 100644 --- a/Documentation/index.r

[PATCH 08/15] [media] doc-rst: Convert dvb-usb to ReST format

2016-07-17 Thread Mauro Carvalho Chehab
This file is not on any markup language. Convert it to ReST format. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/dvb-drivers/dvb-usb.rst | 317 +++- Documentation/media/dvb-drivers/index.rst | 1 + 2 files changed, 221 insertions(+), 97 deletions(-) d

[PATCH 13/15] [media] doc-rst: convert ttusb-dev to rst

2016-07-17 Thread Mauro Carvalho Chehab
There are some things that needed to be done to convert it to ReST. Also, there are some obsolete info there related to Kernels 2.4 and 2.6. Update them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/dvb-drivers/index.rst | 1 + Documentation/media/dvb-drivers/ttusb-dec.rst |

[PATCH 07/15] [media] doc-rst: Convert contributors list to ReST

2016-07-17 Thread Mauro Carvalho Chehab
The contributors list needs some adjustments to be properly formatted. Also, this list has not been updated for a while. So, add a notice about that. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/dvb-drivers/contributors.rst | 169 ++- Documentation/media/dvb-

[PATCH 02/15] [media] doc-rst: move DVB introduction to a separate file

2016-07-17 Thread Mauro Carvalho Chehab
Instead of keeping the introduction together with the index, move it to a separate file, and add it via toctree at the index. The information there are outdated, so update it to point to the right links. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/dvb-drivers/index.rst | 71 +++

[PATCH 12/15] [media] doc-rst: Convert technisat document to ReST

2016-07-17 Thread Mauro Carvalho Chehab
This document need some changes to be properly parsed by Sphinx. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/dvb-drivers/index.rst | 1 + Documentation/media/dvb-drivers/technisat.rst | 148 +++--- 2 files changed, 85 insertions(+), 64 deletions(-) dif

[PATCH 10/15] [media] doc-rst: Convert lmedm04 to rst format

2016-07-17 Thread Mauro Carvalho Chehab
This file was missing a name for the index, and weren't using any markup language. Make it looks better and convert to ReST. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/dvb-drivers/index.rst | 1 + Documentation/media/dvb-drivers/lmedm04.rst | 72 +++--

[PATCH 1/7] [media] doc-rst: Convert media API to rst

2016-07-17 Thread Mauro Carvalho Chehab
Move the contents of the media section at DocBooks/DocBook/device-drivers.tmpl to a new ReST book. For now, the contents is kept as-is. Next patches will fix the warnings and add cross-references that were removed due to the conversion. Signed-off-by: Mauro Carvalho Chehab --- Documentation/Doc

[PATCH 3/7] [media] doc-rst: split media_drivers.rst into one file per API type

2016-07-17 Thread Mauro Carvalho Chehab
Just like the uAPI book is split into parts, let's split the kAPI documentation. That should make easier to maintain, and will split the final documentation into smaller html files. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/kapi/dtv-core.rst | 122 ++ Documentation/me

[PATCH 6/7] [media] doc-rst: Fix conversion for MC core functions

2016-07-17 Thread Mauro Carvalho Chehab
There were lots of issues at the media controller side, after the conversion: - Some documentation at the header files weren't using the kernel-doc start block; - Now, the C files with the exported symbols also need to be added. So, all headers need to be included twice: one to get the stru

[PATCH 2/7] [media] doc-rst: media_drivers.rst: Fix paragraph headers for MC

2016-07-17 Thread Mauro Carvalho Chehab
Fix the paragraph identation for the media controller headers. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/media_drivers.rst | 41 --- 1 file changed, 24 insertions(+), 17 deletions(-) diff --git a/Documentation/media/media_drivers.rst b/Documen

[PATCH 4/7] [media] doc-rst: Fix issues with RC documentation

2016-07-17 Thread Mauro Carvalho Chehab
The kernel-doc script is now broken if it doesn't find all exported symbols documented. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/kapi/rc-core.rst | 9 include/media/lirc_dev.h | 2 +- include/media/rc-core.h | 45 +++

[PATCH 7/7] [media] doc-rst: Fix conversion for dvb-core.rst

2016-07-17 Thread Mauro Carvalho Chehab
The conversion from DocBook required some fixes: - Now, the C files with the exported symbols also need to be added. So, all headers need to be included twice: one to get the structs/enums/.. and another one for the functions; - Notes should use the ReST tag, as kernel-doc doesn't recognize

[PATCH 5/7] [media] doc-rst: Fix conversion for v4l2 core functions

2016-07-17 Thread Mauro Carvalho Chehab
The conversion from DocBook lead into some conversion issues, basically due to the lack of proper support at kernel-doc. So, address them: - Now, the C files with the exported symbols also need to be added. So, all headers need to be included twice: one to get the structs/enums/.. and another

Troubles with kernel-doc and RST files

2016-07-17 Thread Mauro Carvalho Chehab
I'm now converting the kAPI media doc to RST file, and I'm seeing several issues with kernel-doc conversion: 1) We now need to include each header file with documentation twice, one to get the enums, structs, typedefs, ... and another one for the functions: .. kernel-doc:: include/media/m