[PATCH 13/51] Documentation: linux_tv: convert lots of consts to references

There were lots of consts at the media docbook that should be, instead, references. Convert the ones that can easily be done by an automatic script. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/dev-capture.rst | 16 Documentation/linux_tv/media/v

[PATCH 05/51] Documentation: linux_tv/index.rst: add xrefs for document divisions

Make easier to navigate at the media document by adding the links to each of the parts of the document. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/index.rst | 16 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/Documentation/linux_tv/index.rst

[PATCH 09/51] Documentation: video.rst: Restore the captions for the examples

There are two examples in the code, but the captions of them were lost during the ReST conversion. Manually add them again. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/video.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Documentation/linu

[PATCH 35/51] Documentation: vidioc-g-edid.rst remove a duplicate declaration

The ioctl is declared twice. This causes the following warning: /devel/v4l/patchwork/Documentation/linux_tv/media/v4l/vidioc-g-edid.rst:7: Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/vidioc-g-edid.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/Doc

[PATCH 27/51] Documentation: selection-api-006.rst: add missing captions

The example captions got stripped by the conversion to ReST. Re-add. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/selection-api-006.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Documentation/linux_tv/media/v4l/selection-api-006.rst b/Documentation/linu

[PATCH 24/51] Documentation: crop.rst: fix conversion on this file

The conversion on this file didn't end too well. fix the found issues: 1) Sphinix seems to not allow things like *foo :ref:`bar`*. At least on this document, it did the wrong thing. So, change the logic to something that will work fine with ReST format; 2) Some ioctl pointers were not looking nic

[PATCH 04/51] Documentation: querycap.rst: fix troubles on some references

This is not due to the format change, but there are some wrong references on this file. Fix them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/querycap.rst | 10 +- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Documentation/linux_tv/media/v4l

[PATCH 06/51] Documentation: app-pri.rst: Fix a bad reference

What should be a reference to VIDIOC_S_PRIORITY was incorrectly defined as a constant at the DocBook. Fix it on the rst version. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/app-pri.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documenta

[PATCH 26/51] Documentation: linux_tv: use Example x.y. instead of a single number

On the example captions, use always .., because: 1) it matches the DocBook; 2) it would mean less changes if we need to add a new example, as only one chapter will be affected. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/audio.rst| 4 ++-- Documentation/linux_tv

[PATCH 25/51] Documentation: selection-api-005.rst: Fix ReST parsing

The ReST markup is limited: it doesn't accept a const just after a reference. So, change the documentation to avoid such constraint. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/selection-api-005.rst | 9 + 1 file changed, 5 insertions(+), 4 deletions(-) dif

[PATCH 38/51] Documentation: extended-controls.rst: "count" is a constant

Constify the string "count" where it means a field. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/extended-controls.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/linux_tv/media/v4l/extended-controls.rst b/Documentation/linux_tv

[PATCH 16/51] Documentation: standard.rst: read the example captions

Those got lost during format conversion. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/standard.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Documentation/linux_tv/media/v4l/standard.rst b/Documentation/linux_tv/media/v4l/standard.rst index 20c0d044a129

[PATCH 15/51] Documentation: audio.rst: re-add captions for the examples

The captions were lost during the format conversion. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/audio.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documentation/linux_tv/media/v4l/audio.rst b/Documentation/linux_tv/media/v4l/audio.rst index 8c3314218f

[PATCH 14/51] Documentation: linux_tv: don't simplify VIDIOC_G_foo references

As VIDIOC_G_foo is the reference used for VIDIOC_S_foo and VIDIOC_TRY_foo, we need to explicitly name the reference, as otherwise, it will mention the three ioctls altogether, with is not what we want. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/app-pri.rst |

[PATCH 37/51] Documentation: rw.rst fix a warning

Fix this Sphinx warning: Documentation/linux_tv/media/v4l/rw.rst:31: WARNING: Literal block ends without a blank line; unexpected unindent. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/rw.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff

[PATCH 39/51] Documentation: pixfmt-004.rst: Add an extra reference

One paragraph mentions the YUV422 formats, but doesn't provide a cross-ref. Add it. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/pixfmt-004.rst | 12 ++-- 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/Documentation/linux_tv/media/v4l/pixfmt-00

