Document V4L2_DV_PROGRESSIVE and V4L2_DV_INTERLACED and
fix missing references.
Signed-off-by: NHans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Fix missing documentation, and its cross reference.
Signed-off-by: NHans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Fix it by adding a header to the flat-table to match to
the list of define symbols.

As a side-effect, it also removes some exceptions from
videodev2.h.rst.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Reorganize the LIRC rst files, using "-" instead of "_" on
their names, and creating a separate chapter for syscalls.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Add LIRC_SET_[REC|SEND]_MODE ioctls to the corresponding
GET functions, and put all LIRC modes altogether.

As now everything is already documented on its own ioctl
pages, get rid of lirc_ioctl.rst.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Put documentation for this ioctl on a separate page and
improve it.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Place documentation for this ioctl on its own page.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Add a separate page for this ioctl and improve its documentation.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Add a separate page for this ioctl and adds the cross-references.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Add proper documentation for this ioctl, providing some
additional information about its usage.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Put each ioctl on its own page and improve documentation, adding
cross-references for LIRC_SET_REC_CARRIER_RANGE and LIRC_SET_REC_CARRIER,
with can be used together to set a carrier frequency range.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Put documentation for this ioctl on its own page.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Improve the documentation for those ioctls, adding them to
a separate file, in order to look like the rest of the
book, and to later allow to generate a man page for those
ioctls.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Add a separate page for this ioctl.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Improve the documentation for this ioctl, adding it to
a separate file, in order to look like the rest of the
book, and to later allow to generate a man page for this
ioctl.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Move the documentation of this ioctl from lirc_ioctl to its
own file, and add a short description about the pulse mode
used by IR RX.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Some references were broken. It was also mentioning LIRC_MODE_RAW,
with it is not implemented on current LIRC drivers.

So, fix the references.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Move the documentation of this ioctl from lirc_ioctl to its
own file, and add a short description about the pulse mode
used by IR TX.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

The references pointed by LIRC_GET_FEATURES ioctl are broken.

Fix them.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

As we removed those ioctls from the header file, do the
same at the documentation side.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

changeset 68cd5e0b ("[media] doc-rst: add LIRC header to the book")
did everything but adding the lirc-reader.rst :-p

My fault: I forgot to do a git add for this guy on such
changeset.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

The documentation for this ioctl was really crappy.

Add a better documentation, using the lirc.4 man pages as a
reference, plus what was written originally at the lirc-ioctl.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

There are several notes and warning mesages in the middle of
the media docbook. Use the ReST tags for that, as it makes
them visually better and hightlights them.

While here, modify a few ones to make them clearer.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

There are several notes for this DTV property. Some are
outdated, so take some care of it, making it updated.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Make the note better formatted and documented.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Unfortunately, captions are new on Sphinx for c blocks: it was
added only on version 1.3. Also, it were already bad enough
not being able to auto-numerate them.

So, let's give up and use, instead, titles before the examples.
Not much is lost, and, as a side track, we don't need to
numerate them anymore.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Now that the LIRC header was added, we can cross-reference it
and identify the documentation gaps.

There are lots of stuff missing there, but at least now we
can avoid the gap to increase.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Just like the other parts of the document, let's add the LIRC
header, as it is part of the API.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

The lirc syscall documentation uses a very different and
simplified way than the rest of the media book. make it
closer. Still, there's just one page for all ioctls.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Some files start with an upper letter. Also, they have big
names. rename them.

No functional changes.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

There's no need to say: Table of Contents there. Also, this
generates a duplicated caption xref. So, remove, to use the
same format on every part.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Just like the other parts of the media book, group the MC
functions together on one chapter.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

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: NMauro Carvalho Chehab <mchehab@s-opensource.com>

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: NMauro Carvalho Chehab <mchehab@s-opensource.com>

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: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Changesets:
	eaa0b96b ("[media] media: Add video statistics computation functions")
and
	1179aab1 ("[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 order to
keep it in sync with the DocBook version.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Use the same format as the other parts.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Adjust the widths and show error codes as constants.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

leaved content unchanged, only improved markup and references

* more man-like sections (add Name section)
* defined target for each stuct field description
* replace constant with ":ref:" to (field) description
Signed-off-by: NMarkus Heiser <markus.heiser@darmarIT.de>
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

This is the reST migration of media's CEC part.  The migration is based
on media_tree's cec branch:

 https://git.linuxtv.org/media_tree.git

 c7169ad5 * cec media_tree/cec [media] DocBook/media: add CEC documentation
Signed-off-by: NMarkus Heiser <markus.heiser@darmarIT.de>
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>