linux.git/Documentation/media/uapi/dvb, branch v4.8

[media] doc-rst: better organize the media books

2016-07-23T11:03:24+00:00

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: Mauro Carvalho Chehab

Revert "[media] docs-rst: escape [] characters"

2016-07-13T11:43:30+00:00

This patch touches on places where it shouldn't: image
files and code examples. Also, it doesn't fix all array
occurrences.

So, let's revert it.

This reverts commit ffbab694ede33c294e5864a5e0bf4d1474446a71.

[media] docs-rst: escape [] characters

2016-07-12T18:20:11+00:00

Those characters are used for citations. Better to escape, to
avoid them to be misinterpreted.

Signed-off-by: Mauro Carvalho Chehab

[media] doc-rst: improve display of notes and warnings

2016-07-10T15:06:28+00:00

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: Mauro Carvalho Chehab

[media] doc-rst: improve DTV_BANDWIDTH_HZ notes

2016-07-10T12:50:07+00:00

There are several notes for this DTV property. Some are
outdated, so take some care of it, making it updated.

Signed-off-by: Mauro Carvalho Chehab

[media] doc-rst: improve documentation for DTV_FREQUENCY

2016-07-10T12:33:26+00:00

Make the note better formatted and documented.

Signed-off-by: Mauro Carvalho Chehab

[media] doc-rst: Don't use captions for examples

2016-07-10T11:31:24+00:00

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: Mauro Carvalho Chehab

doc_rst: rename the media Sphinx suff to Documentation/media

2016-07-08T14:59:40+00:00

The name of the subsystem is "media", and not "linux_tv". Also,
as we plan to add other stuff there in the future, let's
rename also the media uAPI book to media_uapi, to make it
clearer.

No functional changes.

Signed-off-by: Mauro Carvalho Chehab