[PATCH 10/51] Documentation: audio.rst: Fix some cross references

There are several constants there that should be, instead, cross-references. Fix them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/audio.rst | 8 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Documentation/linux_tv/media/v4l/audio.rst b/Doc

[PATCH 36/51] Documentation: open.rst: fix some warnings

Fix those warnings: Documentation/linux_tv/media/v4l/open.rst:38: WARNING: Literal block ends without a blank line; unexpected unindent. Documentation/linux_tv/media/v4l/open.rst:45: WARNING: Literal block ends without a blank line; unexpected unindent. Signed-off-by: Mauro Carva

[PATCH 18/51] Documentation: control.rst: read the example captions

Those got removed by the doc conversion. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/control.rst | 4 1 file changed, 4 insertions(+) diff --git a/Documentation/linux_tv/media/v4l/control.rst b/Documentation/linux_tv/media/v4l/control.rst index d6df648767c5..

[PATCH 29/51] Documentation: linux_tv: use references for structures

On several places, instead of using references, the code was using some other tag. Not sure if this was due to the conversion, or if something were already wrong on the DocBook. In any case, let's fix them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/buffer.rst

[PATCH 42/51] Documentation: pixfmt-uyvy.rst: remove an empty column

The conversion added an empty column (probably, it was used on DocBook just to increase spacing. Remove it. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/pixfmt-uyvy.rst | 7 --- 1 file changed, 7 deletions(-) diff --git a/Documentation/linux_tv/media/v4l/pixfmt

[PATCH 34/51] Documentation: fe_property_parameters.rst: improve descriptions

The asterisks cause parsing warnings with Sphinx: Documentation/linux_tv/media/dvb/fe_property_parameters.rst:954: WARNING: Inline substitution_reference start-string without end-string. /devel/v4l/patchwork/Documentation/linux_tv/media/dvb/fe_property_parameters.rst:993: WARNING

[PATCH 41/51] Documentation: pixfmt-y12i.rst: correct format conversion

The format conversion broke one paragraph into two. Fix it. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/pixfmt-y12i.rst | 4 1 file changed, 4 deletions(-) diff --git a/Documentation/linux_tv/media/v4l/pixfmt-y12i.rst b/Documentation/linux_tv/media/v4l/pixfmt

[PATCH 49/51] Documentation: pixfmt-yuv411p.rst: remove an empty column

The conversion added an empty column (probably, it was used on DocBook just to increase spacing. It also added an extra line on one of the texts, breaking the original paragraph into two ones. Remove them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/pixfmt-yuv411p

[PATCH 44/51] Documentation: pixfmt-vyuy.rst: remove an empty column

The conversion added an empty column (probably, it was used on DocBook just to increase spacing. Remove it. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/pixfmt-vyuy.rst | 9 - 1 file changed, 9 deletions(-) diff --git a/Documentation/linux_tv/media/v4l/pixf

[PATCH 43/51] Documentation: pixfmt-yvyu.rst: remove an empty column

The conversion added an empty column (probably, it was used on DocBook just to increase spacing. Remove it. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/pixfmt-yvyu.rst | 9 - 1 file changed, 9 deletions(-) diff --git a/Documentation/linux_tv/media/v4l/pixf

[PATCH 46/51] Documentation: pixfmt-yuv422m.rst: remove an empty column

The conversion added an empty column (probably, it was used on DocBook just to increase spacing. Remove it. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/pixfmt-yuv422m.rst | 5 - 1 file changed, 5 deletions(-) diff --git a/Documentation/linux_tv/media/v4l/pixfm

[PATCH 32/51] Documentation: fdl-appendix: Fix formatting issues

The conversion didn't add blank lines where needed, but it added were it weren't ;) Fix it, to make it to parse correctly by Sphinx. This also fixes a bunch or warnings: /devel/v4l/patchwork/Documentation/linux_tv/media/v4l/fdl-appendix.rst:44: WARNING: Explicit markup ends without a blank line;

[PATCH 23/51] Documentation: planar-apis.rst: fix some conversion troubles

There is a missing escape caracter, causing troubles at the format of one of the paragraphs. Also, the ioctl description was producing some warnings about wrong identation. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/planar-apis.rst | 14 +- 1 file chang

[PATCH 30/51] Documentation: linux_tv: Fix remaining undefined references

Fix Sphinx those warnings: WARNING: undefined label: fdl-modified>`as given on the :ref:`title page --- Documentation/linux_tv/media/v4l/fdl-appendix.rst| 2 +- Documentation/linux_tv/media/v4l/pixfmt-srggb10dpcm8.rst | 2 +- Documentation/linux_tv/media/v4l/pixfmt-yuv420.rst

[PATCH 45/51] Documentation: pixfmt-41p.rst: remove empty columns

The conversion added empty columns (probably, it was used on DocBook just to increase spacing. Remove them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/pixfmt-y41p.rst | 27 1 file changed, 27 deletions(-) diff --git a/Documentation/linux_

[PATCH 21/51] Documentation: vidioc-queryctl.rst: change the title of this chapter

This chapter is referenced on several parts of the extended controls. Change the title to make it nicer where it is referenced. Ok, we might, instead, just change the name for the references to only mention the oldest ioctl, but IMHO, it is better to keep the name of all ioctls where it is referen

[PATCH 48/51] Documentation: pixfmt-yuv422p.rst: remove an empty column

The conversion added an empty column (probably, it was used on DocBook just to increase spacing. Remove it. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/pixfmt-yuv422p.rst | 5 - 1 file changed, 5 deletions(-) diff --git a/Documentation/linux_tv/media/v4l/pixfm

[PATCH 22/51] Documentation: linux_tv: supress lots of warnings

The c language parser checks if there are duplicated object definitions. That causes lots of warnings like: WARNING: duplicate C object description of ioctl Let's remove those by telling Sphinx that the language for those objects are c++. The look of the descriptions will be close, and the

[PATCH 50/51] Documentation: pixfmt-nv12.rst: remove empty columns

The conversion added empty columns (probably, it was used on DocBook just to increase spacing. Remove them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/pixfmt-nv12.rst | 13 ++--- 1 file changed, 2 insertions(+), 11 deletions(-) diff --git a/Documentation/

[PATCH 17/51] Documentation: linux_tv: remove controls.rst

This auto-generated file is bogus: it just adds a toc for two other files. Instead, just move the controls and extended-controls directly to the common.rst file. this avoids a blank page, and better organize the document. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l

[PATCH 07/51] Documentation: video.rst: use reference for VIDIOC_ENUMINPUT

Instead of using const, transform it into a reference. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/video.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/linux_tv/media/v4l/video.rst b/Documentation/linux_tv/media/v4l/video.

[PATCH 51/51] Documentation: pixfmt-nv12m.rst: fix conversion issues

The conversion added an empty column (probably, it was used on DocBook just to increase spacing. It also added an extra line on one of the texts, breaking the original paragraph into two ones. Remove them. Finally, a space is required before :sub:, as otherwise it won't display it right. Add it.

[PATCH 28/51] Documentation: linux_tv: Error codes should be const

All error codes should be const. Most are, but there are lots of places where we forgot to add at the DocBook. Fix those via this small script: for i in $(git grep -lE "\s+E[A-Z]+\b" Documentation/linux_tv/); do perl -ne 's,([^\`])\b(E[A-Z]+)\b,\1``\2``,g; print $_' <$i >a && mv a $i; do

[PATCH 47/51] Documentation: pixfmt-yuv444m.rst: remove empty columns

The conversion added empty columns (probably, it was used on DocBook just to increase spacing. Remove them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/pixfmt-yuv444m.rst | 17 - 1 file changed, 17 deletions(-) diff --git a/Documentation/linux_tv/m

[PATCH 33/51] Documentation: linux_tv: fix some warnings due to '*'

Unescaped * causes warnings on Sphinx. Add an escape at hist-v4l2.rst occurrences. At libv4l-introduction, the best is do declare the function prototypes as C code. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/hist-v4l2.rst | 5 ++--- .../linux_tv/media/v4l/li

[PATCH 20/51] Documentation: extended-controls.rst: use reference for VIDIOC_S_CTRL

Instead of using a constant, use references, just like the other references for ioctl's. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/extended-controls.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Documentation/linux_tv/media/v4l/exte

[PATCH 19/51] Documentation: control.rst: Fix missing reference for example 8

The conversion broke references and captions for examples. Fix the missing reference for control enumeration. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/control.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documentation/linux_tv/media/v4l/control.rst

[PATCH 01/51] Documentation: linuxt_tv: update the documentation year

The RST version was produced in 2016. So, update it where it was still pointing to the wrong year. While here, added the missing (copyright) symbols. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/conf.py | 2 +- Documentation/linux_tv/index.rst| 4 +++-

[PATCH 03/51] Documentation: v4l2.rst: Fix authors and revisions lists

The conversion of the authors and revision history lists didn't end too well. Manually fix them. The revision history still needs some care in the future. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/v4l2.rst | 70 +-- 1 file changed, 39

[PATCH 31/51] Documentation: pixfmt-007.rst: Fix formula parsing

There are lots of warnings there: /devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007.rst:74: ERROR: Unexpected indentation. /devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007.rst:89: ERROR: Unexpected indentation. /devel/v4l/patchwork/Documentation/linux_tv/media/v4l/

[PATCH 08/51] Documentation: v4l2.rst: numerate the V4L2 chapters

The Video4Linux documentation is big. We want to numerate the items, as it makes easier to reference an item while discussing the document on meetings. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/v4l2.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documen

[PATCH 02/51] Documentation: some fixups at linux_tv/index.rst

Fix some issues from the conversion and improve the documentation a little bit, by adding two relevent keywords (SDR and DTMB). Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/index.rst | 21 +++-- 1 file changed, 7 insertions(+), 14 deletions(-) diff --git a/Doc

[PATCH] mmc: core: Extend sysfs with OCR register

Make operation conditions register (OCR) easily accessible from user space. Signed-off-by: Bojan Prtvar --- Documentation/mmc/mmc-dev-attrs.txt | 1 + drivers/mmc/core/mmc.c | 2 ++ 2 files changed, 3 insertions(+) diff --git a/Documentation/mmc/mmc-dev-attrs.txt b/Documentation/m

Re: [PATCH] mmc: core: Extend sysfs with OCR register

Bojan, On Mon, Jul 04, 2016 at 01:56:55PM +0200, Bojan Prtvar wrote: > Make operation conditions register (OCR) easily accessible from user space. > > Signed-off-by: Bojan Prtvar You described "what" above. Can you add the "why", too? Regards, Wolfram signature.asc Description: PGP signa

Re: [PATCH] mmc: core: Extend sysfs with OCR register

Hi, On Mon, Jul 4, 2016 at 4:13 PM, Wolfram Sang wrote: >> Make operation conditions register (OCR) easily accessible from user space. >> > You described "what" above. Can you add the "why", too? > According to JEDEC v5.0 chapter 7 the OCR, CID and CSD registers carry the Device/content specifi

Re: [PATCH] mmc: core: Extend sysfs with OCR register

> Registers CID and CSD are already exported through sysfs so let's make > this interface complete by adding missing OCR register. This sentence was missing for me, thanks. > Do I need to send v2 with updated change log? Ulf will tell us. signature.asc Description: PGP signature

Re: [PATCH] Fix spelling errors in Documentation

On 07/03/16 14:27, Otto Kekäläinen wrote: > Signed-off-by: Otto Kekäläinen > --- > Also available via > g...@github.com:ottok/linux.git fix-spelling > > Documentation/ABI/testing/debugfs-driver-genwqe|2 +- > .../testing/sysfs-bus-event_source-devices-events |4 ++-- > Documentation

[PATCH 38/41] Documentation: dev-sliced-vbi.rst: convert table captions into headers

Sphinx doesn't format nice table captions, nor auto-numberate them. So, convert tables into chapters. Signed-off-by: Mauro Carvalho Chehab --- .../linux_tv/media/v4l/dev-sliced-vbi.rst | 45 +- 1 file changed, 36 insertions(+), 9 deletions(-) diff --git a/Documentat

[PATCH 09/41] Documentation: FE_READ_SNR: improve man-like format

Parsing this file were causing lots of warnings with sphinx, due to the c function prototypes. Fix that by prepending them with .. c:function:: While here, use the same way we document man-like pages, at the V4L side of the book and add escapes to asterisks. Signed-off-by: Mauro Carvalho Chehab

[PATCH 29/41] Documentation: dmabuf.rst: re-add the missing captions

The conversion from DocBook removed them. Re-add. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/dmabuf.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Documentation/linux_tv/media/v4l/dmabuf.rst b/Documentation/linux_tv/media/v4l/dmabuf.rst index 148e05e4c

[PATCH 40/41] Documentation: subdev-formats.rst: Improve figure caption

Add a numbering for the figure. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/subdev-formats.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/Documentation/linux_tv/media/v4l/subdev-formats.rst b/Documentation/linux_tv/media/v4l/subdev-forma

[PATCH 04/41] Documentation: video_function_calls: improve man-like format

Parsing this file were causing lots of warnings with sphinx, due to the c function prototypes. Fix that by prepending them with .. cpp:function:: While here, use the same way we document man-like pages, at the V4L side of the book and add escapes to asterisks. Signed-off-by: Mauro Carvalho Cheha

[PATCH 07/41] Documentation: FE_SET_FRONTEND.rst: improve man-like format

Parsing this file were causing lots of warnings with sphinx, due to the c function prototypes. Fix that by prepending them with .. c:function:: While here, use the same way we document man-like pages, at the V4L side of the book and add escapes to asterisks. Signed-off-by: Mauro Carvalho Chehab

[PATCH 32/41] Documentation: buffer.rst: numerate tables and figures

Sphinx actually doesn't numerate tables nor figures. So, let's add a subtitle before each table. That makes them "numerated". While here, fix the git binary that got corrupted. Let's hope this will work, as the reason why we had to encode them were to prevent some issues on commiting those gif fil

[PATCH 06/41] Documentation: audio_function_calls: improve man-like format

Parsing this file were causing lots of warnings with sphinx, due to the c function prototypes. Fix that by prepending them with .. cpp:function:: While here, use the same way we document man-like pages, at the V4L side of the book and add escapes to asterisks. Signed-off-by: Mauro Carvalho Cheha

[PATCH 26/41] Documentation: userp.rst: re-add the missing captions

The conversion from DocBook removed them. Re-add. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/userp.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/Documentation/linux_tv/media/v4l/userp.rst b/Documentation/linux_tv/media/v4l/userp.rst index f372d39512a8..6

[PATCH 35/41] Documentation: dev-codec.rst: Fix a reference for _STREAMON

The referenced ioctl there is only VIDIOC_STREAMON, so we should override the name, to avoid it to also show _STREAMOFF. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/dev-codec.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/linux

[PATCH 33/41] Documentation: dev-overlay.rst: Fix conversion issues

There were several conversion issues on this file, causing it to be badly formatted. Fix them, in order to match the design used on DocBook. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/dev-overlay.rst | 45 +++- 1 file changed, 21 insertions(+),

[PATCH 21/41] Documentation: pixfmt-nv16m.rst: remove an empty column

The conversion added an empty column (probably, it was used on DocBook just to increase spacing. It also added an extra line on one of the texts, breaking the original paragraph into two ones. Remove them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/pixfmt-nv16m.r

[PATCH 34/41] Documentation: dev-osd.rst: Fix some issues due to conversion

The conversion to ReST broke a minor things. Fix them. While here, also make EBUSY constant, just like on other places. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/dev-osd.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/Documentation/li

[PATCH 19/41] Documentation: linux_tv: promote generic documents to the parent dir

The generic error codes and licensing sections are general to the entire media book. They should not be inside the v4l dir. So, promote them to the parent directory. No functional changes. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/index.rst| 4 ++--

[PATCH 24/41] Documentation: mmap.rst: re-add the missing captions

The conversion from DocBook removed them. Re-add. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/mmap.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documentation/linux_tv/media/v4l/mmap.rst b/Documentation/linux_tv/media/v4l/mmap.rst index 1ed17fa3368a..97

[PATCH 20/41] Documentation: linux_tv: Fix a warning at lirc_dev_intro.rst

Documentation/linux_tv/media/rc/lirc_dev_intro.rst:17: WARNING: Inline substitution_reference start-string without end-string. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/rc/lirc_dev_intro.rst | 10 +- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git

[PATCH 22/41] Documentation: v4l/pixfmt: re-join a broken paragraph

Originally, at the DocBook, the "Byte Order" were a single paragraph with the string that follows it. The conversion broke it, and, sometimes, it added an extra dot. Fix them altogheter at pixfmt-*.rst. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/pixfmt-grey.rst

[PATCH 23/41] Documentation: pixfmt-nv16m.rst: remove an empty column

The conversion added an empty column (probably, it was used on DocBook just to increase spacing. Remove it. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/pixfmt-m420.rst | 7 --- 1 file changed, 7 deletions(-) diff --git a/Documentation/linux_tv/media/v4l/pixfmt

[PATCH 36/41] Documentation: linux_tv: Use references for read()/write()

Use cross-references for read()/write() on a few places where they weren't used. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/dev-capture.rst | 4 ++-- Documentation/linux_tv/media/v4l/dev-raw-vbi.rst | 4 ++-- Documentation/linux_tv/media/v4l/func-open.rst | 12

[PATCH 18/41] Documentation: linux_tv: move MC stuff to a separate dir

When we wrote the media controller's section, we re-used the V4L, just because we were lazy to create a brand new DocBook. Yet, it is a little ackward to have it mixed with V4L. So, move it to its own directory, in order to have it better organized. No functional changes. Signed-off-by: Mauro Ca

[PATCH 39/41] Documentation: dev-subdev.rst: fix some format issues

The conversion from DocBook made somethings look ugly. Improve them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/dev-subdev.rst | 16 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/Documentation/linux_tv/media/v4l/dev-subdev.rst b/Do

[PATCH 31/41] Documentation: buffer.rst: numerate tables

Sphinx actually doesn't numerate tables. So, let's add a subtitle before each table. That makes them numerated. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/buffer.rst | 38 +++-- 1 file changed, 31 insertions(+), 7 deletions(-) diff --git a

[PATCH 17/41] Documentation: linux_tv: move RC stuff to a separate dir

When we wrote the remote controller's section, we re-used the V4L, just because we were lazy to create a brand new DocBook. Yet, it is a little ackward to have it mixed with V4L. So, move it to its own directory, in order to have it better organized. No functional changes. Signed-off-by: Mauro C

[PATCH 16/41] Documentation: linux_tv: avoid using c:func::

Using auto-generated links is dangerous, as there are multiple definitions for syscalls (at least one on each book part). So, reference them by their explicit reference. I used this small script to help writing this patch: for i in $(git grep -l "c:func:"); do perl -ne 's/\:c\:func:\`(open|clos

[PATCH 25/41] Documentation: mmap.rst: Add ioctl cross references

There are lots of ioctls mentioned there that aren't cross-referenced. Convert the const to cross references. That makes it visually better, and improves navigation along the document. While here, remove bad whitespaces. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l

[PATCH 15/41] Documentation: linux_tv: fix remaining lack of escapes

Add escape before asterisk to fix those warnings: Documentation/linux_tv/media/dvb/FE_GET_EVENT.rst:47: WARNING: Inline emphasis start-string without end-string. Documentation/linux_tv/media/v4l/media-ioc-enum-links.rst:78: WARNING: Inline emphasis start-string without end-string. Documentation/

[PATCH 02/41] Documentation: pixfmt-nv16.rst: remove an empty column

The conversion added an empty column (probably, it was used on DocBook just to increase spacing. It also added an extra line on one of the texts, breaking the original paragraph into two ones. Remove them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/pixfmt-nv16.rs

[PATCH 41/41] Documentation: libv4l-introduction.rst: improve format

Fix some cross-references and improve the layout of this page. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/libv4l-introduction.rst | 12 ++-- 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/Documentation/linux_tv/media/v4l/libv4l-introduction.r

[PATCH 30/41] Documentation: dmabuf.rst: Add ioctl cross references

There are lots of ioctls mentioned there that aren't cross-referenced. Convert the const to cross references. That makes it visually better, and improves navigation along the document. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/dmabuf.rst | 41

[PATCH 05/41] Documentation: ca_function_calls: improve man-like format

Parsing this file were causing lots of warnings with sphinx, due to the c function prototypes. Fix that by prepending them with .. cpp:function:: While here, use the same way we document man-like pages, at the V4L side of the book and add escapes to asterisks. Signed-off-by: Mauro Carvalho Cheha

[PATCH 12/41] Documentation: FE_GET_FRONTEND.rst: improve man-like format

Parsing this file were causing lots of warnings with sphinx, due to the c function prototypes. Fix that by prepending them with .. c:function:: While here, use the same way we document man-like pages, at the V4L side of the book and add escapes to asterisks. Signed-off-by: Mauro Carvalho Chehab

[PATCH 37/41] Documentation: dev-raw-vbi.rst fix conversion issues

There are several things that didn't convert well. Fix them, in order to improve the layout of the formatted document. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l/dev-raw-vbi.rst | 29 1 file changed, 10 insertions(+), 19 deletions(-) diff

[PATCH 27/41] Documentation: userp.rst: Add ioctl cross references

There are lots of ioctls mentioned there that aren't cross-referenced. Convert the const to cross references. That makes it visually better, and improves navigation along the document. While here, remove bad whitespaces. Signed-off-by: Mauro Carvalho Chehab --- Documentation/linux_tv/media/v4l

[PATCH 14/41] Documentation: FE_DISHNETWORK_SEND_LEGACY_CMD: improve man-like format

Parsing this file were causing lots of warnings with sphinx, due to the c function prototypes. Fix that by prepending them with .. c:function:: While here, use the same way we document man-like pages, at the V4L side of the book and add escapes to asterisks. Signed-off-by: Mauro Carvalho Chehab

[PATCH 01/41] Documentation: linux_tv: Fix some occurences of :sub:

The right way to use it seems to do suscript is to use this pattern: "\ :sub:" Make sure all places of the media document will fit, by using this script: $n=0; while (<>) { $n++; $t = $_; @matches = $t =~ m/(..\:sub\:)/g; foreach my $m (@matches) {

[PATCH 10/41] Documentation: FE_READ_SIGNAL_STRENGTH: improve man-like format

Parsing this file were causing lots of warnings with sphinx, due to the c function prototypes. Fix that by prepending them with .. c:function:: While here, use the same way we document man-like pages, at the V4L side of the book and add escapes to asterisks. Signed-off-by: Mauro Carvalho Chehab

[PATCH 03/41] Documentation: dmx_fcalls.rst: improve man-like format

Parsing this file were causing lots of warnings with sphinx, due to the c function prototypes. Fix that by prepending them with .. cpp:function:: While here, use the same way we document man-like pages, at the V4L side of the book and add escapes to asterisks. Signed-off-by: Mauro Carvalho Cheha

[PATCH 08/41] Documentation: FE_READ_UNCORRECTED_BLOCKS: improve man-like format

Parsing this file were causing lots of warnings with sphinx, due to the c function prototypes. Fix that by prepending them with .. c:function:: While here, use the same way we document man-like pages, at the V4L side of the book and add escapes to asterisks. Signed-off-by: Mauro Carvalho Chehab

[PATCH 13/41] Documentation: FE_GET_EVENT.rst: improve man-like format

Parsing this file were causing lots of warnings with sphinx, due to the c function prototypes. Fix that by prepending them with .. c:function:: While here, use the same way we document man-like pages, at the V4L side of the book and add escapes to asterisks. Signed-off-by: Mauro Carvalho Chehab

[PATCH 11/41] Documentation: FE_READ_BER.rst: improve man-like format

Parsing this file were causing lots of warnings with sphinx, due to the c function prototypes. Fix that by prepending them with .. c:function:: While here, use the same way we document man-like pages, at the V4L side of the book and add escapes to asterisks. Signed-off-by: Mauro Carvalho Chehab