Improve events documentation by adding cross references,
sub-titles and other markup elements.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Move the v4l2 event-specific text from v4l2-framework.rst
to v4l2-event.rst. That helps to keep the text together with
the functions it describes, and makes easier to identify
documentation gaps.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

As we merged the videobuf chapter at the kABI section, and it
is a way more complete, just remove the small videobuf chapter
that came from framework.txt.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Add cross-references for the functions/structs and add
the markup tags to improve its display.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Move the documentation for video device node creation to
a separate file.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Add documentation for v4l2-dev.h, and put it at v4l2-framework.rst,
where struct video_device is currently documented.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

The v4l2_subdev reference was using the wrong tag. Fix it.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

There are some subdev-specific functions at v4l2-common.h
that are mentioned at v4l2-subdev.rst.

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

The two new sections were missing cross-references, and had
some other minor issues with the markups. Add such things.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

There are two additional subdev-specific sections at the
v4l2-framework file. Move them to the subdev chapter, in order
to better organize the book.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

The Async API is actually part of the v4l2 subdev.
Move its declarations to it.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Enrich the subdevice description by linking it to the
functions and structs from v4l2-subdev.h.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

There are lots of documentation about V4L2 subdevices at
v4l2-framework.rst. Move them to its specific chapter at
v4l2-subdev.rst.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

This document describes the main kAPI interfaces for the
v4l2-device.h header. Add cross references to the documentation
produced via kernel-doc.

While here, also use monotonic font for constants.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Part of the contents of v4l2-framework is related to the
kAPI defined by v4l2-device. Move such contents to the
v4l2-device.rst.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Sphinx produce a 1:1 mapping between a rst file and an html file.

So, we need to split the kernel-doc tags on multiple documents.

A side effect is that we're now having a better name for each
section of the kAPI documentation.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

The functions at v4l2-device.h are not using the proper
markups. Add it, and include at the v4l2-core.rst.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

The uAPI book has 5 parts, but they lost numeration after
conversion to rst. Manually number those parts, and make
the main index with 1 depth, to only show the parts and
the annexes.

At each part, use :maxwidth: 5, in order to show a more
complete index.

While here, fix the cross-references between different
books.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

I ended by adding twice each media header, because I saw some
missing stuff at the documents. It seems it was my mistake,
as everything seems to be there.

So, remove those extra stuff, to avoid duplicating the
documentation of the functions.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

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

This document describes a kapi framework. Move it to the right
place.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

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 lack kernel-doc documentation
for most of the stuff described there.

So, let's do a poor man's conversion. We should later address
this.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

Those documentation are part of the kAPI one. Move to the right
place.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

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
  recognizes it anymore;

- Identation needs to be fixed, as ReST uses it to identify
  when a format "tag" ends.

- Fix the cross-references at the media controller description.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

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 structs/enums/.. and another one for the functions;

- Notes should use the ReST tag, as kernel-doc doesn't
  recognizes it anymore;

- Identation needs to be fixed, as ReST uses it to identify
  when a format "tag" ends.

- Fix the cross-references at the media controller description.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

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 one for the functions;

- Notes should use the ReST tag, as kernel-doc doesn't
  recognizes it anymore;

- Identation needs to be fixed, as ReST uses it to identify
  when a format "tag" ends.

- kernel-doc doesn't escape things like *pointer, so we
  need to manually add a escape char before it.

- On some cases, kernel-doc conversion requires violating
  the 80-cols, as otherwise it won't properly parse the
  source code.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

The kernel-doc script is now broken if it doesn't find all
exported symbols documented.
Signed-off-by: NMauro Carvalho Chehab <mchehab@s-opensource.com>

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