linux-stable.git/Documentation/media, branch v5.3

docs: remove extra conf.py files

2019-07-17T09:57:52+00:00

Now that the latex_documents are handled automatically, we can
remove those extra conf.py files.

Signed-off-by: Mauro Carvalho Chehab

media: doc-rst: Fix typos

2019-06-27T11:35:47+00:00

Not sure how codespell thinks "sroweam" is a real word.

Signed-off-by: Bastien Nocera 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: rc: Prefer KEY_NUMERIC_* for number buttons on remotes

2019-06-27T11:30:28+00:00

Prefer KEY_NUMERIC_* for number buttons on remotes. Now all the remotes
use KEY_NUMERIC_[0-9] for the number buttons rather than keys that
could be affected by modifiers (Caps-Lock, or Num-Lock) or regional
keymaps.

Created using:
sed -i  's/KEY_\([0-9]\) /KEY_NUMERIC_\1 /' *.c
sed -i  's/KEY_\([0-9]\)}/KEY_NUMERIC_\1}/' *.c
sed -i  's/``KEY_\([0-9]\)/``KEY_NUMERIC_\1/' Documentation/media/uapi/rc/rc-tables.rst

Signed-off-by: Bastien Nocera 
Signed-off-by: Sean Young 
Signed-off-by: Mauro Carvalho Chehab

media: vivid.rst: describe display present control

2019-06-21T21:35:04+00:00

Signed-off-by: Johan Korsnes 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: docs: create vimc documentation

2019-06-21T21:20:13+00:00

Create vimc documentation file to explain its basic features, its
topology, how to configure it and to document vimc's subdevices.

Signed-off-by: André Almeida 
Suggested-by: Helen Koike 
[hverkuil-cisco@xs4all.nl: Fix typo: The ``v4l2-utils`` -> The ``v4l-utils`` package]
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: docs: v4l2-controls: fix sentence rendered in a nonsense way

2019-06-21T21:13:03+00:00

This sentence renders as:

> Since such compound controls need to expose more information about
> themselves than is possible with ioctls VIDIOC_QUERYCTRL,
> VIDIOC_QUERY_EXT_CTRL and VIDIOC_QUERYMENU the VIDIOC_QUERY_EXT_CTRL
  ^^^^^^^^^^^^^^^^^^^^^                          ^^^^^^^^^^^^^^^^^^^^^
> ioctl was added.

This does not make sense. Fix by providing an explicit link text. This
results in:

> Since such compound controls need to expose more information about
> themselves than is possible with VIDIOC_QUERYCTRL the
> VIDIOC_QUERY_EXT_CTRL ioctl was added.

Signed-off-by: Luca Ceresoli 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: docs: v4l2-controls: remove outdated paragraph

2019-06-21T21:06:25+00:00

This paragraph was added by commit a42b57f5aacf ("V4L/DVB: Documentation:
add v4l2-controls.txt documenting the new controls API") back in 2010, when
the controls API has been improved. Nowadays it is a bit anachronistic, so
remove it.

The same information is stated in up-to-date wording a few paragraphs later

> You’re done! And this is sufficient for most of the drivers we have. No
> need to do any validation of control values, or implement QUERYCTRL,
> QUERY_EXT_CTRL and QUERYMENU. And G/S_CTRL as well as G/TRY/S_EXT_CTRLS
> are automatically supported.

Signed-off-by: Luca Ceresoli 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: docs: v4l2-controls: document file to include

2019-06-21T21:05:18+00:00

The tutorial in this section is almost complete, add the one missing bit.

Signed-off-by: Luca Ceresoli 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: docs: v4l2-controls: convert code blocks to C

2019-06-21T21:04:57+00:00

All these code blocks contain C code, enable C formatting for a nicer
reading.

Signed-off-by: Luca Ceresoli 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: docs: v4l2-controls: add links to functions

2019-06-21T21:04:25+00:00

This section lacks links to functions. Add one to simplify reading.

Signed-off-by: Luca Ceresoli 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab